

کاستومایز
Holographic Referral Cardشو تایم
کارت دعوت هولوگرافیک
کارتِ دعوتِ سهبعدی که با نشانگر سرِ خم میشود و برقِ هولوگرافیک دنبالش میآید؛ عکسِ سیاهوسفیدِ وسط، نشان در بالا و شمارهٔ بلیت پایین — مثلِ بلیتِ سینما.
وابستگیها
نوع تعامل
با حرکتِ موس روی کارت، کارت با فنر سهبعدی سرِ خم میشود و برقِ هولوگرافیک دقیقاً زیرِ نشانگر میدرخشد؛ با خروجِ موس با فنر به حالتِ سکون برمیگردد. روی گوشی هم نگهداشتنِ انگشت همان کارِ هاور را میکند — کارت زیرِ انگشت کج میشود و برق میگیرد — و با رهاکردن برمیگردد؛ اسکرولِ عمودی صفحه سالم میماند. اگر لوگوی دوم لینک باشد، با Tab رویش برق با شدتِ کمتر روشن میشود و حلقهٔ فوکوس لینک را میگیرد. دموی خودکار (اگر روشن باشد) با اولین هاور یا نگهداشتنِ انگشت خاموش میشود و کنترل به کاربر میرسد. با `prefers-reduced-motion` کجشدن و بلندشدن خاموش میشوند ولی برق میماند. کجشدن هندسهٔ فیزیکی است و در RTL آینه نمیشود.
پراپها
گزینههایی که میتونی به کامپوننت بدی؛ ستارهدارها اجباریاند.
imagestringپیشفرض: "/carousel-4.jpg"عکسِ وسطِ کارت؛ با object-cover در قابِ ۳:۴ کشیده میشود و سیاهوسفید با کنتراستِ کم میماند (برق رویش هولوگرافیک دیده شود).
imageAltstringپیشفرض: "عکسِ پسزمینهٔ کارت"متنِ جایگزینِ عکس.
titlestringپیشفرض: "فارسیفای"برچسبِ ردیفِ پایین (سمتِ راست در RTL). اگر بلندتر از کارت شود، بیصدا بریده میشود.
descriptionstringپیشفرض: "دعوتنامه"توضیحِ کنارِ عنوان در ردیفِ پایین — با جوهرِ کمرنگ و درشتتر.
logoCardLogoنشانِ گوشهٔ بالای کارت: هر `ReactNode`، یا `{src, alt, className}`. رشته فقط وقتی عکس حساب میشود که شبیهِ نشانی باشد (`/`، `./`، `http`، یا پسوندِ عکس)؛ وگرنه متن چاپ میشود. پیشفرض آیکنِ Sparkles است.
logoAltstringپیشفرض: "نشان"متنِ جایگزینِ نشان، وقتی `logo` آدرسِ عکس باشد.
نصب
۱. این آدرس رو یکبار توی components.json بذار تا shadcn مخزن فارسیفای رو بشناسه.
{
"registries": {
"@farsify": "https://farsifyui.ir/r/{name}.json"
}
}۲. بعد با دستور زیر کامپوننت رو نصب کن.
npx shadcn@latest add @farsify/invite-cardپیشنیاز: Tailwind CSS v4 و صفحهٔ راستبهچپ dir="rtl".
نمونه
"use client";
import { InviteCard } from "@/components/farsify/invite-card";
export function EventInvite() {
return (
<InviteCard
title="فارسیفای"
description="دعوتنامه"
image="/images/invite.jpg"
imageAlt="عکسِ رویداد"
/>
);
}
// با نشان و شمارهٔ بلیتِ خودت — لوگو آدرسِ عکس، شئِ {src, alt} یا هر ReactNode
<InviteCard
logo={<MyLogo className="size-7 rounded-full" />}
secondLogo={{ src: "/partner.png", alt: "همکار" }}
secondLogoHref="https://example.com"
secondLogoAriaLabel="وبسایتِ همکار"
/>
// کجشدنِ تیزتر و فنرِ پرتحرک — شخصیتِ جسور
<InviteCard tilt={30} stiffness={420} damping={20} />
// گوشهٔ گردتر، برقِ ملایم و فنرِ کشیده — شخصیتِ آرام
<InviteCard radius={24} tilt={10} glow={0.6} stiffness={120} />نکتهها
- کارت همیشه تیره است (`#1f2121`) و در هر دو تمِ سایت همین شکل دیده میشود — مثلِ بلیتِ واقعی که زیرِ نور عوض نمیشود؛ برقِ سفید با mix-blend-overlay روی همین تیرگی مینشیند.
- کجشدن و برق با موس/قلم میآیند و روی گوشی نگهداشتنِ انگشت همان کار را میکند؛ اسکرولِ عمودی با touch-action: pan-y سالم میماند — مرورگر اگر ژست را به اسکرول بدهد، کارت بیصدا به سکون برمیگردد — با Tab اما برقِ کمشدت و حلقهٔ فوکوس میگیری.
- برای بلیتِ برندِ خودت معمولاً فقط `title`، `description`، `logo` و `image` کافی است؛ `tilt`/`glow`/`stiffness`/`damping` همان شخصیتِ حرکتیِ پیشفرض را میدهند.
- هویتهای واریانت با گردیِ گوشهها در سکون هم از هم تشخیصپذیرند (کلاسیک ۱۶، جسور ۶، پرانرژی ۱۰، آرام ۲۴).
- با `prefers-reduced-motion` کارت سرِ خم نمیشود ولی برق با هاور و فوکوس میماند — تجربهٔ لمسِ هولوگرافیک بدونِ حرکت.
همخانوادهها
کامپوننتهای دیگری از همان دسته که با این یکی جور درمیآیند.
مجوز
کد بعد از نصب مال خودته؛ هر تغییری خواستی بده و توی پروژهی خودت نگهش دار. برای پروژههای شخصی و تجاری آزاده، حتی اگه کدت بسته باشه. فقط اسم و لینک فارسیفای رو یه جا توی پروژه نگه دار.