PlaceOS Backoffice

An Angular 20 admin UI for managing PlaceOS building automation systems. Built with standalone components, zoneless change detection with signals, and PlaceOS backend API integration.

Tech Stack

• Framework: Angular 20 with standalone components and signals
• Build: Nx 22 + Vite 7 + @analogjs/vite-plugin-angular
• Testing: Vitest (unit) + Playwright (E2E)
• Styling: Tailwind CSS 4
• Backend: @placeos/ts-client for PlaceOS REST API integration
• Real-time: MQTT for dashboard updates

Setup

1. Install Bun
2. Run bun install in the root folder

Development

bun run start               # Dev server at localhost:4200

The dev server proxies requests to the configured PlaceOS backend (see config/proxy.conf.js).

Build

bun run build               # Production build

Production builds output to dist/backoffice/browser.

Testing

bun run test                # Unit tests (Vitest)
bun run test:ci             # Unit tests in CI mode
bunx playwright install --with-deps
bun run e2e                 # E2E tests (Playwright)

Linting

bun run lint                # ESLint

Project Structure

src/app/
├── common/           # Shared utilities and services
├── ui/               # Shared UI components and guards
├── overlays/         # Modal/dialog components
└── [features]/       # Feature modules (systems, domains, drivers,
                      # modules, repositories, triggers, users, zones, etc.)

License

MIT