docs.hartle.tech — public-facing engineering docs for HARTLE.TECH (architecture, integration guides, product overviews). https://docs.hartle.tech
Find a file
hartle-tech cfe98706c4
build(docs): commit package-lock.json so npm ci works in the GHA build
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>
2026-05-17 04:44:45 +01:00
.github feat(S01E37): scaffold docs.hartle.tech VitePress site 2026-05-17 04:22:41 +01:00
docs build(docs): commit package-lock.json so npm ci works in the GHA build 2026-05-17 04:44:45 +01:00
.gitignore feat(S01E37): scaffold docs.hartle.tech VitePress site 2026-05-17 04:22:41 +01:00
LICENSE feat(S01E37): scaffold docs.hartle.tech VitePress site 2026-05-17 04:22:41 +01:00
NOTICE feat(S01E37): scaffold docs.hartle.tech VitePress site 2026-05-17 04:22:41 +01:00
README.md feat(S01E37): scaffold docs.hartle.tech VitePress site 2026-05-17 04:22:41 +01:00

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.