Monorepo layout

The repository is a pnpm workspace. The pnpm-workspace.yaml globs in packages/*, the individual apps, tools/releases, home-assistant/cards, and this docs site.

Apps

Path	Package name	Role
apps/api	server	Express 5 deployment / registry API
apps/edge-agent	@signapps/edge-agent	On-device agent
apps/web-admin	frontend	Admin dashboard (web)
apps/dashboard/react	@signapps/dashboard-react	Dashboard UI
home-assistant/cards	home-assistant	Home Assistant dashboard cards

Packages

Path	Package name	Role
packages/api-client	@signapps/api-client	Generated RTK Query API client
packages/types	@signapps/types	Zod DTOs / shared types
packages/ui	@signapps/ui	Tamagui UI kit
packages/lib	@signapps/lib	Shared library code
packages/ha-tooling	@signapps/ha-tooling	Module / customer CLI
packages/artifact-storage	@signapps/artifact-storage	Artifact storage
packages/icons	@signapps/icons	Icon set
packages/dashboard	@signapps/dashboard	Dashboard configuration
packages/next-config	@signapps/next-config	Shared Next.js config

Tooling & processes

Path	Role
tools/releases	Release preparation / publishing
deploy/	Deployment scripts (edge agent, docker, bootstrap)
scripts/	Developer / build helper scripts
docs/	This documentation site (@signapps/docs)