Skip to main content

​
Prerequisites

  • Node.js 18+
  • Docker and Docker Compose (for PostgreSQL)
  • npm or pnpm

​
1. Clone and Install

git clone https://github.com/your-org/geo-app.git
cd geo-app

# Backend
cd backend && npm install && cd ..

# Frontend
cd frontend && npm install && cd ..

​
2. Environment Variables

Copy the example env files and fill in your values: 
cp .env.example .env
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
Required for backend:
  • DATABASE_URL — PostgreSQL connection string
  • At least one AI API key: GOOGLE_GEMINI_API_KEY, OPENAI_API_KEY, ANTHROPIC_API_KEY, or PERPLEXITY_API_KEY

​
3. Database

docker-compose up -d postgres
cd backend
npx prisma migrate dev
npx prisma generate

​
4. Seed (Optional)

Create demo data and test accounts: 
cd backend
npm run seed
This creates brands, queries, and test users for each plan. See Test Accounts for credentials.

​
5. Start the App

Terminal 1 — Backend: 
cd backend
npm run dev
Terminal 2 — Frontend: 
cd frontend
npm run dev

​
6. First Steps

  1. Open http://localhost:3000/register and create an account
  2. Add a brand (name, website, industry)
  3. Go to Prompts and create your first query (e.g., “Best [your industry] tools”)
  4. Run the prompt and view results across AI platforms

Next: Setup Details

Learn about environment variables, auth, and production setup.