Configuration

Configuration — sardine.toml

One file per project, read by every cms command. Secrets never live here (the admin is configured by environment variables only — see Admin Panel).

[site]

Key	Required	Default	Meaning
name	yes	—	Site name (header brand, OG site name, JSON-LD)
base_url	yes	—	Canonical absolute base URL
languages	no	["pt-pt","es","fr","de"]	Required target languages; EN is always the source
blog_path	no	"blog"	URL segment for the blog
theme	no	"default"	Theme name (entry-point discovery, e.g. ph7x-reference)
page_size	no	10	Articles per listing page
footer_text	no	site name	Footer line, e.g. "© 2026 Sardine Aerospace"
admin_url	no	unset	When set, the footer shows a dimmed Admin link (rel="nofollow")
organization	no	unset	JSON-LD Organization payload (verbatim table)

[site]
name = "Sardine Aerospace"
base_url = "https://sardine.ph7x.com"
languages = ["pt-pt", "es", "fr", "de"]
theme = "ph7x-reference"
footer_text = "© 2026 Sardine Aerospace"
admin_url = "/admin/"

[site.categories.<slug>]

Localized labels for article categories. Categories used by articles must be declared (the known-categories validation rule enforces it).

[site.categories.missions]
en = "Missions"
pt-pt = "Missões"
es = "Misiones"
fr = "Missions"
de = "Missionen"

[site.labels.<key>]

Overrides for the localized UI-label system (cms_build.ui). Any label the themes consume can be overridden per language; unset languages fall back to EN, then to the built-in default. Useful keys: blog, search, back, min-read, blog-title, blog-eyebrow, blog-sub, admin, view-cards, view-list.

[site.labels.search]
en = "Search articles"
pt-pt = "Pesquisar artigos"

[storage]

Key	Default	Meaning
url	sqlite:///content.sqlite3	Storage URL for create_storage (relative SQLite paths resolve against the project directory)

PostgreSQL: url = "postgresql://user:pass@host:5432/dbname" (install cms-core[postgres]). See Storage Backends.

[build]

Key	Default	Meaning
output	_site	Output directory for cms build / cms export