# VibeFarsi (وایب‌فارسی)

> کامپوننت‌های راست‌چین رایگان برای Next.js و React. فایل را کپی کنید یا پرامپت انگلیسی را به Cursor بدهید. فونت و اعداد فارسی داخل خود کامپوننت است.

VibeFarsi is a copy-into-your-repo RTL UI kit for Persian (Farsi) React and Next.js apps. It is not an npm package of React components. `npx vibefarsi` writes files into the project; after that the code is yours.

## What it is
- Native RTL components (layout, icons, focus), not a `dir="rtl"` wrapper on a LTR kit
- Persian digits, toman, Jalali calendar, IBAN/Sheba, national ID, Iranian plate
- English prompts plus an MCP server so coding agents follow Persian rules
- Agent skills (SKILL.md) and guides for Persian writing, RTL UI, Jalali dates, Iranian validation, SEO, ParsPack S3 upload, Zarinpal payments and Kavenegar OTP
- Free and open source

## What it is not
- Not a runtime you import from `node_modules` (the npm package is the CLI / MCP only)
- Not a left-to-right shadcn port
- Not a hosted design tool

## Install
```
npx vibefarsi@latest init
npx vibefarsi add button calendar price
npx vibefarsi list
```

Docs: https://vibefarsi.ir/docs
MCP: https://vibefarsi.ir/mcp  (also `npx -y @vibefarsi/mcp`)

## Counts
- 70 components
- 23 blocks
- 63 animations
- 44 backgrounds
- 30 templates
- 6 design systems
- 14 skills and guides

## Site map
- Home: https://vibefarsi.ir/
- Quick start: https://vibefarsi.ir/docs
- About: https://vibefarsi.ir/about
- Components: https://vibefarsi.ir/components
- Blocks: https://vibefarsi.ir/blocks
- Animations: https://vibefarsi.ir/animations
- Backgrounds: https://vibefarsi.ir/backgrounds
- Templates: https://vibefarsi.ir/templates
- Themes: https://vibefarsi.ir/themes
- Skills: https://vibefarsi.ir/skills
- Full catalog: https://vibefarsi.ir/llms-full.txt