ScrewFast؛ یه قالب Astro که کل سایتت رو میسازه
خلاصهٔ کاملتر
تو ریپوی پروژه اومده که ScrewFast یه قالب آمادهٔ سایته روی Astro (یعنی فریمورکی که صفحهها رو موقع بیلد به HTML استاتیک تبدیل میکنه)، بههمراه Tailwind CSS و Preline UI. فرقش با تمهای تکمنظوره اینه که چهار نوع سایت رو یکجا میده: لندینگ، بلاگ، کاتالوگ محصول و یه سایت مستندات با Starlight. هر چهارتا از یه MainLayout و نوبار و فوتر مشترک استفاده میکنن.
صفحهها از روی سکشنها چیده میشن و همهٔ متنها بهشکل prop به سکشن پاس داده میشه، برای همین فایل صفحه تنها جاییه که متن رو عوض میکنی. ۱۹ سکشن آماده (هیرو، ویژگیها، قیمتگذاری، نظر مشتریها، FAQ، مگامنو) و ۵۷ قطعهٔ UI مثل کارت و فرم و مودال داخلشه. دادههای تکرارشونده مثل سوالات متداول و پلنهای قیمت هم بهشکل JSON توی src/data_files/ نگهداری میشن.
کارهای حوصلهسربر راهاندازی از قبل انجام شدن. تایتل و description و Open Graph همه از یه فایل constants.ts خونده میشن، دادهٔ ساختاریافتهٔ JSON-LD و sitemap و robots.txt خودکار ساخته میشن، و vercel.json هدرهای امنیتی مثل Content-Security-Policy رو ست میکنه. کامند بیلد هم اول type-check میزنه، بعد خروجی HTML رو minify میکنه و CI روی هر پوش یه تست smoke اجرا میکنه که مسیرهای اصلی جواب بدن.
صفحههای مارکتینگ انگلیسی و فرانسوی دارن و مستندات به ۷ زبان با پشتیبانی RTL ترجمه شده که فارسی هم بینشونه. اگه فقط یه زبان میخوای، برنچ monolingual-site نسخهٔ بدون i18n ـه. یه فایل AI_GUIDE.md هم گذاشتن که به ابزارهایی مثل Cursor و Copilot و Claude بگه هر چیزی کجای پروژهست و قرارداد کدنویسی چیه.
نکات کلیدی:
- استک فعلی: Astro 7، Tailwind CSS 4، Preline 5 و TypeScript 6 که Dependabot بهروز نگهش میداره
- برای اجرا به Node.js 22 و pnpm 9 به بالا نیاز داری؛ سرور توسعه روی پورت 4321 بالا میاد
- ۷۹ کامپوننت: ۱۹ سکشن صفحه و ۵۷ قطعهٔ UI، بهعلاوهٔ ۳۸ آیکون SVG متمرکز توی icons.ts
- خروجی بیلد استاتیکه و هر هاست استاتیکی سرو میکنه؛ برای Vercel و Netlify دکمهٔ دیپلوی آماده داره
- اسکرول نرم با Lenis و انیمیشن با GSAP داخلشه، ولی چون روی دسترسپذیری اثر میذاره میتونی با پاک کردن چند خط برشون داری
- لایسنس MIT با حدود ۱۴۰۰ ستاره و بیش از ۳۸۰ فورک روی گیتهاب




