Governance · https://ds.soloshape.com → https://ds.mycongregation.app

Distribution

This manager is the source of truth and the review surface. Consumers synchronize an immutable, versioned source artifact during development and deploy it locally with their application.

01

Discovery endpoints

Observable, revalidated manager feeds generated from the same registry as this documentation. They support inspection and artifact tooling, never consumer runtime UI.

EndpointContentFor
/api/tokens.cssThe full custom-property stylesheet, including the Fast/Calm pace blocks.Manager inspection and versioned artifact generation. Production apps must not link it.
/api/tokens.jsonTokens as structured data — name, value, group, description, pace overrides.Build pipelines: Tailwind config, style-dictionary, native platforms.
/api/registry.jsonThe ID-first public registry plus clearly separated manager-only inventory and changelog.Build-time inspection before selecting an immutable release.
02

How consumers stay in sync

Every consumer uses deterministic source vendoring. The manager is never a runtime CDN for UI assets or behavior.

Versioned source artifact

A sync command acquires /releases/<version>/, verifies its checksum, and atomically replaces the owned src/lib/design directory.

The artifact lock records version, checksum, compatibility range, and rollback target. Owned files are committed and never hand-edited.

Runtime isolation

CSS, tokens, fonts, icons, assets, Svelte elements, and motion ship inside the consumer build. If ds.soloshape.com is unreachable, the deployed app's UI is unchanged.

Unversioned API endpoints on this page are observable discovery previews only. They are not permitted in production application markup or runtime requests.

Versioning contract. Patch releases fix behavior without changing public rendering, token values, or APIs. Minor releases add approved tokens, icons, variants, elements, or tiers; a deliberate reference-value change also requires updated visual baselines and an explicit visual-change record. Major releases remove, rename, or materially change a contract, and consumers migrate explicitly. No release is silently auto-applied.

03

Changelog

Every published version, newest first. The same data ships inside /api/registry.json.

v5.0.0-rc.2
Current 2026-08-14
  • Correct the manager shell cascade so the collapsed mobile navigation no longer occupies and covers the full viewport.
  • Add phone-profile regression coverage proving the route body remains visible below the closed navigation.
v5.0.0-rc.1
Previous 2026-08-13
  • Contract candidate: rebaseline the manager on the ss-* / --ss-* namespace, a grayscale semantic foundation, ID-first element manifests, intrinsic responsive layout elements, source-vendored distribution, and offline-by-default conformance.
  • This is an observable release candidate, not the stable 5.0.0 release. Promotion requires the complete release:verify gate and disposition ledger.
v4.8.0
Previous 2026-07-12
  • Round conductor-console-retrofit I1a: extended existing form/action primitives for console provenance cleanup. Button adds variant='unstyled' for composition-owned visuals while preserving press behavior and caller class pass-through; TextField accepts native date/time input types (`time`, `date`, `datetime-local`, `month`, `week`). Additive API extension; no existing element status changes.
v4.7.1
Previous 2026-07-12
  • Round ssds-enforcement A6.1: fixed check-provenance consumer-relative source resolution so CHECK_PROVENANCE_SRC=./src scans the invoking consumer repo, not the DS package root. Semver patch; provenance gate bug fix.
v4.7.0
Previous 2026-07-12
  • Round ssds-enforcement I4a: renamed the approved .ss-textarea registry title to Multi-line input so it is distinct from the proposed Textarea Svelte primitive. Additive metadata polish; no rendering or API behavior change.
v4.6.0
Previous 2026-07-12
  • Round ssds-enforcement I3: recorded compound and paired primitive shapes as classification-metadata variants of the element layer (docs/decisions/compound-paired-classification.md). Charter §3 unchanged; three element rows now carry a shape tag. Additive; no consumer contract change.
v4.5.0
Previous 2026-07-11
  • Round ssds-element-gapfill: added Textarea as a demand-scan-justified proposed form element. It wraps native multi-line text entry with the approved .ss-textarea visual contract, matching the TextField absorption pattern for console retrofit work.
v4.4.0
Previous 2026-07-11
  • Round ssds-element-gapfill: added DatePicker as a proposed form element through the Bits UI DatePicker recipe path. It composes the editable date field, trigger, popover and single-date calendar behavior while rendering the day grid, month navigation and selected/today states with solo-shape tokens.
v4.3.0
Previous 2026-07-11
  • Round ssds-element-gapfill: added Radio and RadioGroup as proposed form elements through the Bits UI recipe path. RadioGroup carries the roving-focus and arrow-key navigation contract; Radio renders each single-choice option with solo-shape token chrome.
v4.2.0
Previous 2026-07-11
  • Round ssds-element-gapfill: added Checkbox as a proposed form element through the Bits UI recipe path. It keeps the headless checkbox state machine, keyboard toggling, hidden-input form bridge and checked/indeterminate data attributes, while rendering solo-shape token chrome.
v4.1.0
Previous 2026-07-11
  • Round ssds-element-gapfill: added Combobox as a proposed searchable form element through the Bits UI recipe path. It layers local filtering and solo-shape token chrome over the headless combobox/listbox behavior while preserving native form submission through the Bits UI hidden input.
v4.0.0
Previous 2026-07-11
  • Round ssds-element-gapfill: revised Select as a proposed form element through the Bits UI recipe path. The new Select primitive adds listbox keyboard behavior, placeholder display and empty-state chrome; the native .ss-select class remains as a fallback but re-enters the lifecycle as proposed because the form-select contract changed.
v3.2.0
Previous 2026-07-11
  • Round ssds-element-gapfill: added FormField as a proposed form element with an explicit charter §3 boundary exception. It standardizes the label + field + hint stack for the console gap-fill work while the follow-on enforcement round formalizes compound-element boundaries.
v3.1.0
Previous 2026-07-11
  • Round ssds-element-gapfill: added TextField as a proposed form element. It is a Svelte wrapper around native single-line input behavior that reuses the approved .ss-input token styling, giving consuming apps an importable primitive instead of raw input markup.
v3.0.0
Previous 2026-07-11
  • Round ssds-fork: forked from krown-design-manager into a new private repo ds-solo-shape as the solo-shape Design System (charter §2, §12).
  • Historical fork record: the first theme layer placed inherited product palettes behind a legacy theme attribute. Release 5 replaces that public direction with the grayscale reference and the namespaced recipe contract.
  • Elements-only catalog per charter §3 vocabulary. Every registry entry now carries a `classification: element | composition | behavior` field. The catalog page (/elements) filters on classification === "element" (22 CSS-class rows + 2 new Svelte-only rows for Icon and CountUp = 24 elements). Composition and behavior rows stay in the registry (audit + doc-generator visibility) but drop from the catalog surface. Routes /components, /objects, /dialogs, /pages removed; overlay elements fold into /elements#overlay.
  • Off-token color literal audit: new CLI-safe scripts/check-colors.mjs wired into npm run check. 6 rgba literals promoted to tokens (--ss-color-shimmer-high/mid, --ss-shadow-input-inset, --ss-color-status-danger-pulse-start/end).
  • Solo-shape brand mark added to icons.ts; sveltekit-starter favicon replaced with the solo-shape placeholder.
v2.10.0
Previous 2026-06-26
  • Dropdown component: non-breaking API enrichment. String options remain unchanged; object options now support separate value + label, per-option status dots on the ok/manual/block/info/skip token family, inert disabled rows, parent-controllable autoSelect (default true preserves the legacy first-option display fallback), placeholder display and emptyText for empty menus. Consumers such as the Conductor console AppPicker/TaskPicker wrappers can collapse their hand-replicated dropdown behavior onto this upstream component after their next design-system snapshot sync.
v2.9.0
Previous 2026-06-25
  • Added the brain icon under Wayfinding for the Conductor console run-board Strategist marker. Strategist uses the `brain` key; Operator reuses the existing `settings` gear-fill key, so there is no duplicate gear contract. Additive, non-breaking; no existing icon changed.
  • Raised --ss-size-control-small from 28px to 30px so .ss-btn--sm labels with descenders (g/j/p/q/y) no longer clip at line-height: 1. Single token change; supersedes the rail-scoped Button override the Conductor console shipped as a builder-shell I7 stopgap. That console cleanup is follow-on console work, not part of this design-system round.
v2.8.0
Previous 2026-06-24
  • Added --ss-color-status-info (blue) and --ss-color-status-info-subtle to the STATUS group — sibling of --ss-color-status-success / --ss-color-status-success-subtle, for in-progress / informational status. Additive, non-breaking; no existing tokens changed and no component CSS restyled. Consumers can adopt by syncing the registry feed.
v2.7.0
Previous 2026-06-12
  • Motion Lab evaluation COMPLETE. Final promotions: shared surface morph and snap-into-place reorder. 26 core behaviours, 0 pending; magnetic buttons and blanket press coverage stand retired (now a documented ledger — RETIRED_BEHAVIORS in the registry and feed).
  • Every behaviour integrated into a real home: Overview gained the system-pulse hero (tilt + glow + rolling registry counters); Elements demos icon micro-motions on buttons; Objects/Pages workload metrics roll in and fill with sheen; Pages review cards lift; Components gained five sections — shared surface morph, reorderable widgets, loading states, AI generation, completion celebration — plus the ambient empty state; Dialogs gained the parallax drawer and spatial depth.
  • New reusable primitives: growFrom/shrinkTo/fadeIn ($lib/motion/morph) and createSnapDrag ($lib/motion/snap) — the morph and drag choreographies as library code for consumer apps.
  • Motion Lab reset to all-clear: forwarding addresses for every behaviour, the retired ledger, and the process for staging the next batch.
v2.6.0
Previous 2026-06-12
  • Card lift: phantom-hover guard. When a collapsing surface leaves the cursor resting over an unrelated card, that card no longer lifts — hover is muted (.ss-hover-muted) until the pointer actually moves, and the just-viewed card carries the lift (.ss-lift--active) so attention returns to where the viewer’s mind already is. (Browsers cannot move the cursor; this delivers the intent the honest way.)
v2.5.0
Previous 2026-06-12
  • Motion Lab review round 4 (Mark): PROMOTED to core — icon micro-motions (hover previews, event plays in full; every glyph owns one move).
  • Shared-layout morph collapse re-choreographed: the PANEL itself shrinks back into the card’s slot (content fading out over the first third); the small card’s display only appears once the surface has arrived at small size. The returning type never balloons.
  • Snap-into-place drag made foolproof: drag listeners moved to the window — reordering moves the row’s DOM node, which silently released pointer capture and could strand the row mid-air. Release now always lands; window blur is a safety net.
v2.4.0
Previous 2026-06-12
  • Motion Lab review round 3 (Mark): the settled rule — PRESS DIPS, SELECTION SLIDES. Buttons and interactive cards keep the original V1 buttery press, unchanged. Choosing between options is never a press: the sliding marker carries the change.
  • RETIRED the press-coverage extension (facet/tab/nav active scaling, whole-frame toggle dip, tonal option presses) and the harder-edged .ss-toggle itself.
  • NEW: .ss-seg--ink — the view-toggle voice. The black portion is now the thumb, gliding from Table to Cards and back on the same recipe as the tab underline; the selected label turns white as the thumb arrives. All view toggles ride it.
v2.3.0
Previous 2026-06-12
  • Motion Lab review round 2 (Mark): PROMOTED to core — 3D tilt (pairs with cursor glow on hero surfaces), spatial modal (2% recede), ambient empty state.
  • Press physics: contained controls (view toggle, segmented control) now press as ONE OBJECT — the whole frame dips like a card while the chosen option shades. As noticeable as any press, and a fill can never break its boundary.
  • Icon micro-motions: one grammar everywhere — HOVER previews every glyph’s move (bell swings, refresh half-turns, trash leans, upload rises, accordion caret nudges toward where it will go); the glyph’s own event plays it in full.
  • Shared-layout morph rebuilt as a TRUE FLIP: one continuous element grows from the card’s exact footprint to the detail panel on the new --ss-motion-duration-grow token (1100ms smooth / 420 fast / 1700 calm) — the boundary is visible the whole way; content fades in after the surface lands.
  • Snap-into-place drag: direct index targeting (fast multi-slot drags land in one splice, no chained swaps), quicker neighbour give-way. No more mid-drag sticking.
v2.2.0
Previous 2026-06-12
  • Motion Lab review round 1 (Mark): PROMOTED to core — card lift, cursor-follow glow (now glass-harmonised: glass-hi core blending to brand tone), drawer parallax, status celebration, AI generation motion, command palette (now global — ⌘K anywhere, navigation + pace commands).
  • RETIRED — magnetic buttons (effect, action, classes and registry entry removed).
  • TUNED, still in lab — 3D tilt strengthened to ±4.5° + hover shadow; spatial modal recede deepened to 2%; shared-layout morph slowed to --ss-motion-duration-curve so the edges visibly travel; snap-into-place drag smoothed (dragged item exempt from FLIP); ambient empty state amplified (visible drift + ok-green ping dot); icon micro-motions unified — one grammar, custom accent per glyph (bell swing, refresh spin, trash lean, upload hop).
  • Press physics rule amended: options contained in a shared frame (view toggle, segmented control) press tonally instead of scaling, so a fill never breaks its boundary. Value roll now lands the moment the remainder falls under half a digit — no stopped-then-flips-once tail.
v2.1.0
Previous 2026-06-12
  • Motion Lab: sixteen staged behaviours from the game-like-but-quiet brainstorm — card lift, magnetic buttons, route transitions, shared-layout morph, 3D tilt, meter inertia + sheen, depth skeletons, command-palette spawn, drawer parallax, status celebrations, cursor-follow glow, icon micro-motions, spatial modals, ambient empty states, AI generation motion, snap-into-place reordering. Each carries a stage (core/lab) and a usage contract; evaluate at /motion-lab.
  • New primitives: magnetic/tilt/glow actions, Drawer, CommandPalette, Meter, CountUp, Skeleton, CheckDraw components; press physics extended to facets, toggles, tabs and nav items.
  • Route transitions ride the View Transitions API with system tokens; the no-blurred-scrim and brand-tones-only laws hold across all new effects.
v2.0.0
Previous 2026-06-12
  • Re-architected as a SvelteKit application — the system is now data first: tokens, icons, components and motion are a typed registry from which the CSS, the docs, the audit and the distribution endpoints are generated.
  • Doc shell (nav, labels, hover and selection states) rebuilt from the system’s own tokens — removed all hardcoded chrome colours.
  • New tokens: border widths (--ss-border-width, --ss-border-width-hairline, --ss-border-width-focus), z-index scale (--ss-z-shell, --ss-z-pop, --ss-z-overlay, --ss-z-toast), micro spacing (--ss-space-05, --ss-space-15), on-dark additions (--ss-color-on-dark-ink-mute, --ss-color-on-dark-active), glass input/inset tokens promoted from dialog one-offs.
  • Retired the V1 highlight-options token fork — V2 is the single design language.
  • Archived shipped explorations (black action, orange & mic, live tile fill, status outline, typography options).
v1.0.0
Previous 2026-06-11
  • V1 draft built in Claude Design AI (Claude Opus 4.8). Reviews module promoted to core with all ten edge cases resolved.