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

Installation

Get ignitionstack.pro up and running in minutes.

Prerequisites

Before you begin, make sure you have the following installed:

ToolVersionDescription
Node.js18.17+JavaScript runtime
npm/pnpm/yarnLatestPackage manager
GitLatestVersion control
Supabase CLILatestDatabase management

We recommend using Node.js 20 LTS for the best experience.

Quick Start

Clone the Repository

git clone https://github.com/ignitionstackpro/ignitionstack.pro.git
cd ignitionstack.pro

Install Dependencies

npm install

Configure Environment Variables

Copy the example environment file:

cp .env.example .env

Edit .env with your credentials. See Environment Variables for detailed configuration.

Start Development Server

npm run dev

Open Your Browser

Navigate to http://localhost:3000  to see your application.

Environment Variables Overview

Never commit your .env file to version control. It contains sensitive credentials.

Required Variables

These are the minimum variables needed to run the application:

.env
# Supabase (Required)
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
 
# Authentication (Required)
AUTH_SECRET=your-nextauth-secret  # Generate: openssl rand -base64 32

Optional Integrations

.env
# Stripe Payments
STRIPE_SECRET_KEY=sk_test_...
NEXT_PUBLIC_STRIPE_PUBLIC_KEY=pk_test_...
STRIPE_WEBHOOK_SECRET_KEY=whsec_...
 
# Email (Resend)
RESEND_API_KEY=re_...
RESEND_API_EMAIL_FROM=noreply@yourdomain.com
 
# Analytics
NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX
AUTH_MIXPANEL_TOKEN=your-token
 
# AI Features
AI_ENCRYPTION_KEY=your-32-char-key  # Generate: openssl rand -hex 32
OPENAI_API_KEY=sk-...
GOOGLE_AI_API_KEY=...

See Setup Guide for complete configuration of each integration.

Available Scripts

CommandDescription
npm run devStart development server on port 3000
npm run dev:turboStart with Turbopack (faster)
npm run dev:docsStart documentation on port 3001
npm run dev:allStart app + docs simultaneously
npm run buildBuild for production
npm run testRun unit tests with Vitest
npm run e2eRun E2E tests with Playwright
npm run lintRun ESLint
npm run db:genGenerate Supabase types
npm run db:pushPush database migrations

Database Setup

Install Supabase CLI

npm install -g supabase

Login to Supabase

supabase login
supabase link --project-ref your-project-ref

Push Database Schema

npm run db:push

Generate TypeScript Types

npm run db:gen

See Supabase Setup for detailed database configuration including RLS policies.

Verify Installation

After installation, verify everything is working:

  1. Development server runs without errors
  2. Database connection works (check Supabase dashboard)
  3. Authentication redirects to login page
  4. Environment variables are loaded correctly

Troubleshooting

Common Issues

1.

Port 3000 already in use

Kill the process using the port:

npm run stop:all
# or manually
kill -9 $(lsof -t -i:3000)
2.

Module not found errors

Clean install dependencies:

npm run clean
3.

Supabase connection failed

Verify your .env variables and ensure RLS policies are configured.

Next Steps