Kashi
Health Gecti
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 42 GitHub stars
Code Uyari
- process.env — Environment variable access in .github/scripts/github-stats.mjs
- network request — Outbound network request in .github/scripts/github-stats.mjs
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
Open-source Persian design system — RTL-first, dark-first, accessible. React, Web Components, CSS, Tailwind, 13,000 icons, Figma kit and an MCP server. دیزاینسیستم فارسی و متنباز
کاشی (Kashi)
مستندات و نمونهها: kashi.sepantapouya.com · کانال تلگرام: t.me/kashidesign
دیزاینسیستم فارسی و متنباز — 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 توزیع میشود.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi