Installation Guide

Complete guide to installing and running your generated ArchitectGBT project.

System Requirements

Node.js 18.17 or later
npm, yarn, or pnpm
Git for version control
A code editor (VS Code recommended)

Step 1: Extract Your Project

After downloading from ArchitectGBT:

# Unzip the downloaded file
unzip my-project.zip
cd my-project

Step 2: Install Dependencies

npm install

This installs:

Next.js 16
React 19
TypeScript 5
Tailwind CSS 4
Clerk (authentication)
Supabase (database)
And all other dependencies

Step 3: Environment Setup

Create Environment File

cp .env.example .env.local

Configure API Keys

Open .env.local and add your keys:

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
CLERK_SECRET_KEY=sk_test_...

# Supabase Database
NEXT_PUBLIC_SUPABASE_URL=https://xxx.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=eyJ...
SUPABASE_SERVICE_ROLE_KEY=eyJ...

# AI API (choose one)
ANTHROPIC_API_KEY=sk-ant-...
# or OPENAI_API_KEY=sk-...
# or GOOGLE_API_KEY=...

# Stripe (if using payments)
STRIPE_SECRET_KEY=sk_test_...
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...

Step 4: Database Setup

Using Supabase

Go to Supabase Dashboard
Create a new project
Run migrations from supabase/migrations/ folder
Execute SQL files in order (0001, 0002, etc.)

Or use Supabase CLI:

# Install Supabase CLI
npm install -g supabase

# Link your project
supabase link --project-ref your-project-ref

# Push migrations
supabase db push

Step 5: Run Development Server

npm run dev

Your app runs at:

Local: http://localhost:3000
Network: http://192.168.x.x:3000

Verify Installation

Check that everything works:

[ ] App loads at localhost:3000
[ ] No console errors
[ ] Authentication works (sign up/sign in)
[ ] Database connection successful

Test Authentication

Go to http://localhost:3000
Click Sign In or Sign Up
Clerk should show the auth modal
Create test account
You should be redirected to /dashboard

Test Database

Check browser console for Supabase errors. If connected successfully, you won't see any red errors.

Common Issues

Port Already in Use

# Use different port
npm run dev -- -p 3001

# Or kill process (Windows)
netstat -ano | findstr :3000
taskkill /PID <PID> /F

# Or kill process (Mac/Linux)
lsof -ti:3000 | xargs kill -9

Module Not Found

rm -rf node_modules package-lock.json
npm install

Clerk Auth Not Showing

Check both Clerk keys are in .env.local
No extra spaces in keys
Restart dev server after adding keys
Verify keys are from same Clerk project

Supabase Connection Failed

Project not paused (free tier auto-pauses after inactivity)
URL format: https://xxx.supabase.co (no trailing slash)
Using correct project keys (not from different project)

TypeScript Errors

npm run build

Frequently Asked Questions

Do I need to pay for anything?

ArchitectGBT:

✅ Free: 3 recommendations/month
Pro (coming soon): Unlimited

Third-party services:

✅ Clerk: Free (10K monthly users)
✅ Supabase: Free (500MB database)
✅ Vercel: Free (hobby projects)
💳 AI APIs: You pay usage (~$0.01-0.10 per 1K tokens)

Start completely free!

Can I use different services?

Yes! You can swap:

Database: PostgreSQL, MongoDB, Firebase
Auth: NextAuth, Auth0, Firebase
Hosting: Railway, Render, AWS
AI: Any model via API

What AI models work?

OpenAI: GPT-4, GPT-3.5 Turbo
Anthropic: Claude 3.5, Opus, Sonnet
Google: Gemini 2.0, 1.5 Pro/Flash

Add the API key to .env.local

How do I switch models later?

In your API route (/api/chat):

// Change this:
const model = "gpt-4-turbo";

// To this:
const model = "claude-3-5-sonnet";

And add the corresponding API key.

Can I modify the code?

Absolutely! It's 100% yours:

✅ Full source code access
✅ No vendor lock-in
✅ Customize everything
✅ No attribution required

Build for Production

Test production build locally:

npm run build
npm start

Project Structure

my-project/
├── src/
│   ├── app/              # App Router pages
│   ├── components/       # React components
│   ├── lib/             # Utilities and APIs
│   └── types/           # TypeScript types
├── public/              # Static assets
├── supabase/           # Database migrations
├── package.json        # Dependencies
└── next.config.ts      # Next.js config

Next Steps

Getting Help

If you encounter issues:

Check the error messages in terminal
Verify all environment variables are set
Ensure Node.js version is 18+
Report issues on GitHub
Email support@architectgbt.com

Quick Links