Skip to main content

​
ShipFree

ShipFree is a production-ready Next.js template that ships the boring parts for you: auth, payments, email, storage, and a clean UI system.
This documentation is written for both community users and premium customers. Premium-only features are clearly marked when they apply.

​
What you get

  • Next.js App Router with server components by default
  • Better-Auth with email OTP and social providers
  • Payments with Stripe, Polar, and Lemon Squeezy adapters
  • Email delivery with Resend, Postmark, Plunk, SMTP, or a custom provider
  • Cloudflare R2 storage client
  • Sentry instrumentation hooks

​
Core design principles

  • Server components by default, client components only for interactivity
  • Environment variables are validated in src/config/env.ts
  • Adapter-based providers for payments and email
  • Clear route groups for auth, main app, and marketing pages

​
Where to start

1

Install dependencies

Run bun install in the repo root.
2

Configure environment

Copy .env.example to .env and fill in required values.
3

Run migrations

Run bun run migrate:local to initialize the database.
4

Start development

Run bun dev and open the app at http://localhost:3000.

​
Support

For support, update the default support email in src/config/branding.ts and use it in your customer-facing comms.