ignitionstack.pro v1.0 is out! Read the announcement →
Skip to Content

Setup Overview

Complete guide to setting up ignitionstack.pro for development and production.

Quick Setup Checklist

Install Dependencies

npm install

Configure Environment

cp .env.example .env # Edit .env with your credentials

Set Up Supabase

Configure database, auth, and storage. See Supabase Setup.

Start Development

npm run dev

Setup Guides

Configure all required and optional environment variables

Environment Variables

Database, authentication, and storage setup

Supabase

Payment processing and webhooks

Stripe

Transactional emails with Resend

Email

Google Analytics and Mixpanel tracking

Analytics

Setup Priority

Required (Core)

SetupPurposeTime
Environment VariablesApplication configuration5 min
SupabaseDatabase + Auth + Storage15 min

Optional (Features)

SetupPurposeWhen Needed
StripePayment processingE-commerce features
EmailTransactional emailsContact forms, notifications
AnalyticsUser trackingProduction monitoring
AIChatbot featuresAI features enabled

Configuration Files

Essential Files

FilePurpose
.envEnvironment variables
supabase/config.tomlLocal Supabase config
next.config.tsNext.js configuration
tailwind.config.tsTailwind CSS setup

Development Files

FilePurpose
.vscode/settings.jsonVS Code configuration
vitest.config.tsUnit test configuration
playwright.config.tsE2E test configuration

Environment-Specific Setup

Development

# Copy example env file cp .env.example .env # Install dependencies npm install # Start dev server npm run dev

Development server runs at http://localhost:3000 

Production

# Build application npm run build # Start production server npm run start

Testing

# Unit tests npm run test # E2E tests npm run e2e

Common Setup Scenarios

Full-Stack Development

Complete setup with all features:

  1. Supabase (database + auth)
  2. Stripe (payments)
  3. Resend (email)
  4. Analytics (GA + Mixpanel)
  5. AI providers

Minimal Setup

Just get it running:

  1. Supabase credentials
  2. Auth secret
  3. Skip optional features

Local Development

Isolated development:

  1. Supabase local (Docker)
  2. Stripe test mode
  3. Console logging instead of analytics

Verification Steps

After setup, verify everything works:

1. Database Connection

npm run db:gen

Should generate types without errors.

2. Development Server

npm run dev

Visit http://localhost:3000 

3. Authentication

Navigate to /login and test sign-in.

4. Admin Access

Access /admin with an admin email.

Troubleshooting

1.

Port 3000 already in use

npm run stop:all
2.

Environment variables not loading

  • Check .env file exists in root
  • Restart dev server after changes
  • Verify NEXT_PUBLIC_ prefix for client vars
3.

Supabase connection failed

  • Verify URL and keys in .env
  • Check project exists in Supabase dashboard
  • Ensure RLS policies are configured
4.

Build errors

# Clear cache and reinstall npm run clean npm run build

Next Steps

Complete variable reference

Environment Variables

Database and auth configuration

Supabase Setup

Deploy to production

Deployment