express-route-map

name	express-route-map
description	Describes the Express router dependency-injection pattern used in ndb2: a Route function receives a Router, registers handlers, and mapRoutes aggregates Route modules under path prefixes. Covers both app/src/api/v2 and app/src/web. Use when adding or reorganizing HTTP routes, mounting route modules, or mirroring the v2 route style in the HTML app.

Express route map pattern (ndb2)

Core idea

• Route: (router: Router) => void — the route module does not create its own Router. It receives a router and calls router.get, router.post, etc. Paths are relative to the mount prefix parent index files choose.
• mapRoutes: takes an array of Route functions, creates one express.Router(), runs each route on it, returns that router for parent.use(prefix, mappedRouter).

This keeps registration colocated per feature file while aggregation stays in a small index.

Shared helper

• app/src/shared/routerMap.ts exports Route and mapRoutes. Import with the path alias: import { Route, mapRoutes } from "@shared/routerMap" (see app/tsconfig.json paths and docs/frontend/project-structure.md).

v2 JSON API

• Mount: app/src/api/v2/index.ts — import { mapRoutes } from "@shared/routerMap"; , same for with a longer array.