---
title: "Foundations"
description: "The token families and system-wide rules every opsinjs component obeys, one page each."
url: "https://opsinjs.pensievelabs.org/docs/foundations"
source: "https://opsinjs.pensievelabs.org/docs/foundations.md"
section: "Foundations"
kind: "foundation"
---

Foundations decide once what a colour, a size, a corner or a state means, so every component gives the same answer. Each page states the rules a component follows, and each token family ends in a table generated from `tokens/*.json`. Change a value in [Theming](../theming.mdx), and see every token in one list in [Tokens](../reference/generated/tokens.mdx).

| Page                                           | What it covers                                                                                   |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| [Accessibility](./accessibility.mdx)           | WCAG 2.2 AA, what components guarantee, and the limits of an author-run audit                    |
| [Colour](./colour.mdx)                         | Category and status as two axes, the derivation engine and the contrast floor the build measures |
| [Typography](./typography.mdx)                 | The platform UI font, a type scale named for jobs, and the reader's own text size                |
| [Space and layout](./space.mdx)                | The 4px spacing scale, the 44pt touch floor, responsive modes and the page shell                 |
| [Shape](./shape.mdx)                           | The radius ladder, concentric nesting and squircle corners                                       |
| [Motion](./motion.mdx)                         | Springs as tokens, motion chosen by its job, and reduced motion                                  |
| [Materials](./materials.mdx)                   | The surface ladder, its rung names, and the contrast floor for translucent rungs                 |
| [Iconography](./iconography.mdx)               | One icon library, and glyphs that never carry status on their own                                |
| [Imagery](./imagery.mdx)                       | Illustration, photography, skin-tone representation, avatars and body diagrams                   |
| [Data visualisation](./data-visualisation.mdx) | Chart colour, chart anatomy and accessible charts                                                |
| [States](./states.mdx)                         | Interaction states, and the loading, empty, error, stale and partial data states                 |
| [Writing](./writing.mdx)                       | Voice and tone, health literacy, and the words for status, alerts and errors                     |
