08ce228df1
Some checks failed
DSS Project Analysis / dss-context-update (push) Has been cancelled
- Remove legacy admin-ui/js/ vanilla JS components - Add .dss/ directory with core tokens, skins, themes - Add Storybook configuration and generated stories - Add DSS management scripts (dss-services, dss-init, dss-setup, dss-reset) - Add MCP command definitions for DSS plugin - Add Figma sync architecture and scripts - Update pre-commit hooks with documentation validation - Fix JSON trailing commas in skin files 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
110 lines
2.4 KiB
Markdown
110 lines
2.4 KiB
Markdown
---
|
|
name: dss-services
|
|
description: Manage all DSS development services (API, admin-ui, Storybook)
|
|
arguments:
|
|
- name: action
|
|
description: Action to perform (start, stop, status, restart, logs)
|
|
required: true
|
|
- name: service
|
|
description: Specific service (api, admin-ui, storybook) - optional
|
|
required: false
|
|
---
|
|
|
|
# DSS Services Command
|
|
|
|
Manage all DSS development services from a single command.
|
|
|
|
## Usage
|
|
|
|
```
|
|
/dss-services <action> [service]
|
|
```
|
|
|
|
## Actions
|
|
|
|
| Action | Description |
|
|
|--------|-------------|
|
|
| start | Start all services (or specific service) |
|
|
| stop | Stop all services (or specific service) |
|
|
| status | Show status of all services |
|
|
| restart | Restart all services (or specific service) |
|
|
| logs | Show service logs |
|
|
|
|
## Services
|
|
|
|
| Service | Port | Description |
|
|
|---------|------|-------------|
|
|
| api | 8000 | FastAPI REST server |
|
|
| admin-ui | 3456 | Vite dev server |
|
|
| storybook | 6006 | Storybook design docs |
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# Start all services
|
|
/dss-services start
|
|
|
|
# Check status
|
|
/dss-services status
|
|
|
|
# Start only the API server
|
|
/dss-services start api
|
|
|
|
# Stop Storybook
|
|
/dss-services stop storybook
|
|
|
|
# View admin-ui logs
|
|
/dss-services logs admin-ui
|
|
|
|
# Restart everything
|
|
/dss-services restart
|
|
```
|
|
|
|
## Instructions for Claude
|
|
|
|
When the user runs this command:
|
|
|
|
1. Execute: `scripts/dss-services.sh <action> [service]`
|
|
|
|
2. Present the output in a clean format
|
|
|
|
3. For `status` action, show a table with service states
|
|
|
|
4. After `start`, provide clickable URLs:
|
|
- API: http://localhost:8000
|
|
- admin-ui: http://localhost:3456
|
|
- Storybook: http://localhost:6006
|
|
|
|
## Service Details
|
|
|
|
### API Server (port 8000)
|
|
- FastAPI REST API
|
|
- Endpoints: projects, figma, health, config
|
|
- Command: `uvicorn apps.api.server:app --reload`
|
|
- Log: `/tmp/dss-api.log`
|
|
|
|
### Admin UI (port 3456)
|
|
- Preact/Vite development server
|
|
- Design system management interface
|
|
- Command: `npm run dev`
|
|
- Log: `/tmp/dss-admin-ui.log`
|
|
|
|
### Storybook (port 6006)
|
|
- Component documentation
|
|
- Token visualization
|
|
- Command: `npm run storybook`
|
|
- Log: `/tmp/dss-storybook.log`
|
|
|
|
## Troubleshooting
|
|
|
|
If a service fails to start:
|
|
1. Check the log file: `/dss-services logs <service>`
|
|
2. Verify port is not in use: `lsof -i :<port>`
|
|
3. Check dependencies are installed
|
|
|
|
## Related Commands
|
|
|
|
- `/dss-setup` - Full environment setup
|
|
- `/dss-init` - Initialize DSS structure
|
|
- `/dss-reset` - Reset to clean state
|