Numa Developer Documentation
Welcome to the Numa monorepo developer guide. This site covers everything you need to understand, contribute to, and extend the Numa platform.
What is Numa?
Numa is a Turborepo-powered monorepo containing the Numa Logistics platform — independently deployable Next.js apps sharing common packages for configuration, UI, API integration, authentication, and internationalization.
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router, Turbopack) |
| Language | TypeScript 5 (strict mode) |
| Styling | Tailwind CSS v4 (CSS-first config) |
| Components | shadcn/ui + Radix UI |
| Data Fetching | TanStack Query v5 |
| Forms | TanStack Form |
| i18n | next-intl v4 |
| Auth | JWT cookies + OIDC/SSO |
| Monorepo | Turborepo + pnpm workspaces |
| Linting | ESLint 9 + Prettier |
Quick Start
# Install dependencies
pnpm install
# Copy env file
cp .env.example .env.local
# Run all apps
pnpm dev
# Run a single app
pnpm turbo run dev --filter=@numa/energyProject Map
| Directory | Purpose |
|---|---|
apps/ | Next.js applications (energy, gateway, etc.) |
packages/ | Shared libraries consumed by apps |
tooling/ | Shared ESLint, Prettier, TypeScript configs |
scripts/ | Monorepo utility scripts |
docs/ | Markdown documentation source files |
Start with Getting Started to set up your development environment, or jump to Architecture for a high-level overview.
Last updated on