Prerequisites

Use a recent Node.js runtime that supports Next.js 16 and React 19.

The production server keeps dependencies installed in /srv/apps/azora-app/node_modules.

The project contains a pnpm lockfile, but production validation currently uses npm scripts because pnpm can stop on ignored build-script policy for sharp.

Common commands

Run these commands from /srv/apps/azora-app.

npm run dev
npm run typecheck
npm run check
npm run build
npm run start

First files to read

app/layout.tsx controls the global HTML shell and theme bootstrap script.

app/app/layout.tsx wraps dashboard pages with AppShell.

components/app-shell.tsx controls the dashboard chrome.

lib/navigation.ts controls sidebar sections and search links.

app/globals.css contains the design system and page styling.