Foundry Wiki
Foundry is a declarative, manifest-driven framework for building and operating platforms. One manifest describes the platform — its services, stacks, environments, and how each service deploys. The foundry CLI scaffolds it, runs it locally, and generates its CI/CD; a dedicated ops repo orchestrates deploys; an infrastructure repo holds the shared modules.
Quick Start
Install the CLI, init a project, and run services locally with foundry run dev.
Repo Topology
The three-repo model: the manifest is the brain, the ops repo owns CI/CD, the infrastructure repo holds modules.
The Manifest
foundry.json / platform.json — services, stacks, deploy strategies, environments, multi-repo.
CLI Reference
init, generate, run, sync, db, github, config, alias — what each command actually does.
Deploy Model
Thin caller → ops-repo reusable workflow → orchestrator → smart IaC (plan, apply on change).
Infrastructure
Shared infrastructure-repo modules + control-plane stack, plus per-repo ci/iac app-edge stacks.
The manifest schema is at v0.7.0 — multi-repo (per-service repository, path, and environments) and a unified deploy.strategy. foundry init currently scaffolds a single-repo v0.5.0 manifest — the multi-repo fields are additive and used by the central ops-repo platform.json.