Skip to main content

Quick Start Guide

Get the AI Agentification Platform up and running in under 10 minutes.

Prerequisites​

  • Node.js 18+ installed
  • Git installed
  • A Supabase account (free tier works)
  • A code editor (VS Code recommended)

1. Clone and Install​

# Clone the repository
git clone <your-repo-url>
cd "AI Agentification Platform Website Content"

# Install dependencies
npm install

2. Set Up Supabase​

Create a Supabase Project​

  1. Go to supabase.com
  2. Click "Start your project"
  3. Create a new project
  4. Wait for it to initialize (~2 minutes)

Get Your Credentials​

  1. Go to Settings → API
  2. Copy these values:
    • Project URL (e.g., https://xxx.supabase.co)
    • anon public key

Run Database Setup​

  1. Go to SQL Editor in your Supabase dashboard
  2. Click "New Query"
  3. Copy the contents of supabase/migrations/ files
  4. Run each migration file in order
  5. Verify tables were created in the Table Editor

3. Configure Environment​

Create a .env file in the project root:

# Supabase Configuration
VITE_SUPABASE_URL=https://your-project.supabase.co
VITE_SUPABASE_ANON_KEY=your_anon_key_here

# Environment
NODE_ENV=development

4. Start Development Server​

# Start both frontend and backend
npm run dev

# The application will open at:
# Frontend: http://localhost:5173
# Backend API: http://localhost:5001

5. Create Your First Admin User​

  1. Open the application at http://localhost:5173
  2. Click "Sign Up"
  3. Create an account with your email
  4. Check your email for the verification link
  5. Click the link to verify your account

Make Yourself an Admin​

  1. Go to Supabase Dashboard → Authentication → Users
  2. Find your user account
  3. Click on it to edit
  4. In the User Metadata section, add: 
    {
      "role": "admin"
    }
  5. Save changes
  6. Log out and log back in to the application

6. Verify Everything Works​

Check the Homepage​

  • Navigate to http://localhost:5173
  • You should see the landing page

Check the Admin Dashboard​

  1. Log in with your admin account
  2. Navigate to http://localhost:5173/admin
  3. You should see the admin panel

Test Database Connection​

  • The admin dashboard should load data from Supabase
  • If you see loading errors, check your environment variables

Common First-Time Issues​

"Failed to fetch" errors​

  • Cause: Backend server not running
  • Fix: Make sure you ran npm run dev (not just npm run dev:frontend)

"Invalid API key" errors​

  • Cause: Wrong credentials in .env
  • Fix: Double-check you copied the correct values from Supabase

Blank admin dashboard​

  • Cause: User doesn't have admin role
  • Fix: Add "role": "admin" to user metadata in Supabase

Database tables not found​

  • Cause: Migrations not run
  • Fix: Run all SQL migration files in Supabase SQL Editor

Next Steps​

Now that you're set up:

  1. Read DEVELOPMENT_SETUP.md for complete development environment details
  2. Read DEPLOYMENT.md when you're ready to deploy to production
  3. Explore the Component Library for building features
  4. Check out Content Management to add courses and content

Quick Reference​

Start Development​

npm run dev              # Start both frontend and backend
npm run dev:frontend     # Frontend only
npm run dev:backend      # Backend only

Build for Production​

npm run build           # Build optimized production bundle
npm run preview         # Preview production build locally

Database Operations​

npm run generate-sitemap    # Generate sitemap from database content

Getting Help​

Support​

If you run into issues:

  1. Check the browser console for errors
  2. Check the terminal where the dev server is running
  3. Verify your .env file has the correct values
  4. Make sure all Supabase migrations have been run
  5. Try clearing your browser cache and localStorage

You're all set! Happy coding!