Example monorepo using KeystoneJS, Next.js, GraphQL Code Generator and urql
web: a Next.js appui: a stub React component library shared by bothwebanddocsapplicationsoperations: a place to store GraphQL operations to generate queries for client applicaitonsdata-access: Data access wrapper using urql to generate SSR props for Next.jsconfig:eslintconfigurations (includeseslint-config-nextandeslint-config-prettier)tsconfig:tsconfig.jsons used throughout the monorepo
Each package/app is 100% TypeScript.
This turborepo has some additional tools already setup for you:
- TypeScript for static type checking
- ESLint for code linting
- Prettier for code formatting
To begin, you will need to provide your KeystoneJS GraphQL API url as an environment variable in the .env file at the top level of the monorepo.
Once you have added this in you will need to initialize Keystone and add in some posts.
After you have added in posts, they will show up server-side rendered in the web app
To build all apps and packages, run the following command:
cd keystone-next-monorepo
yarn run build
To develop all apps and packages, run the following command:
cd keystone-next-monorepo
yarn run dev
Turborepo can use a technique known as Remote Caching (Beta) to share cache artifacts across machines, enabling you to share build caches with your team and CI/CD pipelines.
By default, Turborepo will cache locally. To enable Remote Caching (Beta) you will need an account with Vercel. If you don't have an account you can create one, then enter the following commands:
cd keystone-next-monorepo
npx turbo login
This will authenticate the Turborepo CLI with your Vercel account.
Next, you can link your Turborepo to your Remote Cache by running the following command from the root of your turborepo:
npx turbo link
Learn more about the power of Turborepo: