SDS 3.28.0
Theme selector web component
SDS 3.28.0 adds the ds-theme web component for switching between light, system, and dark color modes.
The component updates the page-level SDS theme attribute, persists the selected value in localStorage, and dispatches a ds-theme-change event when the selection changes. It is intended for app shells, headers, settings panels, and other persistent UI where users need direct control over the current color mode.
The design system docs header now uses ds-theme, so the site itself exposes the same theme selector that product teams can use.
Theme documentation
The new Theme web component documentation covers:
SDS MCP server documentation
The new SDS MCP server guide explains how to install and configure @soracom/sds-mcp-server in AI coding tools.
The guide covers VS Code, Zed, Codex, Claude Code, and Claude Desktop, with examples for using the server to inspect SDS components, generate component HTML, validate SDS markup, and build common UI patterns using SDS conventions.
Repository relocation
SDS and the SDS MCP server have been relocated from user-console-monorepo into their own soracom-design-system repository. This separates design system package work from the user console codebase and gives SDS releases, generated assets, package publishing, and MCP server updates a dedicated repository workflow.
The old SDS source and SDS MCP server code have been removed from user-console-monorepo; future SDS implementation work should happen in the standalone design system repository.
Docs updates
Refreshed SDS data
The docs now include updated SDS beta release metadata, including the ds-theme manifest and current SDS changelog entries for 3.26.1, 3.27.0, and 3.28.0.
Component manifests
Design system component pages can now display SDS manifest data when it is available. This gives readers a more direct view of component structure, modifiers, examples, CSS custom properties, and related implementation metadata.
More reliable embedded examples
Embedded examples now load SDS beta CSS with cache-busted URLs, helping examples pick up fresh SDS assets after a beta release without relying on stale cached styles.
Astro 6
The documentation site has been updated to Astro 6, with content collection and route updates applied across the design system, brand, blog, RSS, and markdown endpoints.