Getting Started

Get up and running in under 5 minutes.

Prerequisites

Make sure you have the following installed:

Node.js 22+ — Download
pnpm — Install with npm install -g pnpm
Rust (for the API) — Install via rustup
PostgreSQL (for the API) — Download
Git — Download

Installation

1. Clone the Repository

git clone https://github.com/dzikrisyairozi/monorepo-fullstack-starter.git
cd monorepo-fullstack-starter

2. Install Dependencies

pnpm install

This installs dependencies for all apps and packages in the monorepo.

3. Set Up Environment Variables

# Copy example env files (if they exist)
cp apps/api/.env.example apps/api/.env
cp apps/web/.env.example apps/web/.env

4. Set Up the Database (for the API)

Make sure PostgreSQL is running, then:

# Create your database and run migrations
# Check apps/api/README.md for specific instructions

Running the Development Servers

Start Everything

pnpm dev

This launches all apps in parallel using Turborepo.

Start Individual Apps

# Web (landing page) — http://localhost:3000
pnpm dev:web

# Dashboard — http://localhost:5174
pnpm dev:dashboard

# API — http://localhost:8080
pnpm dev:api

# Docs — http://localhost:3002
pnpm dev:docs

Build for Production

# Build everything
pnpm build

# Build a specific app
pnpm build:web
pnpm build:docs

Useful Scripts

pnpm lint          # Lint all packages
pnpm lint:fix      # Auto-fix linting issues
pnpm format        # Format with Prettier
pnpm type-check    # TypeScript type checking
pnpm test          # Run all tests
pnpm check-all     # Run type-check + lint + format check

Getting Started

On this page