Infrastructure and Services

Service Inventory (Plain English)

Vercel

• Purpose: hosts and deploys the frontend application.
• Evidence in repo: .github/workflows/deploy.yml runs Vercel CLI deployment and aliases environment domains.

GraphQL API backend

• Purpose: primary business data source for the frontend.
• Evidence in repo: Apollo client setup points to configured API endpoints; many .gql query/mutation files.

WebSocket GraphQL subscriptions

• Purpose: live updates for real-time experiences.
• Evidence in repo: GraphQLWsLink is configured in src/utilities/apollo/client.js.

Firebase client SDK

• Purpose: client-side integration for Firebase-backed functions (such as auth-related client capabilities).
• Evidence in repo: src/utilities/firebase/*, firebase-related environment keys in src/config.js.

Google OAuth

• Purpose: sign-in/provider integration.
• Evidence in repo: _app.jsx wraps application with GoogleOAuthProvider.

GitHub Actions

• Purpose: CI automation for linting and deployment triggers.
• Evidence in repo: .github/workflows/lint.yml, .github/workflows/deploy.yml.

Quality and Developer Tooling

Husky

• Purpose: runs checks before commit.
• Current behavior in this repo: pre-commit runs npx lint-staged.
• Value: reduces avoidable formatting/lint issues in shared branches.

lint-staged

• Purpose: runs lint/fix only on files being committed.
• Value: fast local checks that keep commit quality high.

ESLint and Stylelint

• Purpose: static checks for JavaScript/React and styling quality.
• Value: catches issues early and improves consistency.