Documentation

ShipMe Documentation

Everything you need to provision production-ready infrastructure in under 5 minutes.

Getting Started

1. Describe Your Idea

Start by visiting shipme.dev/new and describing your app idea in plain English.

"A SaaS for tracking fitness goals with social features, leaderboards, and personal training plans"

2. Review AI Recommendation

Claude AI analyzes your requirements and recommends the optimal services based on your budget, scale, and platform needs.

Framework
Next.js
Database
Supabase
Hosting
Vercel

3. Connect Your Services

Click the "Connect" buttons to get your API tokens from each service. Follow the step-by-step instructions provided.

Security Note: Your tokens are used once for provisioning and immediately deleted. ShipMe never stores your credentials.

4. Start Provisioning

Click "Start Provisioning" and watch ShipMe create your entire infrastructure:

  • GitHub repository with initial files
  • Vercel project with auto-deploy
  • Supabase database with auth configured
  • GitHub Codespaces with Claude Code
  • INFRASTRUCTURE.md documentation

5. Start Coding

Open your project in GitHub Codespaces with Claude Code pre-installed. Add your Anthropic API key and start building with AI assistance!

How It Works

AI-Powered Recommendations

Claude AI analyzes your app description, budget, target platform, and expected scale to recommend the optimal combination of services. The AI considers free tier limits, scalability, and developer experience.

Automated Provisioning

ShipMe uses official APIs from GitHub, Vercel, and Supabase to create and configure all your resources. Everything is set up with best practices: environment variables synced, CI/CD configured, and services connected.

INFRASTRUCTURE.md

Every project gets a comprehensive documentation file that includes: all service details, free tier limits, environment variable reference, cost projections, upgrade guidance, and maintenance checklist.

GitHub Codespaces + Claude Code

Your project includes a devcontainer.json that pre-installs Claude Code. Open in Codespaces, add your Anthropic API key, and start coding with AI assistance immediately.

Service Setup

You'll need API tokens from each service. Here's how to get them:

GitHub Personal Access Token

  1. Go to GitHub Settings → Developer Settings → Personal Access Tokens
  2. Click "Generate new token (classic)"
  3. Give it a name like "ShipMe Provisioning"
  4. Select scopes: repo, workflow, admin:repo_hook
  5. Click "Generate token" and copy it

Vercel Access Token

  1. Go to Vercel Dashboard → Settings → Tokens
  2. Click "Create" to generate a new token
  3. Give it a name like "ShipMe"
  4. Set scope to "Full Account" for provisioning
  5. Click "Create Token" and copy it

Supabase Access Token

  1. Go to Supabase Dashboard → Account → Access Tokens
  2. Click "Generate new token"
  3. Give it a name like "ShipMe"
  4. Copy the generated token (starts with sbp_)
  5. Also note your Organization ID from Settings

Supported Services

ShipMe supports these service combinations. More coming soon!

Next.js + Supabase + Vercel

Full-stack SaaS with auth, database, and deployment

GitHubVercelSupabase
Available

React + Netlify + Supabase

JAMstack app with serverless functions

GitHubNetlifySupabase
Coming Soon

Next.js + Railway + PostgreSQL

Full-stack app with managed PostgreSQL

GitHubRailwayPostgreSQL
Coming Soon

Free Tier Overview

All recommended services have generous free tiers. Here's what you get at $0/month:

GitHub

  • • Unlimited repos
  • • 2,000 CI/CD minutes/mo
  • • 500MB packages
  • • Codespaces: 60 hrs/mo

Vercel

  • • Unlimited deployments
  • • 100GB bandwidth/mo
  • • Serverless functions
  • • Automatic HTTPS

Supabase

  • • 500MB database
  • • 50K monthly users
  • • 1GB file storage
  • • Unlimited API requests

Perfect for: MVPs, side projects, learning, and apps with less than 1,000 monthly active users.

Security

Credential Handling

ShipMe stores credentials in memory only during the provisioning process. Once infrastructure setup completes, all API keys, OAuth tokens, and sensitive data are permanently deleted. We never store your tokens in any database.

What We Access

ShipMe requests minimum necessary permissions:

  • GitHub: Create repos, push files, configure Actions
  • Vercel: Create projects, set environment variables
  • Supabase: Create projects, configure auth

Best Practices

  • • Use tokens with minimal required permissions
  • • Revoke tokens after provisioning if desired
  • • Enable 2FA on all connected services
  • • Review INFRASTRUCTURE.md for security guidelines

Ready to Ship?

Go from idea to deployed app in under 5 minutes.

Start Provisioning