The official visual identity of the PROTEUS Framework — a coupled interior–atmosphere evolution code for rocky planets, developed by the Forming Worlds Lab.
The system is codenamed Thermocline. It encodes one story: the transition of a rocky planet from a magma ocean to a water world. Red = hot state, black = deep time, blue = cool state.
Brand guide: https://formingworlds.github.io/proteus-visual-language (rendered from
site/) · PDF at brand-guide.pdf
This is a monorepo. Each top-level folder is independently consumable.
| Folder | What it is | How to consume |
|---|---|---|
tokens/ |
Colours, type, spacing, radii — the source of truth. | npm: @formingworlds/proteus-tokens (CSS / JSON / SCSS) |
logo/ |
Glyph colorways, lockups, favicon. Formats: SVG, PNG, JPG, PDF. | download the files |
fonts/ |
The three type families. | see fonts/README.md |
templates/ |
Production stylesheets + reference pages for web, docs, decks, poster. | copy the CSS/JS into your project |
figures/proteus-mpl/ |
Matplotlib theme for publication figures. | PyPI: pip install proteus-mpl |
talks/beamer/ |
LaTeX Beamer theme. | copy into your .tex project |
community/ |
GitHub banners, module identities, diagram language, stickers. | reference / export |
docs/ |
The brand guide, written out per topic. | start at docs/README.md |
site/ |
The interactive brand guide (deployed to Pages). | open site/index.html |
Repo meta: CONTRIBUTING.md (ground rules and releasing),
CHANGELOG.md, SETUP.md (maintainer setup).
CI in .github/workflows/ deploys the brand guide,
checks token sync, and publishes the packages on release tags.
Use the colours in a web project
npm install @formingworlds/proteus-tokens@import "@formingworlds/proteus-tokens/tokens.css";
.hot { color: var(--pt-magma); }Or drop tokens/tokens.css in directly. Machine-readable
tokens.json and tokens.scss ship
alongside.
Brand your matplotlib figures
pip install proteus-mplimport proteus_mpl
proteus_mpl.use() # or use("dark")Theme a docs site (zensical / mkdocs)
Copy templates/docs/extra.css into your build,
copy the font files from fonts/ into docs/stylesheets/fonts/
(the stylesheet loads them; details in
templates/README.md), and add the logo + favicon
from logo/. Dark (default, OS-aware) and light schemes are
included.
Build a slide deck or poster
See templates/deck/ and templates/poster/.
Every value traces back to tokens/tokens.css. Never
hard-code a colour, font, or size that already exists as a token. The full
rationale is in docs/ and the interactive guide.
Fonts are Sora (display) · Instrument Sans (body/UI) · Spline Sans Mono (code, labels, metadata); never Space Grotesk or JetBrains Mono.
Dual-licensed — see LICENSE:
- Code (tokens, stylesheets,
proteus-mpl, Beamer theme, build scripts): Apache-2.0. - Creative assets (logo, brand guide, figures, templates as designs): CC BY 4.0.
- Fonts are third-party works under the SIL Open Font License 1.1; they are not covered by either grant above.
- The PROTEUS logo and wordmark are reserved marks — see the usage note in
LICENSE-ASSETS.md. Don't ship forks or unrelated products under the PROTEUS identity.
© 2023–2026 Forming Worlds Lab · Thermocline v1.3