Quick Start

Prerequisites

• Node.js ≥ 20
• pnpm 10.11.0

Installation

1. Clone the repository

   git clone https://github.com/soundbluemusic/public-monorepo.git
   cd public-monorepo

2. Install dependencies

   pnpm install

3. Run an app

   Context

   pnpm dev:context
   # → http://localhost:3003

   Permissive

   pnpm dev:permissive
   # → http://localhost:3004

   Roots

   pnpm dev:roots
   # → http://localhost:3005

Project Structure

public-monorepo/
├── apps/                → 3 applications
│   ├── context/         → Korean dictionary (SSR + D1)
│   ├── permissive/      → Web dev resources (SSR)
│   └── roots/           → Math documentation (SSR)
├── packages/            → 10 shared packages
│   ├── core/            → [L0] validation, utils, types
│   ├── config/          → [L0] Vite, Tailwind configs
│   ├── data/            → [L1] Zod schemas, loaders
│   └── ...              → More packages
└── data/                → JSON data (SSoT)

Available Commands

Command	Description
pnpm dev:context	Run Context app
pnpm dev:permissive	Run Permissive app
pnpm dev:roots	Run Roots app
pnpm build	Build all apps
pnpm lint	Check code with Biome
pnpm typecheck	TypeScript type check
pnpm test	Run unit tests

Next Steps

• Learn about the Architecture
• Explore the Apps
• Read the Contributing Guidelines