docs.hartle.tech — public-facing engineering docs for HARTLE.TECH (architecture, integration guides, product overviews).
https://docs.hartle.tech
The initial scaffold landed without a lockfile; the Dockerfile uses `npm ci --no-audit --no-fund` which insists on package-lock.json (otherwise it errors with "The 'npm ci' command can only install with an existing package-lock.json"). Generated locally with `npm install` against `vitepress ^1.6.4`; build verified clean. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .github | ||
| docs | ||
| .gitignore | ||
| LICENSE | ||
| NOTICE | ||
| README.md | ||
docs.hartle.tech
Public-facing engineering documentation for HARTLE.TECH.
Architecture overviews, integration guides, public APIs, contribution notes. The internal counterpart (runbooks, incident write-ups, decisions) lives on the tailnet at wiki.hartle.tech.
Local dev
cd docs
npm ci
npm run dev # vitepress dev server on :5180
npm run build # static build → docs/external/.vitepress/dist
Layout
docs/
├── external/ # VitePress site → docs.hartle.tech
│ ├── .vitepress/
│ ├── index.md
│ ├── guides/
│ ├── architecture/
│ └── products/
├── Dockerfile # multi-stage: node:20 build → caddy:2-alpine runtime
└── Caddyfile # in-pod, binds :8080
GHA on develop push builds the image and publishes to GHCR; Flux reconciles the cluster manifest in hartle.tech-terraform/k8s/workloads/product-docs/docs-hartle-tech/.
License
Apache-2.0 — see LICENSE.