Production-grade Next.js starter for modern SaaS applications.

Built for solo founders and small teams who want a fast, maintainable foundation without the enterprise complexity.

Most Next.js starters are either too basic or too complex. next-ship hits the sweet spot:

• Modern stack — Latest stable tools that work well together
• Simplified — Removed enterprise features you don't need as a solo founder
• Fast to ship — Pre-configured auth, payments, database, and analytics
• Easy to maintain — Consolidated tooling, flat URLs
• Production-ready — Type-safe, secure, and scalable

• Next.js 16.2 — React 19, latest features
• TypeScript 5.9 — Strict mode, end-to-end type safety
• Turborepo + pnpm — Monorepo with fast, disk-space efficient installs
• Tailwind CSS 4 — Latest syntax, no configuration needed

• Base UI — shadcn's next-generation component library (replacement for Radix)
• Tailwind CSS v4 — Latest features, no config
• Geist font — Modern, readable typography

• Node.js 20+
• pnpm

# Clone the repository
git clone https://github.com/oscardobsonbrown/next-ship.git
cd next-ship

# Install dependencies
pnpm install

# Set up environment variables
# Copy .env.example files to .env in each app/package and fill in your API keys

# Run database migrations
pnpm --filter @repo/database db:push

# Start development
pnpm dev

Create .env files in each app directory:

apps/web/.env:

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_WEB_URL=http://localhost:3001
NEXT_PUBLIC_POSTHOG_KEY=phc_...

apps/app/.env:

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...
CLERK_WEBHOOK_SECRET=whsec_...
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_POSTHOG_KEY=phc_...

apps/api/.env:

DATABASE_URL=postgresql://...
CLERK_SECRET_KEY=sk_test_...
CLERK_WEBHOOK_SECRET=whsec_...
POLAR_ACCESS_TOKEN=polar_...
POLAR_WEBHOOK_SECRET=whsec_...
RESEND_TOKEN=re_...

NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_WEB_URL=http://localhost:3001

See individual .env.example files for complete lists.

apps/
├── web/           # Marketing site (port 3001)
│   ├── /          # Homepage
│   ├── /contact   # Contact form
│   ├── /pricing   # Pricing page
│   └── /blog      # Blog with CMS integration
├── app/           # Main application (port 3000)
│   ├── /sign-in   # Authentication
│   ├── /sign-up
│   └── /dashboard # Main app dashboard
├── api/           # API server (port 3002)
│   └── /webhooks  # Payment webhooks, auth callbacks
├── docs/          # Documentation site
├── email/         # Email preview server
└── storybook/     # Component library

All apps are independently deployable.

packages/
├── auth/           # Clerk configuration
├── database/       # Drizzle ORM, schema, migrations
├── design-system/  # Base UI components, Tailwind config
├── payments/       # Polar.sh integration
├── analytics/      # PostHog client/server
├── observability/  # Error handling, logging
├── security/       # Security headers configuration
├── cms/            # BaseHub integration
├── email/          # React Email templates
├── ai/             # Vercel AI SDK utilities
├── seo/            # Metadata, sitemaps, JSON-LD
└── typescript-config/  # Shared TypeScript settings

Clean URL structure without locale prefixes. /contact instead of /en/contact. Simpler routing, faster builds, no configuration needed.

One tool instead of three:

• PostHog for analytics, session replay, and error tracking
• No Sentry (replaced by PostHog error tracking)
• No Logtail (Vercel logs + PostHog capture are sufficient)

Drizzle ORM instead of Prisma:

• Better query performance
• SQL-like syntax (you write actual SQL)
• Smaller bundle size
• Edge runtime compatible

Polar.sh for payments:

• Better developer experience
• Modern TypeScript SDK
• Webhook handling included
• Perfect for SaaS subscriptions

Base UI instead of Radix:

• shadcn's next-generation component library
• Better accessibility
• No asChild prop complexity
• Cleaner composition patterns

Drizzle ORM with Neon PostgreSQL:

// packages/database/src/schema.ts
import { pgTable, serial, varchar } from "drizzle-orm/pg-core";

export const pages = pgTable("pages", {
  id: serial("id").primaryKey(),
  name: varchar("name", { length: 255 }).notNull(),
});

Run migrations:

pnpm --filter @repo/database db:generate  # Generate migration files
pnpm --filter @repo/database db:push     # Push to database
pnpm --filter @repo/database db:studio     # Open Drizzle Studio

Base UI components via shadcn CLI:

# Add a component
npx shadcn@latest add button -c packages/design-system

# Use in your app
import { Button } from "@repo/design-system/components/ui/button";

Composition pattern (no asChild):

// ✅ Correct
<Link href="/contact">
  <Button>Contact</Button>
</Link>

// ❌ Old pattern (doesn't work with Base UI)
<Button asChild>
  <Link href="/contact">Contact</Link>
</Button>

# Type check all packages
pnpm typecheck

# Run tests
pnpm test

# Build all apps
pnpm build

# Lint and format
pnpm check
pnpm fix

# Update dependencies
pnpm bump-deps

# Update all shadcn components
pnpm bump-ui

After modifying schema:

1. Edit packages/database/src/schema.ts
2. Run pnpm --filter @repo/database db:generate
3. Run pnpm --filter @repo/database db:push

1. Create directory in apps/
2. Add package.json with dependencies
3. Create next.config.ts
4. Add to turbo.json pipeline if needed

1. Connect your GitHub repository to Vercel
2. Set environment variables in Vercel dashboard
3. Deploy

The monorepo is configured to deploy all apps independently via Turborepo.

Each app needs specific environment variables:

• Web: NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY, NEXT_PUBLIC_POSTHOG_KEY, etc.
• App: All Clerk variables, PostHog key
• API: Database URL, all service API keys (Polar, Resend, etc.)

Built on lessons learned from next-ship, with simplifications for solo founders:

• Removed complex routing patterns
• Consolidated observability tools
• Updated to latest stack (Drizzle, Base UI, Polar.sh)
• Flattened URL structure
• Simplified codebase

MIT