# Working on GarageStack For coding agents and people alike. GarageStack is a self-hosted dashboard for MG cars: a .NET backend (Api and Worker), a Vue 3 and TypeScript frontend, PostgreSQL, and the SAIC MQTT gateway. ## Where to read first - [`documentation/ARCHITECTURE.md`](documentation/ARCHITECTURE.md): how the parts fit together. - [`documentation/openapi.json`](documentation/openapi.json): every API endpoint, what it takes and answers, and its refusal codes. Quicker than reading the endpoint files. [`documentation/API.md`](documentation/API.md) explains it. - [`.github/CONTRIBUTING.md`](.github/CONTRIBUTING.md): setting up, and the tests. ## Seeing a change working Run demo mode: the whole app on sample data, without a car, a database or a broker. [`documentation/DEMO.md`](documentation/DEMO.md#from-a-script-or-an-ai-agent) says how to start it in the background, sign in from a script, drive the demo car, and what to do when a developer's own demo already runs on the same ports. Do not stop processes you did not start. ## Rules that are settled - **CSS**: plain CSS in `frontend/src/assets/*.css`, built on the custom properties (tokens) defined there. No Bootstrap, no Tailwind, no Sass or other preprocessor. Reuse the existing classes (`btn`, `card`, `text-muted`, ...) before adding new ones. - **No inline styles**: the Content Security Policy forbids them. No `style` attributes and no `