Shipd CLI

Generate production-ready SaaS applications in minutes

Shipd is a powerful CLI tool that generates complete SaaS applications with authentication, billing, user management, and a beautiful dashboard - all configured and ready to deploy.

Features

• Complete Authentication System - Powered by Better Auth with Google OAuth, magic links, and secure session management
• Integrated Billing - Polar.sh integration with subscription management and checkout flow
• Modern Tech Stack - Next.js 15, React 19, TypeScript, Tailwind CSS, Drizzle ORM
• Database Ready - PostgreSQL with Supabase integration out of the box
• Beautiful UI - Pre-built dashboard, pricing page, and user management interface
• Production Ready - Configured for deployment on Vercel and Railway
• Email System - Resend integration for transactional emails
• TypeScript First - Full type safety across the entire application

Installation

You don't need to install Shipd globally. Use npx to run it directly:

npx shipd init my-saas-app

Or install globally:

npm install -g shipd

Quick Start

1. Create Your Project

Note: Authentication is automatic. If you're not logged in, the CLI will prompt you to authenticate via your browser when you run any command.

Generate a new SaaS application:

npx shipd init my-saas-app

The CLI will:

• Create a new Next.js project with all features configured
• Set up the database schema
• Configure authentication and billing
• Install all dependencies
• Prepare your .env.local with required environment variables

3. Configure Environment Variables

Update the .env.local file with your credentials:

# Database (Supabase)
DATABASE_URL=your-supabase-connection-string

# Auth (Better Auth)
BETTER_AUTH_SECRET=your-secret-key
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret

# Email (Resend)
RESEND_API_KEY=your-resend-api-key

# Billing (Polar.sh)
POLAR_ACCESS_TOKEN=your-polar-access-token
NEXT_PUBLIC_STARTER_TIER=your-product-id
NEXT_PUBLIC_STARTER_SLUG=your-product-slug

4. Run Your Application

cd my-saas-app
npm run dev

Your SaaS application is now running at http://localhost:3000!

Available Commands

shipd init [project-name]

Initialize a new SaaS project with all features configured.

npx shipd init my-saas-app

Options:

• --features <features> - Comma-separated list of features to include (e.g., auth,payments,email)
• --description <description> - Project description
• --package-manager <manager> - Package manager to use (npm, pnpm, yarn)
• --mock - Skip authentication for development/testing purposes

Example:

# Interactive mode (select features)
npx shipd init my-saas-app

# Non-interactive mode
npx shipd init my-saas-app --features marketing-landing,auth,payments

shipd append

Add Shipd features to an existing Next.js project. Perfect for adding features incrementally.

npx shipd append

Options:

• --features <features> - Comma-separated list of features to add (e.g., auth,payments,email)
• --dry-run - Preview changes without applying them

Available features:

• marketing-landing - Complete marketing homepage with hero, features, testimonials
• docs - Documentation pages with navigation and layout
• database - PostgreSQL database setup with Drizzle ORM
• auth - Authentication with Better Auth (sign-in, sign-up, Google OAuth)
• payments - Payments and subscriptions with Polar.sh
• email - Transactional emails with Resend and React Email
• ai-chat - OpenAI streaming chat interface
• file-upload - Cloudflare R2 file uploads with drag-and-drop
• analytics - PostHog analytics and feature flags
• seo - Sitemap, robots.txt, blog structure, structured data

Example:

# Interactive mode (select features)
npx shipd append

# Add specific features
npx shipd append --features auth,database,payments

# Preview changes without applying
npx shipd append --features seo --dry-run

Note: The append command automatically:

• Installs required dependencies
• Merges database schemas
• Updates environment variables in .env.example
• Patches middleware for route protection
• Runs build verification

shipd list

List all available features and modules.

npx shipd list

shipd login

Manually authenticate with your Shipd account (usually not needed - authentication is automatic).

npx shipd login

shipd logout

Sign out from your Shipd account.

npx shipd logout

What's Included

Shipd uses a modular architecture. Start with a minimal base and add only the features you need.

Base Package (Always Included)

• Next.js 15 with App Router
• TypeScript with strict mode
• Tailwind CSS + shadcn/ui (24+ components)
• Minimal setup - ready for features

Available Feature Modules

Choose from 10 standalone modules:

1. Marketing Landing Page - Complete homepage with hero, features, testimonials, integrations
2. Documentation Pages - Full docs structure with navigation, search, and code examples
3. Database - PostgreSQL setup with Drizzle ORM, migrations, and lazy connection
4. Authentication - Better Auth with sign-in/sign-up, Google OAuth, protected routes, dashboard
5. Payments - Polar.sh integration with subscriptions, checkout, webhooks, management UI
6. Email - Resend integration with React Email templates (welcome, password reset, etc.)
7. AI Chat - OpenAI streaming chat interface with GPT-4o and web search
8. File Upload - Cloudflare R2 uploads with drag-and-drop UI and progress tracking
9. Analytics - PostHog integration for event tracking and feature flags
10. SEO - Automated sitemap, robots.txt, blog structure, and structured data utilities

Workflow Options

Option 1: Start Fresh

npx shipd init my-app --features marketing-landing,auth,payments

Option 2: Incremental

# Start with base
npx shipd init my-app

# Add features later
cd my-app
npx shipd append --features auth,database
npx shipd append --features payments

Both workflows are fully supported!

Requirements

• Node.js 18.x or higher
• Active Shipd subscription (authentication is automatic)
• npm, pnpm, or yarn package manager

Pricing

Shipd requires an active subscription to generate projects. Visit shipd.dev to view pricing and subscribe.

Support

• Documentation: shipd.dev/docs
• Issues: GitHub Issues
• Email: [email protected]

License

MIT

Links

• Website
• GitHub Repository
• Documentation

Made with ❤️ by the Shipd team