Learn Spillway, one task at a time
Install in five minutes, publish a page, then go deeper: the how-to guides each end with a result you can check, and the reference is generated from the code on every release.
Search the docs
53 results · page 2 of 5
Caching and CDN purge
How a published page gets from the renderer to a visitor, what Spillway caches on the way, which tags it files pages under, how a CDN in front is kept in step, and what to set where. The admin side is Site settings → Cache (getting-started.md); the endpoints are in api.md, Site; the internals in…
Connect HubSpot to a form
Send every submission of a Spillway form to a HubSpot form, so leads land in the CRM with the page and UTM context, while Spillway keeps its own copy.
Connect an agent to Spillway
Spillway treats AI agents as first-class readers and builders. An agent connects to a running site with an API token over the MCP server (POST /mcp) or the plain REST API, reads the content model, drafts content, runs the pre-publish checks and hands its work to a person. Every action is…
Content model
Spillway stores structured content as entities of a content type. A content type is a list of typed fields. An entity is one record of that type: a page, a post, a case study. Every save of an entity creates a revision. The types in this document are defined in packages/shared/src/index.ts; the…
Contributing guide
This is the long version of CONTRIBUTING.md. It covers the repository layout, the dev loop and how to add the three things people add most: an API route, an admin screen and a block.
Enterprise sign-in (SSO)
Spillway signs staff in through your identity provider with OpenID Connect or SAML 2.0. Providers are configured in the admin under Site settings → Sign-in (needs the users.manage permission, i.e. the admin role); each enabled provider becomes a Continue with … button above the password form on…
Fleet: provisioning and managing many Spillway sites
@spillway-cms/fleet (packages/fleet) creates and operates Spillway sites on a host from one command or one HTTP call. It is what a hosting provider such as Accorbis runs to turn "new customer" into "running site"; anyone can use the same CLI for their own sites.
Front-end adapters: Astro and Next.js
Spillway renders its own pages: one process serves the API, the admin and the public site, with a tagged page cache in front. That is the simplest setup and the one most sites should start with. The adapters are for sites that render Spillway content elsewhere: a marketing site that already lives…
Gap analysis: KWALL Drupal starter vs. Spillway
Read-only comparison of the higher-education Drupal starter at kwall-drupal-starter (Drupal 11 on Pantheon, custom upstream) against Spillway on the phase-2b branch, as of 2026-11-05. Spillway status was taken from the code, not the roadmap: "Shipped" means a route, table and admin screen exist;…
Getting started
This is the user manual for the admin. It starts with the setup wizard and the parts of the admin every screen shares, then takes the sidebar from top to bottom: one section per area, each with what it is, where it is, the most common tasks and links to the reference. It assumes Spillway is…
Hosting plans and their cost model
The four hosting plans Spillway sells on Accorbis, what each one runs on Fly.io, and what that costs at Fly's published rates. The commercial decisions are recorded in open-decisions.md (hosting plans, decided 2026-11-05). The plans live as data in packages/fleet/src/plans.ts, the rates (Fly's,…
Import a design system from Figma
Bring the colors (dark mode included), fonts, sizes, spacing, radius and content width of a Figma design system into the site's theme tokens, so every page and block picks them up once you publish.
Browse by section
Getting started
Install with Docker or from source, run the setup wizard, build a first page and install a kit.
How-to guides
Publish a campaign page, connect HubSpot, set up SAML, translate a page, schedule a post and more.
Reference
Content model, blocks, the HTTP API (OpenAPI), the CLI and the roles and permissions, generated from the code.
Operations
Security, enterprise sign-in with OIDC and SAML, and running a fleet of sites.
Development
Architecture, contributing and the roadmap.
Agent guides
Connect Claude Code, Claude Desktop or any MCP client; build a module, a kit or a theme with an agent; the rules agents work under.
How-to guides
Install a kit
A kit installs a site's structure in one step: content types, vocabularies with their terms, collections, forms, menus and starter pages, with optional sample content. Four kits ship with Spillway (higher education, city, intranet portal, nonprofit), plus the docs kit that holds this documentation…
Publish a campaign page
Build a landing page for a campaign in the page builder, run the pre-publish checks, send it through review and publish it at the URL the campaign will use.
Build a page with AI
Turn a one-paragraph brief into a draft page built from real blocks, then make it yours. The AI never publishes: it drafts, you review, an editor publishes.
Schedule a post
Write a blog post now and have it go live at a set time, with the checks still applied at that moment, and optionally come down again later.
Translate a page
Add a second language to the site and publish a Spanish version of a page at /es/<path>, with hreflang alternates and a per-language sitemap.
Launch a campaign with a workstream
Prepare a landing page, the updates to three existing pages and a new menu entry together, show the whole set to stakeholders on one preview link, and publish everything in one action, now or at a scheduled time.
Connect HubSpot to a form
Send every submission of a Spillway form to a HubSpot form, so leads land in the CRM with the page and UTM context, while Spillway keeps its own copy.
Add a department section
Hand a part of the site to a department: its editors manage everything under one path prefix and one menu, and nothing else.
Set up SAML with Okta
Let staff sign in to the admin with their Okta account over SAML 2.0, with accounts created on first sign-in and roles taken from Okta groups.
Import a design system from Figma
Bring the colors (dark mode included), fonts, sizes, spacing, radius and content width of a Figma design system into the site's theme tokens, so every page and block picks them up once you publish.
Import a website
The importer brings an existing site into Spillway from its public pages alone: no database dump, no credentials. It crawls, proposes content types, converts the pages to blocks, extracts the theme and lands everything as drafts with redirects, so the old URLs keep working when you go live.
For AI agents
Agents are first-class readers and builders here. The whole documentation is available as plain text at /llms.txt (an index) and /llms-full.txt (every page), the HTTP API at /openapi.json, and every registry package offers an agent-readable manifest. The agent guides explain how to connect with an API token and what an agent may and may not do: it drafts, a person publishes.
Connect an agent to Spillway
Spillway treats AI agents as first-class readers and builders. An agent connects to a running site with an API token over the MCP server (POST /mcp) or the plain REST API, reads the content model, drafts content, runs the pre-publish checks and hands its work to a person. Every action is…
Rules for agents
What an AI agent working with Spillway must respect, whether it edits content on a site through MCP, writes code in this repository, or publishes a package to the registry. These rules are also encoded in the server: tokens cannot grow permissions, the AI layer has no publish path, and the…
Build a module with an agent
A recipe for having Claude Code, Cursor or any coding agent write a Spillway module: the prompt to paste, what the agent should produce, and the checks to run before you trust it. Read modules.md once yourself; the agent will read it too.
Build a kit with an agent
A kit is a JSON manifest that installs a site's structure: content types, vocabularies with terms, collections, forms, menus, starter pages and sample content. It is the quickest thing to build with an agent, because the format is declarative and the server validates it. Read kits.md first; the…
Build a theme with an agent
A theme in Spillway is a kit of tokens, blocks (shared blocks and page templates built from the core blocks) and page templates, with screenshots, published to the registry with "kind": "theme". Themes do not ship code: the look comes from the theme tokens the server emits as CSS custom…
Publish a package to the registry
How a module, kit or theme reaches the registry on spillwaycms.com (or any Spillway instance running with REGISTRY_HOST=1), from a terminal or from an agent. The registry contract is in packages/shared/src/index.ts under Registry; the operator's side is in modules.md.
Something missing or wrong?
Every page links to its Markdown source. Fix it in a pull request and the next release carries the change.