Kashi

mcp
Security Audit
Warn
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 42 GitHub stars
Code Warn
  • process.env — Environment variable access in .github/scripts/github-stats.mjs
  • network request — Outbound network request in .github/scripts/github-stats.mjs
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Open-source Persian design system — RTL-first, dark-first, accessible. React, Web Components, CSS, Tailwind, 13,000 icons, Figma kit and an MCP server. دیزاین‌سیستم فارسی و متن‌باز

README.md

کاشی (Kashi)

مستندات و نمونه‌ها: kashi.sepantapouya.com · کانال تلگرام: t.me/kashidesign

CI
npm
License: MIT
Telegram

Stars
Clones
Unique cloners
npm downloads

دیزاین‌سیستم فارسی و متن‌باز — RTL-first، Dark-first، دسترس‌پذیر و کاملاً قابل‌سفارشی‌سازی، برای React و هر فریم‌ورک دیگری. با الهام از Untitled UI.

پکیج کاربرد
@kashi-ui/tokens رنگ، فاصله، فونت و… به شکل CSS Variables، JSON و JS
@kashi-ui/css استایل کامپوننت‌ها با CSS خالص — برای هر فریم‌ورکی
@kashi-ui/persian تاریخ شمسی، ارقام فارسی، اعتبارسنجی کد ملی و کارت؛ بدون وابستگی
@kashi-ui/bank-logos لوگوی SVG ۴۰ بانک و ۱۰ درگاه پرداخت ایران (CC0)
@kashi-ui/icons ۱۳۰۰۰ آیکون کاشی در شش سبک؛ React، SVG و اسپرایت
@kashi-ui/react کامپوننت‌های React
@kashi-ui/elements وب کامپوننت‌ها برای Vue، Svelte، Angular، وردپرس و HTML: فیلدهای فارسی، تقویم شمسی، فرم نشانی، نقشهٔ ایران، جدول داده، Combobox، منو، پنجره و اعلان
@kashi-ui/tailwind پریست Tailwind 3 و 4: توکن‌های کاشی به‌شکل کلاس‌های Tailwind، همگام با تم
@kashi-ui/mcp سرور MCP برای Claude، Cursor و دیگر دستیارهای هوش مصنوعی

پایدار برای محصولات سازمانی (۱.۰)

  • دوزبانه: با <KashiProvider locale="en"> (یا setLocale("en") در وب کامپوننت‌ها) همهٔ متن‌های داخلی، ارقام و نام ماه‌ها انگلیسی می‌شوند. راهنما
  • سیاست تغییرات: SemVer، منسوخ کردن پیش از حذف و راهنمای مهاجرت برای هر نسخهٔ اصلی.
  • امنیت: گزارش خصوصی آسیب‌پذیری با زمان پاسخ مشخص.
  • سقف حجم: هر کامپوننت سقف حجم دارد و تست نمی‌گذارد بی‌اجازه بزرگ‌تر شود.
  • تست تصویری: از همهٔ نمونه‌ها در تم روشن و تیره عکس گرفته و با عکس مرجع مقایسه می‌شود (npm run test:visual).

کامپوننت‌ها

Button · Input · Textarea · Select · Checkbox · RadioGroup · Switch · Badge · Card · Alert · Avatar · AvatarGroup · Tabs · Dialog · Toast · Tooltip · DropdownMenu · DataTable · Pagination · Breadcrumb · Accordion · Stepper · Progress · Spinner · Skeleton · EmptyState · Divider · Kbd · RelativeTime · Combobox · MultiSelect · CommandPalette · TagInput · FileUpload · Slider · NumberInput · Popover · StatCard · Timeline · SideNav · SegmentedControl · CopyButton · Banner · Rating · TreeView · ButtonGroup · ChipGroup · PasswordStrength · BarChart · LineChart · ContextMenu · InlineEdit · PieChart · BarList · ProportionBar · Sparkline · Carousel · ColorPicker · Tour · Meter · Splitter

فارسی: DatePicker و Calendar شمسی · DateRangePicker (بازهٔ تاریخ شمسی) · TimeInput (ساعت) · PostalCodeInput (کد پستی) · PlateInput (پلاک خودرو) · LandlineInput (تلفن ثابت) · MonthPicker (ماه شمسی) · Countdown (شمارش معکوس) · ActivityHeatmap (نقشهٔ فعالیت شمسی) · ProvinceSelect (استان) · NationalIdInput (کد ملی) · CardNumberInput (شماره کارت با لوگوی بانک) · IbanInput (شبا) · MobileInput (موبایل) · PriceInput (مبلغ به حروف) · OtpInput (کد تأیید) · ابزارهای @kashi-ui/persian

نصب

npm install @kashi-ui/react @kashi-ui/css
import "@kashi-ui/css";
import { Button } from "@kashi-ui/react";

<Button variant="primary">ثبت‌نام</Button>

بدون React (HTML، Vue، Svelte، Angular، وردپرس) با وب کامپوننت‌ها:

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@kashi-ui/css/dist/kashi.css">
<script type="module" src="https://cdn.jsdelivr.net/npm/@kashi-ui/elements/dist/cdn/kashi-elements.js"></script>

<button class="k-btn k-btn--primary">ثبت‌نام</button>
<kashi-national-id name="national_id" required></kashi-national-id>
<kashi-date-picker label="تاریخ تولد" name="birth"></kashi-date-picker>

راهنما: kashi.sepantapouya.com/docs/web-components

Tailwind

npm i @kashi-ui/tailwind
@import "@kashi-ui/tailwind"; /* اول بیاید تا کلاس‌های Tailwind بر کامپوننت‌ها برنده باشند */
@import "tailwindcss";
@import "@kashi-ui/css";

حالا bg-brand، text-secondary، border-brand، rounded-lg و shadow-md همان توکن‌های کاشی‌اند و با تم تیره و روشن و createTheme عوض می‌شوند. راهنما و Tailwind 3: kashi.sepantapouya.com/docs/tailwind

استفاده با هوش مصنوعی

سرور MCP کاشی دستیارهای هوش مصنوعی را به مستندات، آیکون‌ها، توکن‌ها و ابزارهای فارسی کاشی وصل می‌کند:

claude mcp add kashi -- npx -y @kashi-ui/mcp

تنظیمات Cursor، VS Code و بقیه: kashi.sepantapouya.com/docs/ai · کل مستندات برای مدل‌های زبانی: llms-full.txt

فیگما

پلاگین Kashi UI Kit کل دیزاین‌سیستم را از روی همین کد در فیگما می‌سازد:

  • حدود ۲۷۰ Variable با تم تیره/روشن، گردی، تراکم، فونت و سایه؛ بدون Style
  • بیش از ۷۰ کامپوننت با حدود ۷۰۰ variant، هر کدام در یک صفحه، شامل کامپوننت‌های فارسی و لوگوی همهٔ بانک‌ها
  • به‌روزرسانی درجا با هر نسخهٔ جدید

دانلود و راهنما: kashi.sepantapouya.com/docs/figma

توسعه

npm install
npm run build
npm test      # همهٔ تست‌ها، تست دوزبانه و سقف حجم (npm run size)
npm run docs:build && npm run test:visual   # تست تصویری؛ عکس مرجع تازه: npm run test:visual:update
npm run dev   # پیش‌نمایش در http://localhost:4321/playground/
npm run docs  # سایت مستندات در http://localhost:4400 (Node 24، طبق .nvmrc)

سفارشی‌سازی

import { createTheme } from "@kashi-ui/tokens";
// یک رنگ برند → کل طیف رنگی ساخته می‌شود
const css = createTheme({ brand: "#7c3aed", radius: 1.5, density: 0.875 });

یا مستقیم با CSS (همهٔ استایل‌های کاشی در Cascade Layer هستند، پس CSS شما همیشه برنده است):

:root {
  --k-brand-500: #7c3aed;
  --k-radius-factor: 0;     /* گوشه‌های تیز */
  --k-btn-font-weight: 500;
}

دسترس‌پذیری

هدف WCAG 2.2 AA است. کنتراست همهٔ جفت‌رنگ‌ها در هر بیلد خودکار بررسی می‌شود، و فوکوس کیبورد، صفحه‌خوان، forced-colors، prefers-contrast و prefers-reduced-motion پشتیبانی می‌شوند.

مشارکت

مخزن: github.com/Sepantapouya/Kashi

کانال تلگرام کاشی برای خبر نسخه‌ها، کامپوننت‌های تازه و نکته‌های طراحی فارسی: t.me/kashidesign

کاشی متن‌باز است (MIT). راهنما: CONTRIBUTING.md
ریسرچ و نقشهٔ راه: docs/RESEARCH.md · انتشار نسخه: RELEASING.md

ساخته‌شده توسط سپنتا پویا.

فونت وزیرمتن اثر صابر راستی‌کردار است و تحت لایسنس SIL OFL 1.1 توزیع می‌شود.

Reviews (0)

No results found