fynl

Prerequisites

• Node.js 22 (see .node-version)

• pnpm 10 — enabled via corepack:

  corepack enable

Setup

# Install dependencies
pnpm install

Git hooks are set up automatically via the prepare script.

Development

# Start all apps in dev mode
pnpm run dev

# Start a specific app
pnpm run dev --filter @fynl/shell

# Build all packages and apps
pnpm run build

# Build a specific app
pnpm run build --filter @fynl/shell

# Lint everything
pnpm run lint

# Run tests
pnpm run test

Use --filter <package-name> to target a single app or package. The package name is the name field from its package.json (e.g. @fynl/shell, @fynl/api).

Project Structure

apps/
  api/          — NestJS modular monolith
  shell/        — React Vite host app (Module Federation)
  <remote>/     — MF remote apps

packages/
  contracts/    — ts-rest API contracts + Zod schemas
  db/           — Drizzle ORM schema, migrations, DB client
  ui/           — Shared React component library (shadcn/ui)
  tsconfig/     — Shared TypeScript configs
  i18n/         — Common translations (Paraglide JS)
  eslint-config/— Project ESLint config