Getting Started with Shipd

Building a SaaS product from scratch can take months. Shipd changes that by providing production-ready templates with everything you need to launch quickly.

What is Shipd?

Shipd is a modular SaaS scaffold that helps developers build and ship SaaS products faster. Instead of spending weeks setting up authentication, payments, and infrastructure, you can have a production-ready application in minutes.

Key Features

• 🔐 Authentication - Ready-to-use auth with Better Auth
• 💳 Payments - Integrated payment processing with Polar.sh
• 📊 Dashboard - Pre-built admin dashboard
• 🎨 UI Components - Beautiful components with Tailwind CSS
• 📝 Documentation - Comprehensive docs and guides
• 🚀 CLI Tool - Simple command-line interface

Quick Start

Getting started with Shipd is as simple as running one command:

npx shipd init my-saas-app

This interactive CLI will guide you through:

1. Choosing your project name
2. Selecting features to include
3. Configuring your environment
4. Setting up your database

Project Structure

Once initialized, your project will have a clean, modular structure:

my-saas-app/
├── app/
│   ├── (auth)/          # Authentication pages
│   ├── dashboard/       # Dashboard pages
│   ├── api/            # API routes
│   └── layout.tsx      # Root layout
├── components/
│   ├── ui/             # UI components
│   └── marketing/      # Marketing components
├── lib/
│   ├── auth.ts         # Auth utilities
│   ├── db.ts           # Database client
│   └── subscription.ts # Subscription logic
└── public/             # Static assets

Environment Setup

After initialization, create a .env.local file with your credentials:

# Database
DATABASE_URL=postgresql://user:password@host:5432/db

# Authentication
BETTER_AUTH_SECRET=your-secret-key
BETTER_AUTH_URL=http://localhost:3000

# Payments (Polar.sh)
POLAR_ACCESS_TOKEN=your-polar-token
POLAR_WEBHOOK_SECRET=your-webhook-secret

Running Your App

Start the development server:

npm run dev

Your app will be available at http://localhost:3000

Next Steps

Now that you have your SaaS up and running, here are some recommended next steps:

1. Customize Your Brand - Update colors, logo, and copy
2. Configure Payments - Set up your Polar.sh products
3. Add Features - Use npx shipd append to add more modules
4. Deploy - Deploy to Vercel, Railway, or your preferred platform

Adding More Features

Shipd's modular architecture lets you add features as you need them:

# Add blog functionality
npx shipd append --features blog

# Add analytics
npx shipd append --features analytics

# Add customer support
npx shipd append --features support

Learn More

• Documentation - Full documentation
• API Reference - API endpoints
• Deployment Guide - Deploy your app
• GitHub - Source code

Conclusion

Shipd helps you focus on what matters: building your unique product. Skip the boilerplate and start shipping today.

Ready to build? Run npx shipd init and launch your SaaS in minutes.