Developer Onboarding

# Clone and install
git clone <repository-url>
cd platform
pnpm install

# Start databases
docker compose up -d

# Run migrations
pnpm db migrate

# Start development
pnpm dev

/
├── apps/
│   ├── web/                 # Main Next.js 16 application
│   └── storybook/           # Component development environment
├── packages/
│   ├── core/                # Shared business logic (Clean Architecture)
│   ├── luz/                 # UI component library
│   └── typescript-config/   # Shared TypeScript configuration
└── turbo.json               # Turbo task configuration

apps/web
├── @repo/core      (use cases, repositories, types)
└── @repo/luz       (UI components)

packages/luz        (standalone)
packages/core       (standalone)

// Core package (business logic)
import {
  CreateTransaction,           // Use case
  OrganisationRepository,      // Repository
  NotFoundError,               // Domain error
} from '@repo/core';

// Luz package (UI components)
import {
  LayoutContainer,
  Stack,
  DataBlock,
  BigTabs,
} from '@repo/luz';

// Server actions
import { createServerAction } from 'zsa';
import { useServerAction } from 'zsa-react';