# Version and Status

What the version number promises, and how ready each foundation and component is.

## The version

This is version 0.2.2 alpha (0.2.2-alpha). One version number covers the whole design system, and it follows semantic versioning. Until 1.0, names and behavior can still change from one version to the next. Each version's notes on the [Releases](https://design.simbolik.ai/releases/) page say what changed, what breaks and what's missing.

## What Status means

Every foundation and component also carries a Status, on its page and in its documentation. Each moves on its own when that piece is ready, whatever the version number says.

| Status | What it means | Now |
|---|---|---|
| Proposed | Needed, not built yet. | 5 components |
| Experimental | Built. Expect big changes. | 62 components and 4 foundations |
| Candidate | Complete as far as anyone knows. Use it; it may still change. | 43 components and 7 foundations |
| Stable | Supported. Changing it is a breaking change. | 2 foundations |
| Deprecated | On its way out. Move off it. | None |
| Retired | Removed. | None |

Next: [Working with AI assistants](https://design.simbolik.ai/docs/ai/): Every page as markdown, the component catalog, and Open in Claude.