Ryan Malloy
c5e72c679b
Astro 6 + Starlight 0.39 documentation site for omni-pca, organised around the Diatáxis framework (Tutorials / How-to / Reference / Explanation), plus a chronological Journey page and Changelog. Theme: muted slate-blue with amber accents. astro-icon + lucide preinstalled. Astro telemetry and Starlight devToolbar both off. Deployment: multi-stage Dockerfile (node:25-alpine builder -> caddy:2-alpine runtime), inner Caddy serves static dist on :80, outer caddy-docker-proxy on the host terminates TLS for hai-omni-pro-ii.warehack.ing.
55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# hai-omni-docs
|
|
|
|
Documentation site for [`omni-pca`](https://github.com/rsp2k/omni-pca) — a
|
|
reverse-engineered Python library and Home Assistant integration for HAI/Leviton
|
|
Omni Pro II home automation panels. Built with Astro + Starlight, organised
|
|
around the Diátaxis framework.
|
|
|
|
Live: <https://hai-omni-pro-ii.warehack.ing>
|
|
|
|
## Local development
|
|
|
|
```sh
|
|
make install # one-time
|
|
make dev # http://localhost:4321 with hot reload
|
|
```
|
|
|
|
## Production build (smoke test)
|
|
|
|
```sh
|
|
make ci # runs `npm run build`, output in ./dist
|
|
```
|
|
|
|
## Deploy via Caddy
|
|
|
|
The container ships its static `dist/` from an inner Caddy on `:80`; the host's
|
|
`caddy-docker-proxy` terminates TLS and routes the configured `DOMAIN` to it via
|
|
the external `caddy` network.
|
|
|
|
```sh
|
|
cp .env.example .env # adjust COMPOSE_PROJECT / DOMAIN as needed
|
|
make build
|
|
make up # then tails logs
|
|
```
|
|
|
|
## Layout
|
|
|
|
```
|
|
src/
|
|
content/docs/
|
|
index.mdx
|
|
start/ # Overview + Quick start
|
|
tutorials/ # Diátaxis: learning-oriented
|
|
how-to/ # Diátaxis: task-oriented
|
|
reference/ # Diátaxis: information-oriented (protocol, file format, API)
|
|
explanation/ # Diátaxis: understanding-oriented (quirks, architecture, bugs)
|
|
journey.md # Chronological retrospective
|
|
changelog.md
|
|
styles/theme.css # Slate-blue + amber accent
|
|
assets/logo.svg
|
|
```
|
|
|
|
## Source project
|
|
|
|
- Library + integration: <https://github.com/rsp2k/omni-pca>
|