Skip to content

Development and deployment orchestrator for BaaS platforms. Bridge the gap between local development and production.

License

Notifications You must be signed in to change notification settings

lightstack-dev/cli

Repository files navigation

Lightstack logo

Lightstack CLI

npm version License: MIT

Self-host Supabase in production. Get production-grade local development with HTTPS, then deploy the identical stack (PostgreSQL, Auth, API, Storage) to your own servers. Escape Supabase Cloud costs while maintaining perfect dev/prod parity.

Why?

Cost: Supabase hosted pricing: $25/month → $2,900/month as you scale. Self-host for $20-200/month.

Control: Your PostgreSQL database on your servers. GDPR/HIPAA compliant. No vendor lock-in.

Dev/Prod Parity: Identical Docker containers from localhost to production. What works locally works in production.

Quick Start

# Install
npm install -g @lightstack-dev/cli

# Initialize Supabase project
# See https://supabase.com/docs/guides/local-development
supabase init

# Initialize Lightstack (adds HTTPS proxy)
light init

# Start Lightstack proxy
light up

# Run your app's dev server
npm run dev

# Access everything via HTTPS
# https://app.lvh.me → your app (localhost:3000)
# https://api.lvh.me → Supabase API
# https://studio.lvh.me → Supabase Studio
# https://router.lvh.me → Traefik dashboard

Requirements

Development:

Production:

  • Docker-compatible Linux server (VPS, cloud instance, etc.)
  • SSH access to server
  • Domain name pointing to your server
  • Let's Encrypt-supported DNS provider

Commands

light init              # Initialize project
light up                # Start local stack
light down              # Stop local stack
light status            # Show service status
light logs [service]    # View logs
light env add [name]    # Add deployment target

Full documentation: https://cli.lightstack.dev (coming soon)

What's Included

  • ✅ Self-hosted Supabase (PostgreSQL, Auth, API, Storage, Studio, Realtime)
  • ✅ Local HTTPS with mkcert
  • ✅ Automatic database migrations
  • ✅ Environment management
  • ✅ Health checks and monitoring
  • 🚧 App containerization for deployment testing (#6)
  • 🚧 Remote deployment via SSH (#4)
  • 🚧 Let's Encrypt SSL automation (#5)

Development

This project is under active development. See open issues for planned features.

Contributing? Read CLAUDE.md for development guidelines.

License

MIT © Lightstack

About

Development and deployment orchestrator for BaaS platforms. Bridge the gap between local development and production.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •