Repositories Overview

This section documents the API surfaces and architecture for the repos in this workspace (excluding w3-project-documentation).

System map (high level)

• w3-gateway is the entrypoint for the web apps and the Apollo Federation gateway.
• Subgraphs:
  • w3-web-services (emails, GitHub integrations, user data)
  • w3-web-svc-picture (S3 picture folders/files)
  • w3-web-svc-learn-vocab (vocabulary CRUD through AWS)
• Supporting backends:
  • w3-lambdas (Cognito signup handler, vocab handlers, CloudFront/Lambda@Edge functions)
  • AWS services: Cognito, SQS, DynamoDB, S3, CloudFront, SSM Parameter Store, ECR, EC2
• Clients and tools:
  • w3-homepage (static landing page)
  • w3-learn-vocab (Python desktop app)
• w3-search-on-github (VS Code extension)

How to read the docs

Each repo page includes:

• Purpose and responsibility
• Architecture notes (key components and data flows)
• API surface (GraphQL fields or HTTP routes when applicable)
• Configuration highlights (only what is visible in this repo)