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
58 lines
1.4 KiB
Markdown
58 lines
1.4 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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%
|