Migrated from design-system-swarm with fresh git history.
Old project history preserved in /home/overbits/apps/design-system-swarm
Core components:
- MCP Server (Python FastAPI with mcp 1.23.1)
- Claude Plugin (agents, commands, skills, strategies, hooks, core)
- DSS Backend (dss-mvp1 - token translation, Figma sync)
- Admin UI (Node.js/React)
- Server (Node.js/Express)
- Storybook integration (dss-mvp1/.storybook)
Self-contained configuration:
- All paths relative or use DSS_BASE_PATH=/home/overbits/dss
- PYTHONPATH configured for dss-mvp1 and dss-claude-plugin
- .env file with all configuration
- Claude plugin uses ${CLAUDE_PLUGIN_ROOT} for portability
Migration completed: $(date)
🤖 Clean migration with full functionality preserved
DSS MVP1 - Design System Swarm
A modern design system orchestration platform built with Python/FastAPI, leveraging style-dictionary and shadcn/ui.
Architecture
- Core: Python/FastAPI + Pydantic models
- Token Transformation: style-dictionary (Node.js)
- Component Management: shadcn CLI
- Testing: pytest with >80% coverage
- Database: SQLite
Project Structure
dss-mvp1/
├── dss/ # Core application
│ ├── models/ # Pydantic models
│ ├── validators/ # Validation logic
│ ├── tools/ # External tool wrappers
│ └── api/ # FastAPI routes
├── tests/ # Test suite
│ ├── fixtures/ # Test data
│ ├── unit/ # Unit tests
│ └── integration/ # Integration tests
└── pytest.ini # Test configuration
Quick Start
# Install Python dependencies
pip install -r requirements.txt
# Install Node.js dependencies
npm install
# Run tests
pytest
# Run unit tests only
pytest tests/unit -m unit
Development
This is a test-driven rebuild of DSS following clean architecture principles.
Week 1: Foundation + Core Pipeline Week 2: Theme System + shadcn Integration
Testing
- Unit tests: >70% of test suite
- Integration tests: ~25%
- E2E tests: ~5%
- Target coverage: >80%