# Visualli design system

Everything the Visualli apps look and move like, in one folder of the monorepo: `design-system/`.

**The mantra:** every screen should feel *joyful*, *spatial*, *visual*, *gradual reveal* and *fresh*. When a choice is unclear, pick the option that serves them.

- **[Feature matrix](feature-matrix.html)** — every feature and the surfaces it works on.
- **Surfaces** — the [web app](surfaces/web.html), [mobile app](surfaces/mobile.html), [MCP widget](surfaces/mcp.html), [Chrome extension](surfaces/extension.html), [website](surfaces/website.html) and the coming [desktop viewer](surfaces/desktop.html), each as a live prototype.
- **Guidelines** — the brand book, canvas language, comfort modes, surfaces, marketing and migration notes.
- **Foundations** — every token, generated from `tokens/tokens.json` for 8 themes.
- **Components** — guidelines, props and a live preview for each component.
- **Build it** — on each surface page: how the web app, mobile, MCP apps and the Chrome extension consume the system.

Version 0.1.0. This site is rebuilt from source on every merge, so it is always the current system.
For AI agents: [llms.txt](llms.txt) lists every page as Markdown.