sammaji / turbo-starter

The starter pack to ship apps fast -> Turborepo + Next.js + NextAuth + Prisma + Radix (shadcn/ui)

Turborepo Starter Pack

This is an opinionated Javascript/Typescript monorepo starter pack built on top-notch technologies that enables you to focus on business logic instead of complex project setup.

Free. Open Source.

See the demo

Created and maintained by @jakubhavej

What's inside?

It's based on Turborepo project structure. Each package/app is 100% TypeScript.

Apps and Packages

• web: a Next.js app (the main one, used for demo purposes)
• docs: another Next.js app

A collection of reusable and ready-to-use packages used throughout the monorepo:

• database: powered by Prisma, the Node.js and Typescript ORM.
• eslint-config-custom: ESLing configurations.
• prettier-config: Prettier configurations.
• tailwind-config: Tailwind CSS configurations.
• tsconfig: Typescript configurations.
• ui: Beautifully designed components by shadcn/ui. Based on Radix & Tailwind CSS & Lucide Icons. Fully customizable.

A work-in-progress packages:

• tRpc: End-to-end typesafe APIs made easy.
• File storage: A tooling for uploading and storing files.
• Internationalization: Translations and related management.
• Emailing: Sending transactional emails in-app.
• Chrome extension: A boilerplate for creating Chrome extensions using React and Typescript.
• Content management system (CMS): A headless CMS integration.
• Analytics: A tooling for collecting essential insights about site usage and performance.

Using the starter pack

Clone the repository:

git clone [e-mail]:jhavej/turbo-starter.git

Install pnpm and Node v18.16.0 (preferably via nvm)

Create a .env.local file based on the provided .env.local.example - this enables Google OAuth and a connection to a PostgreSQL database (create one e.g. on Vercel or Supabase or Neon -- it will work out of the box once connected via the environment variables)

Install project dependencies:

pnpm install

Spin up the development server:

pnpm run dev

Remote Caching (optional)

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 from the project root:

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

Useful Links

Learn more about the power of Turborepo:

• Tasks
• Caching
• Remote Caching
• Filtering
• Configuration Options
• CLI Usage