Lewati ke konten

Pakai dengan AI agent

Unduh .md

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.

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.

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.

Terminal window
claude mcp add --transport http sosialoka-design https://design.sosialoka.tech/mcp

Tambahkan --scope project supaya tersimpan di .mcp.json repositori dan dipakai seluruh tim.

Di .cursor/mcp.json proyek, atau ~/.cursor/mcp.json untuk semua proyek:

{
"mcpServers": {
"sosialoka-design": { "url": "https://design.sosialoka.tech/mcp" }
}
}

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"

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.

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

Terminal window
npx shadcn@latest mcp init --client claude

mcp 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.

Tempel cuplikan ini ke file AGENTS.md, CLAUDE.md, GEMINI.md, atau .cursor/rules di repositori produk. File yang sama ada di /AGENTS.md.

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.

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.