development.md

Development

Set up and build the CrossCode monorepo locally.

Prerequisites

• Node.js >= 20
• pnpm >= 9

Setup

# Clone the repo
git clone https://github.com/snhsish/crosscode.git
cd crosscode

# Install dependencies
pnpm install

# Start all apps in development mode
pnpm dev

# Build everything
pnpm build

# Run linter
pnpm lint

Monorepo Structure

crosscode/
├── apps/
│   ├── mobile/          # React Native + Expo (iOS + Android)
│   └── web/             # Website
├── packages/
│   ├── crosscode/       # Companion CLI: `npx crosscode`
│   ├── shared/          # Shared types, constants, QR payload schema, plans
│   └── tunnel-server/   # WebSocket relay service for paid-tier tunnels
└── README.md

Developing the CLI

cd packages/crosscode
pnpm dev          # Watch mode
pnpm build        # Build for production

Developing the Mobile App

cd apps/mobile
pnpm start        # Start Expo dev server
pnpm android      # Run on Android
pnpm ios          # Run on iOS

Tech Stack

Layer	Choice
Mobile	React Native + Expo
Navigation	Expo Router
State	Zustand
Styling	NativeWind (Tailwind)
Companion CLI	Node.js
Web	Next.js
Database	PostgreSQL + Drizzle
Payments	Dodo Payments
Tunnel	Cloudflare Tunnel / ngrok / self-hosted WS relay
Monorepo	pnpm workspaces + Turborepo

Contributing

See CONTRIBUTING.md for branch naming, commit conventions, and the PR workflow.