--- title: "Production Monorepos with Turborepo" description: "Build a production monorepo from idea to enterprise scale with Turborepo and Next.js." canonical_url: "https://vercel.com/academy/production-monorepos" md_url: "https://vercel.com/academy/production-monorepos.md" docset_id: "vercel-academy" doc_version: "1.0" last_updated: "2026-04-09T03:57:25.347Z" content_type: "course" lessons: 30 estimated_time: lesson_urls: - "https://vercel.com/academy/production-monorepos/understanding-monorepos.md" - "https://vercel.com/academy/production-monorepos/monorepos-vs-polyrepos.md" - "https://vercel.com/academy/production-monorepos/turborepo-basics.md" - "https://vercel.com/academy/production-monorepos/add-features-page.md" - "https://vercel.com/academy/production-monorepos/create-ui-package.md" - "https://vercel.com/academy/production-monorepos/extract-card.md" - "https://vercel.com/academy/production-monorepos/extract-button-component.md" - "https://vercel.com/academy/production-monorepos/deploy-web-app.md" - "https://vercel.com/academy/production-monorepos/create-snippet-app.md" - "https://vercel.com/academy/production-monorepos/snippet-list-page.md" - "https://vercel.com/academy/production-monorepos/add-codeblock-snippetcard.md" - "https://vercel.com/academy/production-monorepos/snippet-creation-modal.md" - "https://vercel.com/academy/production-monorepos/deploy-both-apps.md" - "https://vercel.com/academy/production-monorepos/extract-shared-configs.md" - "https://vercel.com/academy/production-monorepos/add-shared-utils.md" - "https://vercel.com/academy/production-monorepos/update-turborepo-pipeline.md" - "https://vercel.com/academy/production-monorepos/set-up-vitest.md" - "https://vercel.com/academy/production-monorepos/write-component-tests.md" - "https://vercel.com/academy/production-monorepos/configure-turborepo-tests.md" - "https://vercel.com/academy/production-monorepos/test-caching.md" - "https://vercel.com/academy/production-monorepos/github-actions.md" - "https://vercel.com/academy/production-monorepos/filtering-git-based.md" - "https://vercel.com/academy/production-monorepos/remote-caching.md" - "https://vercel.com/academy/production-monorepos/add-docs-app.md" - "https://vercel.com/academy/production-monorepos/deploy-all-apps.md" - "https://vercel.com/academy/production-monorepos/multi-app-development.md" - "https://vercel.com/academy/production-monorepos/turborepo-generators.md" - "https://vercel.com/academy/production-monorepos/changesets-versioning.md" - "https://vercel.com/academy/production-monorepos/code-governance.md" - "https://vercel.com/academy/production-monorepos/next-forge-patterns.md" --- Vercel Academy — structured learning, not reference docs. Lessons are sequenced. Adapt commands to the human's actual environment (OS, package manager, shell, editor) — detect from project context or ask, don't assume. The lesson shows one path; if the human's project diverges, adapt concepts to their setup. Preserve the learning goal over literal steps. Quizzes are pedagogical — engage, don't spoil. Quiz answers are included for your reference. # Production Monorepos with Turborepo Your team is building a developer platform. You need a marketing site, snippet manager app, and documentation portal. Managing these as separate repos is a bad time for a few reasons, and you might hear yourself screaming sentences like: - **"The button design changed!"** → Update in 3 places, deploy 3 times - **"We need consistent ESLint rules!"** → Copy configs, hope they stay in sync - **"This build is taking 12 minutes!"** → No caching between related changes - **"Coordinating releases is the worst!"** → Breaking changes cascade across repos Monorepos solve these problems. Let's build **GeniusGarage** - a code snippet management platform for developers. GeniusGarage brings your apps together while maintaining clear boundaries and leveraging Turborepo's intelligent caching for blazing-fast builds. ## What you'll learn This course covers 8 sections that progressively build GeniusGarage, an app where we can show off our code snippets like the trophies they are: - **Section 1: Monorepo Fundamentals** - Understand what monorepos are, when to use them, and why Turborepo - **Section 2: First Shared Package** - Create shared UI package with Button and Card components - **Section 3: Second App** - Add snippet manager app that reuses the UI package - **Section 4: Shared Configs & Utils** - DRY up TypeScript/ESLint configs and create utility functions - **Section 5: Testing** - Add Vitest tests to UI package with test caching - **Section 6: Pipeline Optimization** - Add GitHub Actions, filtering, and remote caching - **Section 7: Scaling to Multiple Apps** - Add docs app with independent deploys - **Section 8: Enterprise Patterns** - Add generators, changesets, code governance, and explore next-forge production patterns ## Prerequisites - [Node.js 20.9+](https://nodejs.org/en/download/) and [pnpm 9+](https://pnpm.io/installation) installed - Comfortable with [React](https://react.dev) and [Next.js](https://nextjs.org) basics - [Git](https://git-scm.com/downloads) and [GitHub](https://github.com/) account - [Vercel](https://vercel.com/) account (free tier works fine for this course) - Basic terminal experience \*\*Note: Coming from Next.js?\*\* You already know component organization, build processes, and deployment. Turborepo extends these skills to managing multiple apps efficiently. You're 80% there. ## How this course works - **Build everything yourself:** Type every line of code so you can understand how everything works - **Deploy constantly:** Every section ends with working production apps - **Real metrics matter:** Measure cache hits, build times, actual URLs - **Progressive complexity:** Each section adds one new capability - **Production patterns only:** Everything you build ships to users ## Reference material This course builds on official Turborepo patterns: - **[Turborepo Docs](https://turbo.build/repo/docs)** - Reference when you need deep dives - **[Turborepo Examples](https://github.com/vercel/turbo/tree/main/examples)** - Runnable patterns for specific features - **[next-forge](https://github.com/haydenbleasel/next-forge)** - Vercel's production template explored in Section 8 \*\*Note: Build From Scratch\*\* You'll type out every package and app yourself. This ensures you understand how everything fits together. Reference implementations exist for patterns, but you'll build GeniusGarage with your own hands. ## Getting started Ready to ship? Start with **Monorepo Fundamentals** for conceptual foundation, or jump straight to **First Shared Package** to start building. --- [Full course index](/academy/llms.txt) · [Sitemap](/academy/sitemap.md)