Appsync Unified Repo Official
{ "scripts": { "codegen": "graphql-codegen --config codegen.yml", "build": "npm run codegen && vite build" } } The codegen.yml points to the local schema file:
// packages/api/lib/appsync-stack.ts import * as appsync from 'aws-cdk-lib/aws-appsync'; import * as dynamodb from 'aws-cdk-lib/aws-dynamodb'; const api = new appsync.GraphqlApi(this, 'MyUnifiedApi', { name: 'UnifiedBlogApi', schema: appsync.Schema.fromAsset('graphql/schema.graphql'), // single source of truth });
// Attach a resolver using the new JS runtime postDS.createResolver('getPostResolver', { typeName: 'Query', fieldName: 'getPost', code: appsync.Code.fromAsset('graphql/resolvers/getPost.js'), runtime: appsync.FunctionRuntime.JS_1_0_0, }); In a unified repo, you can write resolvers in TypeScript and transpile them to the AppSync JS runtime. Store resolvers as .ts files and build them to resolvers/ during deployment. appsync unified repo
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.
Try the official @aws-solutions-constructs/aws-appsync-dynamodb pattern inside a monorepo, or explore graphql-mesh for federation-like patterns. Do you run AppSync in a monorepo? What has been your biggest challenge? Let me know in the comments. { "scripts": { "codegen": "graphql-codegen --config codegen
Example resolver ( getPost.ts ):
Enter the (monorepo). By managing your AWS AppSync configuration—schema, resolvers (VTL or JavaScript), datasources, and even client code—in a single repository, you can enforce consistency, improve developer experience, and streamline CI/CD. Let me know in the comments
Because everything lives in packages/api , any frontend change that expects a new field forces you to update the resolver in the same PR . The magic of the monorepo happens in package.json scripts. After every schema change, regenerate all clients automatically.
How to share schemas, resolvers, and logic across multiple frontends without losing your mind.
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 .
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:
