dss/README.md

DSS - Design System Server

Monolithic design system platform. Ingest tokens from Figma/CSS/SCSS/Tailwind, normalize to canonical format, generate outputs.

Quick Start

pip install -r requirements.txt
python tools/api/server.py      # REST API on :3456
python tools/api/mcp_server.py  # MCP server on :3457

Structure

tools/           # Python backend (API, ingestion, analysis)
admin-ui/        # Web dashboard
cli/             # TypeScript CLI
dss-claude-plugin/  # Claude Code integration (skills, commands, agents)
.knowledge/      # AI knowledge base (DSS_CORE.json)
.dss/            # Runtime data, schemas, database

Core Concept

DSS structure is immutable. External systems adapt TO DSS via translation dictionaries.

See .knowledge/DSS_CORE.json for complete specification.