بسته به نقطه شروع پروژه، یکی از روشهای زیر را انتخاب کنید.
ساخت یک پروژه جدید Vite مستقیماً از طریق ترمینال.
پیکربندی FarsiUI در یک پروژه موجود Vite.
دستور init را اجرا کنید تا یک پروژه جدید Vite ساخته شود. در ادامه میتوانید تنظیمات پروژه مانند base، preset، monorepo و موارد دیگر را انتخاب کنید.
برای پروژههای monorepo از فلگ --monorepo استفاده کنید:
کامپوننت Card را به پروژه خود اضافه کنید:
اگر پروژه را بهصورت monorepo ساختهاید، دستور را از مسیر apps/web اجرا کنید یا workspace را از ریشه پروژه مشخص کنید:
دستور بالا کامپوننت Card را به پروژه اضافه میکند. سپس میتوانید آن را به شکل زیر import کنید:
import {
Card,
CardContent,
CardDescription,
CardHeader,
CardTitle,
} from "@/components/ui/card"
function App() {
return (
<Card className="max-w-sm">
<CardHeader>
<CardTitle>نمای کلی پروژه</CardTitle>
<CardDescription>
پیشرفت و فعالیتهای اخیر اپلیکیشن Vite خود را دنبال کنید.
</CardDescription>
</CardHeader>
<CardContent>
سیستم طراحی شما آماده است. ساخت کامپوننت بعدی را شروع کنید.
</CardContent>
</Card>
)
}
export default Appاگر پروژه را بهصورت monorepo ساختهاید، فایل apps/web/src/App.tsx را ویرایش کنید و کامپوننت را از @workspace/ui/components/card import کنید.
اگر به یک پروژه جدید Vite نیاز دارید، ابتدا یک پروژه بسازید و قالب React + TypeScript را انتخاب کنید. در غیر این صورت، از این مرحله عبور کنید.
اگر Tailwind CSS از قبل در پروژه شما پیکربندی شده است، از این مرحله عبور کنید.
تمام محتوای فایل src/index.css را با کد زیر جایگزین کنید:
@import "tailwindcss";اگر alias مربوط به @/* از قبل در پروژه شما تنظیم شده است، از این مرحله عبور کنید.
Vite تنظیمات TypeScript را بین چند فایل تقسیم میکند. ویژگیهای baseUrl و paths را به بخش compilerOptions در فایلهای tsconfig.json و tsconfig.app.json اضافه کنید:
{
"files": [],
"references": [
{
"path": "./tsconfig.app.json"
},
{
"path": "./tsconfig.node.json"
}
],
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["./src/*"]
}
}
}همان alias را به tsconfig.app.json اضافه کنید تا ویرایشگر کد بتواند importها را بهدرستی تشخیص دهد:
{
"compilerOptions": {
// ...
"baseUrl": ".",
"paths": {
"@/*": [
"./src/*"
]
}
// ...
}
}@types/node را نصب کنید و فایل vite.config.ts را بهروزرسانی کنید تا Vite بتواند alias مربوط به @ را resolve کند:
import path from "path"
import tailwindcss from "@tailwindcss/vite"
import react from "@vitejs/plugin-react"
import { defineConfig } from "vite"
// https://vite.dev/config/
export default defineConfig({
plugins: [react(), tailwindcss()],
resolve: {
alias: {
"@": path.resolve(__dirname, "./src"),
},
},
})دستور init را اجرا کنید تا FarsiUI در پروژه شما پیکربندی شود:
حالا میتوانید کامپوننتهای موردنیاز خود را به پروژه اضافه کنید:
دستور بالا کامپوننت Button را به پروژه اضافه میکند. سپس میتوانید آن را به شکل زیر import کنید:
import { Button } from "@/components/ui/button"
function App() {
return (
<div className="flex min-h-svh flex-col items-center justify-center">
<Button>کلیک کنید</Button>
</div>
)
}
export default App