Development

Prerequisites

• Bun (primary runtime)
• Node.js 18+
• Git

Setup

# Clone the repository
git clone https://github.com/zahinafsar/coodeen.git
cd coodeen

# Install dependencies
bun install

Development Servers

# Run both API and web in parallel
bun run dev

# Run individually
bun run dev:server    # API on :3099
bun run dev:web       # Vite on :5173

During development, the Vite dev server runs on port 5173 with hot module replacement. The API server runs on port 3099. The Vite config proxies API requests to the server automatically.

Type Checking

bun run typecheck

Building

# Build both server and web
bun run build

# Build for npm distribution
bun run build:npm

# Dry run npm publish
bun run publish:npm:dry

The build:npm command:

1. Builds the React frontend
2. Generates the Prisma client
3. Builds the CLI package with tsup
4. Copies Prisma schema and static assets into the CLI dist

Publishing

bun run publish:npm

This builds everything and publishes the coodeen package to npm.

Project Structure