Pakai dengan AI agent
AI agent bisa membaca seluruh design system dalam format terbuka, jadi agent apa pun, Claude atau bukan, membangun UI dengan token, komponen, dan pola yang sama dengan dokumentasi ini.
Yang bisa dibaca agent
Section titled “Yang bisa dibaca agent”| Sumber | Kegunaan |
|---|---|
URL halaman + .md, misalnya /id/components/button.md |
Satu halaman dalam Markdown. Setiap halaman juga punya tombol Salin sebagai Markdown dan Unduh .md. |
| /id/llms.txt dan /llms.txt | Indeks semua halaman beserta ringkasan satu kalimat (llmstxt.org). |
| /id/llms-full.txt dan /llms-full.txt | Semua halaman dalam satu file. |
/tokens.json dan /tokens/<theme>.json |
Semua token dalam format DTCG, dan nilai jadi satu tema. |
| /r/react/registry.json dan /r/vue/registry.json | Registry shadcn untuk komponen React dan Vue. |
| /sosialoka-design-system-docs.zip | Semua yang di atas dalam satu unduhan. |
https://design.sosialoka.tech/mcp |
MCP server: pencarian, halaman, komponen, pola, dan token sebagai tool. |
Sambungkan MCP server
Section titled “Sambungkan MCP server”Server ini memakai MCP lewat Streamable HTTP di https://design.sosialoka.tech/mcp. Tidak perlu login, karena semua isinya publik. Beri nama sosialoka-design supaya cuplikan AGENTS.md di bawah bisa menemukannya.
Claude Code
Section titled “Claude Code”claude mcp add --transport http sosialoka-design https://design.sosialoka.tech/mcpTambahkan --scope project supaya tersimpan di .mcp.json repositori dan dipakai seluruh tim.
Cursor
Section titled “Cursor”Di .cursor/mcp.json proyek, atau ~/.cursor/mcp.json untuk semua proyek:
{ "mcpServers": { "sosialoka-design": { "url": "https://design.sosialoka.tech/mcp" } }}VS Code
Section titled “VS Code”Di .vscode/mcp.json:
{ "servers": { "sosialoka-design": { "type": "http", "url": "https://design.sosialoka.tech/mcp" } }}Di ~/.codex/config.toml:
[mcp_servers.sosialoka-design]url = "https://design.sosialoka.tech/mcp"Gemini CLI
Section titled “Gemini CLI”Di ~/.gemini/settings.json, atau .gemini/settings.json proyek:
{ "mcpServers": { "sosialoka-design": { "httpUrl": "https://design.sosialoka.tech/mcp" } }}Setiap tool mengembalikan Markdown. Tool yang menerima locale memakai en (bawaan) atau id.
| Tool | Argumen | Hasil |
|---|---|---|
search_docs |
query, locale, limit |
Halaman yang cocok, beserta path untuk get_page. |
get_page |
path, locale |
Satu halaman. Path bisa berupa foundations/color, /id/content/, atau URL halaman lengkap. |
list_components |
tidak ada | Semua komponen beserta framework-nya, dan semua pola halaman. |
get_component |
name, platform, locale |
Panduan komponen beserta perintah pasang dan kodenya. platform (react, vue, atau flutter) menyisakan kode satu platform saja. |
get_tokens |
theme |
Nilai jadi satu tema. Tanpa theme, hasilnya daftar tema dan tautan ke file DTCG lengkap. |
list_themes |
tidak ada | Daftar tema dan cara menggantinya. |
get_pattern |
name, locale |
Satu pola halaman, misalnya login, dashboard, list, atau form, beserta kodenya. |
Pasang komponen lewat MCP shadcn
Section titled “Pasang komponen lewat MCP shadcn”Registry React juga bisa dipakai lewat MCP server resmi shadcn, jadi agent bisa mencari komponen Sosialoka dan memasangnya berdasarkan nama. Tambahkan registry-nya ke components.json:
{ "registries": { "@sosialoka": "https://design.sosialoka.tech/r/react/{name}.json" }}Lalu siapkan MCP server shadcn untuk agent-mu (claude, cursor, atau vscode):
npx shadcn@latest mcp init --client claudemcp init belum bisa menulis konfigurasi Codex. Untuk Codex, tambahkan ini ke ~/.codex/config.toml:
[mcp_servers.shadcn]command = "npx"args = ["shadcn@latest", "mcp"]Minta item berdasarkan nama registry-nya, misalnya “add @sosialoka/button”. MCP shadcn melayani registry React. Di proyek Vue, agent mengambil perintah pasang shadcn-vue dari get_component atau dari halaman komponen.
Tambahkan aturannya ke repo-mu
Section titled “Tambahkan aturannya ke repo-mu”Tempel cuplikan ini ke file AGENTS.md, CLAUDE.md, GEMINI.md, atau .cursor/rules di repositori produk. File yang sama ada di /AGENTS.md.
## Sosialoka Design System
This product uses the Sosialoka Design System (https://design.sosialoka.tech). Follow it for every UI change.
- **Read before you build.** Index: https://design.sosialoka.tech/llms.txt (Indonesian: https://design.sosialoka.tech/id/llms.txt). Every page is Markdown at its URL + `.md`.- **Use the MCP server when it is connected** (`sosialoka-design`, https://design.sosialoka.tech/mcp): `search_docs`, `get_component` with `platform`, `get_pattern`, `get_tokens` with a theme.- **Install components from the registry; don't rewrite them.** - React: `npx shadcn@latest add https://design.sosialoka.tech/r/react/<name>.json` - Vue: `npx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/<name>.json` - Install your product's theme first: https://design.sosialoka.tech/web.md - Flutter: the `sosialoka_ui` package (https://design.sosialoka.tech/flutter.md).- **Use tokens, never raw values:** `bg-primary`, `text-muted-foreground`, `border-input`, `rounded-md`. No hex colors, no pixel radius.- **Set the theme on the root element:** `data-brand` = your product (`lokamusik`, `coverclearance`, `lokasign`, `mylokalink`), or `neutral` when the screen belongs to no product; `data-theme` = `light` or `dark`.- **Icons:** Lucide. **UI font:** Plus Jakarta Sans.- **Labels sit above inputs.** One primary action per screen.- **Copy** (https://design.sosialoka.tech/content.md): Indonesian uses "kamu", never "Anda". Short, active sentences. Error messages come from the backend; the client only disables the button.Unduh semuanya
Section titled “Unduh semuanya”sosialoka-design-system-docs.zip berisi setiap halaman dalam Markdown berbahasa Inggris dan Indonesia, file llms.txt dan llms-full.txt, tokens.json, satu file tokens/<theme>.json per tema, dan AGENTS.md. Paket ini dibangun ulang setiap kali situs dirilis.
