New: Video Watermark Remover Try it now →

Namaste Tools Logo - Light Theme
Get started
Documentation

Quick Start

Get your application running in minutes with this quick start guide.

Page type
Product documentation
Best for
Setup, workflow, and implementation details
Next action
Copy, export, or continue deeper into the doc tree

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?