English Français العربية

io.github.basalt-run/basalt

السجل الرسمي الوسائط والتصميم

Design tokens, components, icons, and a11y data via MCP. For Cursor, Claude, and Windsurf.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (sse)
Claude Code 
claude mcp add --transport sse basalt 'https://basalt.run/api/mcp' --header 'Authorization: <Basalt API key from https://basalt.run Settings>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "basalt": {
            "type": "sse",
            "url": "https://basalt.run/api/mcp",
            "headers": {
                "Authorization": "<Basalt API key from https://basalt.run Settings>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Basalt Design System
  2. What's in this repo
  3. Using these tokens with AI tools
  4. Token architecture
  5. Links
  6. License

Basalt Design System

Design tokens in Git. Readable by AI. Beautiful to edit.

This repo is managed by Basalt — a design system platform that stores tokens, components, and documentation in Git and serves them to AI coding tools via MCP.

What's in this repo

tokens/
├── primitives.json        # Raw values (colors, spacing, radii)
├── semantic.light.json    # Light theme semantic tokens
└── semantic.dark.json     # Dark theme semantic tokens

All tokens use the DTCG 2025.10 format (W3C standard).

Using these tokens with AI tools

Basalt serves this design system to Cursor, Claude Code, Claude Design, and Windsurf via an MCP server. AI tools query your real token values instead of guessing.

See MCP.md for setup instructions and available tools.

Quick config (Cursor / Claude Code / Windsurf):

{
  "mcpServers": {
    "basalt": {
      "url": "https://basalt.run/api/mcp",
      "headers": {
        "Authorization": "Bearer bsk_your_key_here"
      }
    }
  }
}

Get a free API key at basalt.run.

Token architecture

Three tiers, each referencing the layer above:

Primitive → raw values (color.orange.500 = #F97316) Semantic → intent + theming (color.action.default → color.orange.500) Component → scoped to UI elements (button.background.default → color.action.default)

AI tools resolve the full chain automatically via MCP.

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو io.github.basalt-run/basalt؟

Design tokens, components, icons, and a11y data via MCP. For Cursor, Claude, and Windsurf.

كيف أثبّت io.github.basalt-run/basalt؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport sse basalt 'https://basalt.run/api/mcp' --header 'Authorization: <Basalt API key from https://basalt.run Settings>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.basalt-run/basalt إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.basalt-run/basalt مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.basalt-run/basalt؟

ينشره basalt-run. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.