The Foundry Manual

One backend for the entire workshop. Open-source primitives for registry, feedback, changelog, tasks, audits, and widgets — built so one builder can run twenty products without rebuilding the same plumbing twenty times.

Start the Quickstart API Reference

Vol. 01 · Folio 00 · Foundry Manual

§ 01The Primitives

№ 001 Registry

Project Registry

Track production URLs, GitHub repos, owners, rate limits, local setup notes, and fleet guidance — behind one API.

Open the registry →

№ 002 Workflow

Symphony Tasks

Durable tasks with comments, blockers, PR status, deploy state, and agent handoff history. Promote feedback into work.

See the workflow →

№ 003 Listening

Feedback & Voting

Public or private boards. Upvotes, status, and notify-on-ship. Promote real signal into the task queue.

Wire it up →

№ 004 Publishing

Changelog

Auto-drafted from completed tasks. Embeddable widget, in-app unread badge, version tags and categories.

Read the recipe →

№ 005 Pre-launch

Waitlist

Drop-in waitlist for any new product. Forms, embeds, exports, and analytics out of the box.

Collect signups →

№ 006 Interface

fnd CLI & SDK

Every surface available via REST, fnd api, or the TypeScript SDK. Agents and humans use the same contract.

Learn the CLI →

§ 02Specification

Operator: Sarthak Agrawal — sarthakagrawal927
Runtime: Cloudflare Workers · D1 · KV · R2
Interfaces: REST · fnd CLI · TypeScript SDK · Embeddable widgets
Auth: better-auth (Google OAuth) · opaque session tokens · CLI prefix sm_
Primitives: registry · feedback · changelog · tasks · audits · waitlist · widgets
Origin: MMXXIV →
License: MIT — open source on GitHub

§ 03Where to start

If you’ve never opened Foundry before, the Quickstart gets a project registered and your first feedback item created in about three minutes. If you want the bigger picture before touching anything, read The Standard — the opinionated shape every fleet project should keep.

For day-to-day work, the Foundry CLI is the primary interface: every route is validated against the API reference, so anything you can do in the Cockpit you can also do from the terminal or from an agent.