Web
Dashboard

Nurse dashboard for the Ella Memory platform — pnpm monorepo, HIPAA de-identification, WorkOS auth, and Vercel pilot deploy at ellamemory.com.

ambientintel/ambient-ella-web
Build pipeline
Setup
Build
Integrate
Ship
Goal
Runtime
Next.js 16
React 19 · App Router · Turbopack
Auth
WorkOS
Email/password · HttpOnly cookie
Workspace
pnpm 9
Monorepo · apps/web + packages/ui
Pilot
12 Rooms
MOH 301–312 · fall detection
Compliance
HIPAA §164.514
Safe Harbor de-identification
STEP 01
Setup⏱ ~30 min
Complete

Monorepo Bootstrap

pnpm 9 workspace with two packages: apps/web (Next.js 16 nurse dashboard) and packages/ui (shared design tokens and components). Node 20 required.

$ clone repo
git clone https://github.com/ambientintel/ambient-ella-web
cd ambient-ella-web
corepack enable
pnpm install
$ verify workspace packages
pnpm list -r --depth=0
# Should show:
#   ambient-ella-web (root)
#   @ambient/web   → apps/web
#   @ambient/ui    → packages/ui
Artifacts
▸
pnpm-workspace.yaml
Declares workspace packages: apps/* and packages/*.
▸
apps/web/package.json
Next.js 16 app. Depends on @ambient/ui via workspace:*.
▸
packages/ui/package.json
Shared design tokens, CSS variables, and base components.
$ start dev server (Turbopack)
pnpm --filter @ambient/web dev
# Starts at http://localhost:3000
# Uses Next.js Turbopack for fast HMR
$ build ui package first if types fail
pnpm --filter @ambient/ui build
pnpm --filter @ambient/web dev
NOTE

The root package.json dev script runs the web app only. To rebuild the ui package on changes, run pnpm --filter @ambient/ui build --watch in a second terminal.

apps/web/tsconfig.json enables strict, noUncheckedIndexedAccess, and exactOptionalPropertyTypes. All array index access returns T | undefined — guard all index reads before use.

Artifacts
▸
apps/web/tsconfig.json
Strict TypeScript config. noUncheckedIndexedAccess will surface bugs hidden by loose array access.
Deploy Checklist
Complete100%
Open Decisions
1Keyring UX: per-shift AES-GCM unlock vs persistent browser credential storage (WebAuthn PRF) — security vs usability tradeoff for pilot nurses
2Push reliability: Web Push + in-page audio (desktop browsers) vs native mobile push via ambient-device-mobile (APNs/FCM) — decide primary alert channel for pilot nurses
3Analytics persistence: client-side session state vs server-side aggregation for shift summary and weekly trend reports
4Floor map: static MOH 301–312 room layout vs dynamic room configuration loaded from ambient-platform-infra room registry