Quick Start

Note: This is mock/placeholder content for demonstration purposes.

Get your development environment up and running quickly.

Prerequisites

Before you begin, ensure you have:

• Node.js 18.x or higher
• pnpm 8.x or higher
• Git for version control
• A Supabase account (free tier works great)

Step 1: Clone the Repository

git clone https://github.com/yourorg/yourapp.git
cd yourapp

Step 2: Install Dependencies

pnpm install

This will install all required dependencies across the monorepo.

Step 3: Set Up Environment Variables

Copy the example environment file:

cp apps/web/.env.example apps/web/.env.local

Update the following variables:

# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=http://localhost:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here

# Application
NEXT_PUBLIC_SITE_URL=http://localhost:3000

Step 4: Start Supabase

Start your local Supabase instance:

pnpm supabase:web:start

This will:

• Start PostgreSQL database
• Start Supabase Studio (localhost:54323)
• Apply all migrations
• Seed initial data

Step 5: Start Development Server

pnpm dev

Your application will be available at:

• App: http://localhost:3000
• Supabase Studio: http://localhost:54323
• Email Testing: http://localhost:54324

Step 6: Create Your First User

1. Navigate to http://localhost:3000/auth/sign-up
2. Enter your email and password
3. Check http://localhost:54324 for the confirmation email
4. Click the confirmation link
5. You're ready to go!

Next Steps

Now that your app is running:

1. Explore the Dashboard - Check out the main features
2. Review the Code - Familiarize yourself with the structure
3. Read the Docs - Learn about key concepts
4. Build Your Feature - Start customizing

Common Issues

Port Already in Use

If port 3000 is already in use:

# Find and kill the process
lsof -i :3000
kill -9 <PID>

Supabase Won't Start

Try resetting Supabase:

pnpm supabase:web:stop
docker system prune -a  # Clean Docker
pnpm supabase:web:start

Database Connection Error

Ensure Docker is running and restart Supabase:

docker ps  # Check Docker is running
pnpm supabase:web:reset

What's Next?

• Learn about the project structure
• Understand configuration options
• Follow best practices