SpandrelA framework that turns markdown file trees into governed knowledge graphs — philosophy, spec, and reference implementation

Deployment

How to run Spandrel — local development and production patterns

Deployment

Spandrel runs in three modes with different infrastructure needs. The same GraphQL surface is served in all three — the only difference is where the compiled graph lives and who reads from it:

  • Local development — single-process dev server with the in-memory store; zero setup beyond spandrel dev
  • Static + flat-file MCP — spandrel publish emits a static bundle; a thin serverless function translates MCP over the bundle. Read-only, hostable anywhere, embeddable in an existing site
  • Hosted live backend — compiler writes to a persistent store; GraphQL + MCP serverless; graph updates on push. Appropriate when the graph needs writes, identity-aware reads, or federation across repos