Turborepo Starter

A modern, turbocharged monorepo template for building Next.js apps with ease. Packed with Next.js 15, Turborepo, Shadcn UI, and Biome.js, this starter is your shortcut to a fast, scalable, and beautiful web project—all wrapped in a Docker-friendly setup.

---

✨ Why This Starter?

• Monorepo Magic: Turborepo optimizes builds and caching across apps and packages.
• Next.js 15: The latest Next.js with Turbopack for blazing-fast development.
• Shadcn UI: Beautiful, accessible React components paired with Tailwind CSS.
• Biome.js: A single, speedy tool for linting and formatting—no ESLint/Prettier mess.
• Docker Ready: Spin up with Docker Compose for consistent environments.
• pnpm Workspaces: Efficient dependency management with pnpm.

Perfect for developers who want a cutting-edge stack without the setup hassle.

---

🗂️ Project Structure

├── apps/
│   └── web/                # Next.js 15 app
├── packages/
│   ├── ui/                 # Shadcn UI components & utilities
│   └── typescript-config   # Shared TypeScript settings
├── docker-compose.yml      # Docker setup
├── turbo.json              # Turborepo config
└── pnpm-workspace.yaml     # Workspace definitions

---

🛠️ Get Started

Prerequisites

• Node.js (v22.12.0+)
• pnpm (npm i -g pnpm@10.6.2)
• Docker (optional, for containerized dev)

Setup

git clone https://github.com/ProductOfAmerica/turbo-starter.git
cd turbo-starter
pnpm install

Run Locally

pnpm dev           # Start the Next.js app
pnpm turbo check-types  # Type checking

Build

pnpm build         # Build all apps and packages

Docker

pnpm docker        # Launch with Docker Compose
pnpm docker:build  # Rebuild containers

---

🎨 Code Quality

Keep your code sharp with Biome.js:

pnpm format-write  # Format code
pnpm lint         # Check for issues
pnpm lint:fix     # Auto-fix issues

---

🌟 Bonus Features

• Remote Caching: Connect to Vercel for faster builds:

  npx turbo login
  npx turbo link

• Shared UI: Reuse components and utilities from packages/ui across projects.

---

🤝 Contribute

Love this starter? Star it, fork it, or submit a PR! Let’s make it even better together.

• Issues
• Docs

---

Built with ❤️ by ProductOfAmerica. Happy coding!