Skip to content

Frontend

Overview

The Alan Home frontend consists of two packages:

  • eu-home-app: React SPA (the UI)
  • eu-home-server: Node server that serves the app and proxies API requests

Both live in the monorepo under frontend/apps/.

Tech stack

  • eu-home-app: React, Murray ⧉ design system, React Router, TanStack Query.
  • eu-home-server: @alaneu/web-server ⧉ (Hono). Serves the built app and handles server-side routing. It's very minimal as Alan Home has no SSR.

Repo paths

Package Path
App frontend/apps/eu-home-app/
Server frontend/apps/eu-home-server/

Running locally

From the repo root (with frontend deps installed):

frontend yarn workspace eu-home-server dev

Then open http://localhost:8885 ⧉.

The server builds and serves eu-home-app; The backend eu_tools has to run separately on you should refer to it's own README.

Main areas

The app exposes feature areas backed by eu_tools APIs, including:

  • Home – dashboard and quick links
  • Reviews – peer reviews, cycles, self-reviews (see Reviews)
  • On-call – on-call groups and schedules (see On-Call Groups)
  • Team – communities, crews, areas, units
  • Tools – summary, audio, spacefinder, media generator, etc. A general bucket for most other small features.
  • Equity – equity dashboard and simulator
  • User profile – alaner profile, roles, subscriptions

See also