# 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%
