SupaStart
Purchase
Getting Started

Installation

Get started with Supastart quickly by following this guide.

This guide targets Next.js 16, React 19, and Supabase 2. This guide will help you set up Supastart for development.

Requirements

Before installing Supastart, ensure you have:

  • Node.js: Version 20.x LTS or higher (18.x minimum)
  • npm: Version 9.x or higher (comes with Node.js)
  • Git: Latest version
  • Supabase Account: Free tier is sufficient for development

Database Setup

Supastart uses Supabase for authentication and database functionality.

Check out our Supabase Setup Guide for detailed instructions.

Installation Steps

Download

Download the latest version of Supastart from the Keenthemes download page.

Install Dependencies

Install project dependencies using npm:

npm install --force

Note: We use Next.js 16 with React 19. You may see peer dependency warnings, which can be safely ignored.

Environment Setup

  1. Create a .env.local file:
cp .env.example .env.local
  1. Configure required environment variables:
# Supabase Configuration (required)
NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-supabase-anon-key
 
# App URLs
NEXT_PUBLIC_APP_URL=http://localhost:3000
 
# Optional: for server-side operations (e.g. admin APIs)
# SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
 
# Google OAuth (Optional)
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
# CALLBACK_URL=https://your-project-ref.supabase.co/auth/v1/callback

You can get the Supabase credentials from the Supabase Setup Guide.

Database Setup

Set up the database schema using the SQL scripts included in the project:

  1. Navigate to the SQL Editor in your Supabase Dashboard
  2. First, create the database schema:
    • Open the src/db/schema.sql file from your project
    • Copy the contents and paste them into the SQL Editor
    • Execute the SQL to create the necessary tables and configurations
  3. Then, seed the database with initial data:
    • Open the src/db/seed.sql file from your project
    • Copy the contents and paste them into the SQL Editor
    • Execute the SQL to populate your database with initial data

The schema.sql file creates necessary tables, views, security policies, and triggers, while the seed.sql file populates the database with sample data for testing. Run both before starting the app for the first time.

Development Server

Start the development server:

npm run dev

Your application will be available at http://localhost:3000

Additional Commands

  • Lint Code:
npm run lint
  • Production Build:
npm run build
  • Start Production Server:
npm run start
Installation - SupaStart