Tres Marías — design system

Tres Marías is the design system distilled from Manteca (Capibara's product UI) and shared by every human surface of the company: AgentOS (indigo-human-surface) today, Capibara/Manteca as the next consumer. It is a transcription, not a redesign: every token, control geometry, material and motion rule names the Manteca source it comes from.

What is in the package

| Path | Contents | | --- | --- | | src/lib/styles/tres-marias.css | The one stylesheet: tokens (light/dark, accents, materials), controls, stacks and rows, toolbar, sheets and dialogs, journeys, viewer, motion. Consumers import it and add no CSS of their own. | | src/lib/components/* | Tres Marías compositions (Stack, Row, ActionRow, Disclosure, IconBox, FaceDot, Avatar, ToolbarButton, Segmented, Widget, Chart, Empty, Notice, Icon…). Consumers compose Places from these; they never emit ad-hoc markup with private classes. | | src/lib/components/icons.ts + Icon.svelte | The exact glyph table of the surfaces (24-viewBox strokes). | | docs/tres-marias-design-system.md | The written system: principles, tokens, families, chassis rulings (§7 records every owner decision with its date). docs/build_ds.py renders it. | | docs/interaction-modes-and-place-footer.md | Owner decision (2026-09-17): footer ownership; interaction modes versus presentation surfaces. Explicitly separates decided behavior from proposed detection/fallback policy. |

Consuming it

Inside the Tres Marías Framework workspace: "@tres-marias/design-system": "workspace:*".

/* app.css */
@import "tailwindcss";
@import "shadcn-svelte/tailwind.css";
@source "../../node_modules/@tres-marias/design-system/src";
@import "@tres-marias/design-system/styles/tres-marias.css";

<script>
  import { Stack, Row } from '@tres-marias/design-system';
  import Icon from '@tres-marias/design-system/components/Icon.svelte';
</script>

Peer dependencies: svelte@5, bits-ui@2, @lucide/svelte, tailwind-variants, clsx, tailwind-merge (and layerchart for charts).

Rules of the house

• Manteca must not degrade: a value that differs from Manteca is a bug unless the owner decided it (then §7 records it).
• One writer per rule. A consumer that needs a rule Manteca does not have composes existing values and says which ones, inside this stylesheet.
• Behaviour from bits-ui/shadcn (focus, escape, portal, a11y); looks from the stylesheet. Never both from ad-hoc code.

License

Apache-2.0 — see LICENSE at the repository root. "Tres Marías" and its logos are trademarks, not covered by this code license — see TRADEMARKS.md.