Installation

Prerequisites

Ensure you have the following installed:

Tool	Version	Purpose
Node.js	>= 18.x	Runtime
npm	>= 9.x	Package manager
Git	Latest	Version control

Optional but recommended:

Tool	Purpose
Supabase CLI	Local database development and migrations
N8N	Local workflow automation testing

Quick Start

1. Clone the Repository

git clone https://github.com/Slazerslaze/pip-ai.git
cd pip-ai

2. Install Dependencies

npm install

3. Configure Environment

Copy the example environment file and fill in your credentials:

cp .env.example .env

See the Environment Variables guide for details on each variable.

4. Start Development Server

npm run dev

The application will be available at http://localhost:3000.

5. Dev Auth Bypass (Optional)

For local development without configuring Supabase Auth, enable the dev bypass:

NUXT_PUBLIC_DEV_AUTH_BYPASS=true

This skips authentication checks and uses a mock user session.

Supabase Setup

Cloud (Recommended for Getting Started)

1. Create a project at supabase.com
2. Copy the Project URL and anon key to your .env
3. Run migrations using the Supabase SQL editor (see Database Migrations)

Local (Advanced)

# Install Supabase CLI
npm install -g supabase

# Start local Supabase instance
supabase start

# Apply migrations
supabase db push

Verify Installation

After starting the dev server:

1. Open http://localhost:3000
2. You should see the PIP AI dashboard
3. If using dev auth bypass, you'll be automatically logged in
4. Try creating a test project to verify database connectivity

Troubleshooting

Common Issues

Port 3000 in use:

npx nuxi dev --port 3001

Module resolution errors after install:

npm run postinstall  # Runs nuxt prepare

Supabase connection failures:

• Verify your SUPABASE_URL and SUPABASE_KEY in .env
• Check that the Supabase project is active and not paused
• Ensure RLS policies are applied (see Database docs)