Clone & Deploy Guide

This guide will walk you through the process of cloning the Freelance Flow repository and deploying it to your own environment.

Prerequisites

Node.js

Version 18 or higher

npm or yarn

Package manager

Git

Version control system

💡 Pro Tip: Use AI-Powered IDEs

Modern AI agents like Antigravity or IDEs like Cursor, Windsurf, (VS Code) often offer free tiers for their agentic coding features. These agents can automatically execute terminal commands, install dependencies, and configure environment variables for you, making the setup process significantly faster and error-free.

Installation Process

1Clone the Repository

Open your terminal and run the following command to clone the repository:

bash
git clone https://github.com/Manh-Huynh-PP/Freelance-Flow.git
cd Freelance-Flow

2Install Dependencies

Install the project dependencies using npm:

bash
npm install

3Get Supabase Keys

Create a new project at supabase.com
Go to Project Settings > API.
Copy Project URL, anon public key, and service_role key.

bash
# No command needed, copying keys

4Get Gemini API Key

Go to Google AI Studio
Create an API Key.
Copy the key for GOOGLE_GENAI_API_KEY.

bash
# No command needed, copying keys

5Configure Environment Variables

Create a .env.local file in the root directory and add the necessary environment variables. You can reference .env.example if provided.

bash
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_supabase_service_role_key
GOOGLE_GENAI_API_KEY=your_gemini_api_key
NEXTAUTH_SECRET=your_secret_string

6Run Development Server

Start the local development server:

bash
npm run dev

7Build for Production

To build the application for production, run:

bash
npm run build

Deployment

Vercel (Recommended)

You can deploy this application to any platform that supports Next.js, such as Vercel, Netlify, or Docker.

Push your code to a GitHub repository.
Import the project into Vercel.
Add your environment variables.
Click Deploy.