How to use
Here's how to get started today. Four short steps and you're ready to build something for your community.
1. Start: use this template
Click Use this template and GitHub makes you your own repository — a complete, independent copy. No upstream to track, no permission to ask. It's plain HTML and CSS: nothing to install, no build step to run, no framework to adopt.
2. Get oriented
Read these four files, in this order:
-
README— what the system is, and how it's laid out. -
PRINCIPLES.md— the three commitments everything else follows from. -
TESTING.md— the bar every component has to clear. -
docs/adapting.md— how to make it yours.
3. Adapt
Theming here is self-determination. Your community's colours and words
live in one file — tokens.css. Remap the activity colours,
the surfaces, the type, and every component follows. You don't need to
touch the component CSS.
:root {
/* Your community's palette, in one file. */
--grow: #b5651d; /* terracotta — what this fork calls "available" */
--repair: #4f7a6f; /* sage — "needs attention" */
/* …surfaces, type, spacing follow the same way. */
}
One safeguard worth knowing: every foundation reads its tokens with a
fallback — var(--token, sensible-default) — so if you delete
a token by mistake, the system degrades visibly instead of failing
silently. Keep that convention in any CSS you add.
4. Test
seedbank.design has three foundational test criteria. Pass these and a change will survive the edges:
- It renders with no CSS at all.
- It works at 200% zoom.
- It works at 320px wide.
Hold your fork to the same bar.
Coming soon
Two more things are on the way soon:
- A Figma library — the components as a UI kit, for designing before you build.
-
seedbank.md— a single-file version of the system for AI design tools.
The coded system is complete and tested; these extend it, so check back soon!