Installation

Installation Guide

Get the MicroSaaS Template up and running in minutes

Prerequisites

  • Node.js 18+ and npm
  • Stripe account (for payment functionality)
  • Docker (optional, for production deployment)

Installation Steps

  1. Install dependencies 
    npm run install-deps
  2. Configure environment 
    cp .env.example .env
# Fill in STRIPE keys and other required values
  3. Start development server 
    npm run dev

    Access the application at http://localhost:3001

Required Environment Variables

  • VITE_STRIPE_PUBLISHABLE_KEY - Client-side Stripe key
  • VITE_STRIPE_PRICE_ID - Your Stripe Price ID
  • STRIPE_SECRET_KEY - Server-side Stripe key
  • STRIPE_WEBHOOK_SECRET - Webhook verification secret

Troubleshooting

  • 404 for /app/* routes: Ensure client/dist/index.html exists (run cd client && npm run build)
  • Invalid webhook signature: Verify STRIPE_WEBHOOK_SECRET matches your endpoint configuration
  • No download available: Confirm assets/saas-template.zip exists and email has verified payment