Quick start

How PropFlow Docs works

Two kinds of pages, one gated home, and a single command to publish. This page is itself an artifact — added with the same command it describes.

The two kinds of pages

ADRs

Architecture decisions. The markdown lives in propflowai/docs/adr and stays the source of truth — this site just renders it, so the two can't drift.

Artifacts

Self-contained HTML — reports, dashboards, memos, explainers like this one. Interactive and free-form, kept in the docs repo so they're versioned too.

Publishing an artifact

Drop any standalone .html file in with one command. No PR, no review, no CI gate — it builds and ships straight to the site.

# add a new artifact and publish it
docs add ~/Downloads/my-report.html

# re-render everything (ADRs + artifacts) and publish
docs publish

# see what's live · remove one
docs list
docs rm my-report

Adding an ADR

Nothing to do here at all — write the markdown in propflowai/docs/adr. It shows up on its own within half an hour, or run docs publish for it now.

write / drop file build Cloudflare Pages live in ~45s
Everything here sits behind Cloudflare Access — only @propflowai.co emails can reach it. Share the link freely inside the team; it's a login wall to everyone else.
PropFlow Docs