Appsync Unified Repo -
// DynamoDB datasource const postTable = new dynamodb.Table(...); const postDS = api.addDynamoDbDataSource('PostDS', postTable);
If you have ever worked on a project with multiple frontends (React, iOS, Android) talking to a single GraphQL API, you know the pain: Schema drift, duplicated resolver logic, and the "it works on my machine" syndrome for GraphQL transformations. appsync unified repo
my-appsync-monorepo/ ├── packages/ │ ├── api/ # AppSync backend definition (CDK or Terraform) │ │ ├── graphql/ │ │ │ ├── schema.graphql │ │ │ └── resolvers/ │ │ │ ├── getPost.js # JS resolvers (AppSync JS runtime) │ │ │ └── listPosts.vtl # or legacy VTL │ │ ├── lib/ │ │ │ └── datasources.ts # DynamoDB, Lambda, HTTP │ │ └── bin/ deploy.ts # CDK stack │ ├── web/ # React/Vue frontend │ │ ├── src/ │ │ └── codegen.yml # GraphQL Code Generator config │ ├── mobile/ # React Native / iOS │ └── shared/ # Common types & validation logic └── scripts/ └── codegen-all.sh # Trigger codegen for all clients Use the AWS Cloud Development Kit (CDK) or Amplify (with CDK under the hood) to define your AppSync API inside packages/api . // DynamoDB datasource const postTable = new dynamodb
In packages/web/package.json :
Example resolver ( getPost.ts ):
schema: ../api/graphql/schema.graphql documents: src/**/*.graphql generates: src/generated/graphql.ts: plugins: - typescript - typescript-operations - typescript-react-apollo Now, when a developer runs npm run build in the web package, they always use the latest schema from the api package. No more out-of-sync copies. Your CI pipeline (GitHub Actions, GitLab CI) should enforce integration. Here is a typical workflow: No more out-of-sync copies
Start with a simple two-package structure ( api + one client), then expand. The tooling (CDK, GraphQL Codegen, npm workspaces) is mature enough for production today.