monorepo-commands

Monorepo Commands

Reference for all npm scripts available in this full-stack monorepo project.

Project Structure

This monorepo contains three main packages:

• API Server: FastAPI (Python)
• Mobile App: React Native (TypeScript)
• Web App: React + Vite (TypeScript)

Command Categories

Global Commands

Commands that run across the entire monorepo:

• npm run test - Run all tests (mobile Jest + API pytest)
• npm run typecheck - Type check all packages (mobile, web, API)
• npm run lint - Lint all packages (mobile, web, API)

API Server Commands

FastAPI backend commands:

• npm run api:test - Run pytest tests
• npm run api:typecheck - Run mypy type checking
• npm run api:lint - Run Ruff linter

Mobile App Commands

React Native commands:

• npm run mobile:ios - Build and run on iOS simulator (requires Xcode)
• npm run mobile:android - Build and run on Android emulator (requires Android SDK)
• npm run mobile:test - Run Jest tests
• npm run mobile:typecheck - Run TypeScript type checking
• npm run mobile:lint - Run ESLint

Web App Commands

React + Vite commands:

• npm run web:dev - Start development server with HMR (http://localhost:5173)
• npm run web:build - Build for production (outputs to web-app/dist)

Detailed Command Reference

For complete details on each command including descriptions and usage notes, see:

• references/commands-reference.md

Usage Patterns

When working with this monorepo:

1. Starting development: Use npm run web:dev for web or npm run mobile:ios/mobile:android for mobile
2. Before committing: Run npm run lint and npm run typecheck to catch issues
3. Running tests: Use npm run test for all tests or specific commands for targeted testing
4. Building for production: Use npm run web:build for web deployment

Technology Stack

• Backend: Python, FastAPI, pytest, mypy, Ruff
• Mobile: React Native, TypeScript, Jest, ESLint
• Web: React, Vite, TypeScript, ESLint
• Monorepo: npm workspaces