Skip to content

@zelavis/ui

@zelavis/ui is the dashboard SPA mounted by the Zelavis runtime.

It uses React Router v7 in SPA mode and is served under the configured dashboard root path, /zelavis by default. The dashboard opens to the Projects overview; project-local pages live under /zelavis/projects/:projectId/*.

  • dashboard shell and slide-based sidebar navigation
  • Projects overview and project-local dashboard routes
  • global management areas such as Marketplace, Domains, Resources, Server, and Security
  • mobile-slot-ready route surfaces for future mobile browser and Capacitor shells
  • service-owned dashboard navigation rendered from runtime menu metadata

The dashboard is a client of Zelavis endpoints. Privileged behavior should live behind runtime capabilities and versioned endpoints, not only inside React route modules or component callbacks.

Use the mounted development flow from the repository root:

Terminal window
pnpm run ui:dev

That starts the runtime and UI dev server together so /zelavis behaves like the mounted dashboard.

For package-only checks:

Terminal window
pnpm --filter @zelavis/ui typecheck
pnpm --filter @zelavis/ui build