CoinCrew AI Monorepo

A modern monorepo for the CoinCrew AI platform with pnpm workspaces and Turborepo.

Structure

├── apps/
│   ├── client/      # Vite + React + TypeScript frontend
│   ├── api/         # Express API server
│   ├── mcp/         # MCP (Model Context Protocol) server
│   └── supabase/    # Supabase configuration and migrations
├── packages/
│   ├── ui/          # Shared React components
│   ├── config/      # Shared configuration files
│   └── utils/       # Shared utility functions

Prerequisites

• Node.js 18+
• pnpm 9+
• Docker (optional, for local development)

Getting Started

Install dependencies

pnpm install

Development

Run all apps in development mode:

pnpm dev

Run specific apps:

pnpm dev:client  # Run client only
pnpm dev:api     # Run API only
pnpm dev:mcp     # Run MCP server only

Build

Build all apps:

pnpm build

Build specific apps:

pnpm build:client
pnpm build:api
pnpm build:mcp

Docker Development

Start all services with Docker:

docker-compose up

Deployment

Each app can be deployed independently to Digital Ocean App Platform:

1. Client: Deploy from apps/client with build command pnpm build --filter=client
2. API: Deploy from apps/api with build command pnpm build --filter=api
3. MCP: Deploy from apps/mcp with build command pnpm build --filter=mcp

Available Scripts

• pnpm dev - Start all apps (Client + API + MCP) with automatic port cleanup
• pnpm build - Build all apps
• pnpm test - Run tests
• pnpm lint - Lint all packages
• pnpm format - Format code with Prettier
• pnpm clean - Clean all build artifacts and node_modules
• pnpm kill:ports - Free up ports 3000, 3001, 3002

Individual App Scripts

• pnpm dev:client - Run client only (port 3000)
• pnpm dev:api - Run API only (port 3001)
• pnpm dev:mcp - Run MCP only (port 3002)

Services

Main Apps (Always Same Ports)

• Client: http://localhost:3000 (Vite + React + TypeScript)
• API: http://localhost:3001 (Express + TypeScript)
• MCP: http://localhost:3002 (Express + TypeScript with MCP endpoints)

Supabase Stack (Docker-based)

To start Supabase services:

cd apps/supabase
pnpm start

• API: http://127.0.0.1:54321
• Studio: http://127.0.0.1:54323
• Database: postgresql://postgres:postgres@127.0.0.1:54322/postgres
• Edge Functions: http://127.0.0.1:54321/functions/v1/[function-name]

Environment Variables

Client (apps/client/.env.local)

VITE_API_URL=http://localhost:3001
VITE_SUPABASE_URL=http://127.0.0.1:54321
VITE_SUPABASE_ANON_KEY=your-anon-key-here

API (apps/api/.env.local)

PORT=3001
DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres
SUPABASE_URL=http://127.0.0.1:54321
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key-here

MCP (apps/mcp/.env.local)

PORT=3002
# MCP configuration

Supabase (apps/supabase/.env.local)

# Auto-populated when running supabase start
SUPABASE_URL=http://127.0.0.1:54321
DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/postgres