Developer Usage

Development Workflow

Start Development

# Install dependencies
bun install

# Configure environment variables
cp apps/website/.env.example apps/website/.env
# Edit .env with Supabase, Stripe, and Cloudflare credentials

# Run database migrations
moon run apps-website:db-migrate

# Start all workspace dev servers
bun run dev

Run Specific Workspace

# Website (port 5173)
moon run apps-website:dev

# Docs (port 5173)
moon run apps-docs:dev

# Claude App
moon run integrations-claude-app:dev

# ChatGPT App
moon run integrations-chatgpt-app:dev

# LINE LIFF
moon run integrations-line-liff:dev

# Apple Business Connect
moon run integrations-apple-business-connect:build

# Google Maps Booking
moon run integrations-google-maps-booking:build

# Health CLI
bun run health

Build

# Build all workspaces
bun run build

# Build website only
moon run apps-website:build

# Build SPA for mobile
moon run apps-website:build-spa

# Build docs
moon run apps-docs:build

Database

# Generate migration from schema changes
moon run apps-website:db-generate

# Run migrations
moon run apps-website:db-migrate

# Push schema directly (dev only)
moon run apps-website:db-push

# Open Drizzle Studio
moon run apps-website:db-studio

# Seed database
moon run apps-website:db-seed

# Run SQL migrations
moon run apps-website:db-sql-migrate

Testing

# Run unit tests in all workspaces
bun run test

# Run unit tests (no watch)
bun run test:run

# Run with coverage
bun run test:coverage

# Run E2E tests (Playwright)
bun run test:e2e

# Run E2E in UI mode
bun run test:e2e:ui

# View E2E report
bun run test:e2e:report

# Run website only
moon run apps-website:test
moon run apps-website:test-e2e

Code Quality

# Lint all workspaces
bun run lint

# Lint and auto-fix
bun run lint:fix

# Format all files
bun run format

# Type check all workspaces
bun run typecheck

# Run all checks (lint + typecheck + scan)
bun run check

# Run verify (typecheck + test + e2e)
bun run verify

Code Analysis

# ast-grep structural analysis
bun run scan

# Detect unused files/exports/deps
bun run knip

# Check security vulnerabilities
bun run security

# Analyze dependencies
bun run deps:analyze

Mobile App

# Sync SPA build with native project
moon run apps-mobile:cap-sync

# Open Xcode
moon run apps-mobile:cap-open-ios

# Open Android Studio
moon run apps-mobile:cap-open-android

# Run on iOS
moon run apps-mobile:cap-run-ios

# Run on Android
moon run apps-mobile:cap-run-android

Dependencies

# Update all dependencies to latest
bun run deps:update

# Install new package in specific workspace
bun --filter website add <package-name>

# Install dev dependency
bun --filter website add -d <package-name>

Git Hooks

Pre-commit hooks (Lefthook):

• Biome lint on staged files
• Biome format on staged files

Pre-push hooks:

• typecheck across entire project
• test across entire project

Never bypass Git hooks

Fix the root cause instead of bypassing hooks

---

previous: Initial Setupnext: Guides