Skip to content

README.md

Latest commit

 

History

History
67 lines (47 loc) · 1.87 KB

README.md

File metadata and controls

67 lines (47 loc) · 1.87 KB

PlaceOS Backoffice

PROD UAT CodeFactor

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