Quick Start

Get CommonPlace running on your local machine.

Prerequisites

• Node.js 18+
• npm or yarn
• Git
• A Supabase account (free tier works)

1. Clone the Repository

git clone [repository-url]
cd friends-network

2. Install Dependencies

npm install

3. Environment Setup

Copy the example environment file:

cp .env.example .env

Edit .env with your Supabase credentials:

VITE_SUPABASE_URL=your-project-url
VITE_SUPABASE_ANON_KEY=your-anon-key

See Environment Variables for all available options.

4. Database Setup

If setting up a new Supabase project:

1. Create a new project at supabase.com
2. Run the schema migrations (see Database Setup)
3. Enable required auth providers

5. Start Development Server

npm run dev

The app will be available at http://localhost:5173

6. Verify It's Working

• Home page loads
• Can create an account
• Can log in
• Feed page loads

Next Steps

• Read the Project Structure overview
• Understand the Key Concepts
• Review the Invariants that guide all decisions

Common Issues

Problem	Solution
"Supabase connection failed"	Check your .env credentials
"Module not found"	Run npm install again
"Port already in use"	Kill the process on port 5173 or use --port flag

See Troubleshooting for more.