Frontend

Structure

Frontend layout

Path

Description

app/

Next.js App Router pages, routes, and API endpoints.

components/

Reusable UI blocks and business components.

lib/

API clients, authentication helpers, and shared utilities.

store/

Global state management with Zustand.

Auth

  • NextAuth manages the session.

  • Keycloak is the primary identity provider.

Useful Commands

npm run dev
npm run build
npm run test

Quality

  • Add tests for critical components and helpers.

  • Verify environment variables before CI/CD builds.

Note

Prefer incremental component tests for high-risk flows (auth, compute wizard, and result visualizations).