Frontend
========

Structure
---------

.. list-table:: Frontend layout
   :header-rows: 1
   :class: feature-table

   * - 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).