Files
dss/dss-claude-plugin/commands/dss-services.md
DSS 08ce228df1
Some checks failed
DSS Project Analysis / dss-context-update (push) Has been cancelled
feat: Add DSS infrastructure, remove legacy admin-ui code
- 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>
2025-12-10 22:15:11 -03:00

2.4 KiB

name, description, arguments
name description arguments
dss-services Manage all DSS development services (API, admin-ui, Storybook)
name description required
action Action to perform (start, stop, status, restart, logs) true
name description required
service Specific service (api, admin-ui, storybook) - optional 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

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

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
  • /dss-setup - Full environment setup
  • /dss-init - Initialize DSS structure
  • /dss-reset - Reset to clean state