Turborepo starter
This Turborepo starter is maintained by the Turborepo core team.
Using this example
Run the following command:
npx create-turbo@latest
What's inside?
This Turborepo includes the following packages/apps:
Apps and Packages
docs: a Next.js appweb: another Next.js app@repo/ui: a stub React component library shared by both web and docs applications@repo/eslint-config: eslint configurations (includes eslint-config-next and eslint-config-prettier)@repo/typescript-config: tsconfig.jsons used throughout the monorepo
Each package/app is 100% TypeScript.
Utilities
This Turborepo has some additional tools already setup for you:
Build
To build all apps and packages, run the following command:
With global turbo installed (recommended):
cd my-turborepo
turbo build
Without global turbo, use your package manager:
cd my-turborepo
npx turbo build
npm dlx turbo build
npm exec turbo build
You can build a specific package by using a filter:
With global turbo installed:
turbo build --filter=docs
Without global turbo:
npx turbo build --filter=docs
npm exec turbo build --filter=docs
npm exec turbo build --filter=docs
Develop
To develop all apps and packages, run the following command:
With global turbo installed (recommended):
cd my-turborepo
turbo dev
Without global turbo, use your package manager:
cd my-turborepo
npx turbo dev
npm exec turbo dev
npm exec turbo dev
You can develop a specific package by using a filter:
With global turbo installed:
turbo dev --filter=web
Without global turbo:
npx turbo dev --filter=web
npm exec turbo dev --filter=web
npm exec turbo dev --filter=web
Remote Caching
[!TIP]
Vercel Remote Cache is free for all plans. Get started today at vercel.com.
Turborepo can use a technique known as Remote Caching 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 you will need an account with Vercel. If you don't have an account you can create one, then enter the following commands:
With global turbo installed (recommended):
cd my-turborepo
turbo login
Without global turbo, use your package manager:
cd my-turborepo
npx turbo login
npm exec turbo login
npm exec 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:
With global turbo installed:
turbo link
Without global turbo:
npx turbo link
npm exec turbo link
npm exec turbo link
Useful Links
Learn more about the power of Turborepo:
