Amal-David/pagecast

Pagecast

Preview local HTML reports, Markdown docs, and static mini apps, then publish them to shareable Cloudflare Pages URLs from the terminal or your coding agent.

Live app: https://pagecasthq.pages.dev/

About

Pagecast is a local-first publishing tool for agent-generated reports and small static web projects. It gives you a local admin UI for previewing files, managing published versions, renaming links, re-syncing updates, and revoking old URLs. For automation, it exposes headless pagecast publish commands, a small Cloudflare Pages CLI abstraction, and Codex / Claude agent skills.

Good fits:

• HTML reports, dashboards, coverage output, Playwright or Lighthouse reports.
• Markdown plans, proposals, release notes, docs, and summaries.
• Static mini apps from build folders such as dist, build, out, or public.
• Coding-agent workflows that should ask before publishing a finished artifact.

Not a fit:

• Private drafts or scratch notes.
• Server-rendered apps that need a running backend.
• Python/Ruby/Node services unless they first export static assets.

Requirements

• Node.js 20 or newer.
• npx for one-command use.
• A Cloudflare account for public publishing.
• pnpm only when rebuilding the web UI from web/.

The root CLI/server has no runtime npm dependencies. The React admin UI is built from web/ into public/ and is already included in the package.

Install And Run

Use Pagecast without installing it globally:

npx pagecast

This starts the local app and opens the admin UI.

• Admin UI: http://127.0.0.1:4173
• Local published-page server: http://127.0.0.1:4174
• Local data/config: .pagecast/ in your current working directory

Use the admin UI on 4173 for normal work. The 4174 server is intentionally separate: it serves local published-page routes such as /p/<slug>/ so Pagecast can preview the same URL shape it deploys to Cloudflare Pages. Its root path is not an app and returns 404; use `/heal