Starbase عبارة عن قالب نموذجي لموقع ويب ثابت جاهز للإنتاج يضم Webpack 5 وTypeScript وPostCSS وTailwind CSS تم تصميمه للتكامل مع موفري استضافة Jamstack الحديثين مثل Vercel وNetlify وAWS Amplify. ابدأ البناء في دقائق معدودة باستخدام بعض أقوى تقنيات الواجهة الأمامية المتاحة في عام 2024، والمدعومة بتجربة مطور بسيطة ومبهجة ومميزة بالكامل.
تم إنشاء Starbase بواسطة Brian Staruk كدليل نمطي للكود الشخصي ونموذج مرن للمشروع. إنه عمل مستمر مستمر وتم الحفاظ عليه باستمرار منذ أوائل عام 2017 مع التركيز على تنفيذ أحدث معايير الصناعة والحفاظ على تحديث جميع التبعيات.
"البساطة هي التطور النهائي."
- ليوناردو دافنشي
المهمة الأساسية لـ Starbase هي أن تكون بسيطة بشكل متطور؛ من السهل تكوين وتوسيع ودمج. ويحدث هذا أيضًا لجعله منصة رائعة لمطوري الويب لتعزيز معرفتهم بتكوينات Webpack المعدنية و/أو TypeScript و/أو Tailwind CSS.
للبدء، قم بتشغيل الأمر أدناه، والذي سيرشدك خلال عملية التثبيت:
npx starbase@latest
يوصى باستخدام nvm (أو nvm-windows) لإدارة عمليات تثبيت إصدار Node لديك. إذا كنت لن تستخدم nvm، فستحتاج إلى الرجوع إلى الملف /.nvmrc
للتحقق من أن إصدار Node الخاص بك متوافق مع الإصدار الموصى به.
ابدأ بالتأكد من تشغيل الإصدار الموصى به من Node، وتثبيت تبعيات المشروع:
nvm use
npm install
سيخدم أمر dev
مصدر المشروع على http://localhost:3000. أي تغييرات يتم إجراؤها داخل /src
ستعمل على إعادة ترجمة المصدر وتحديث متصفح الويب الخاص بك.
npm run dev
سيقوم أمر build
بتجميع مصدر المشروع وتصغيره إلى /dist
للتكامل أو النشر.
npm run build
تم إعداد Starbase ليتم نشره على جذر خادم الويب في بيئة استضافة مثل Vercel وNetlify وما إلى ذلك. وعلى هذا النحو، تتم الإشارة إلى جميع الأصول (js وcss والخطوط والصور وما إلى ذلك) بمسارات مطلقة.
إذا كنت ترغب بدلاً من ذلك في الرجوع إلى الأصول عبر المسارات النسبية، بحيث يمكن توزيع ملفات .html
المجمعة وفتحها في متصفح الويب دون الحاجة إلى النشر في بيئة استضافة، فستحتاج إلى إزالة (أو التعليق) على publicPath
في /webpack/webpack.config.base.ts
.
إذا كنت ترغب في الاحتفاظ بالمسارات المطلقة، ولكنك قمت بتعيينها إلى دليل فرعي بدلاً من الجذر، فيمكنك تغيير القيمة بدلاً من إزالتها.
Starbase هو برنامج مجاني ومفتوح المصدر. يرجى بناء أشياء رهيبة معها. يمكنك أن تشتري لي بيرة في المرة القادمة عندما تكون في بوسطن، وتضع نجمة على المشروع وتخبر صديقًا، أو يمكنك مسح كل علامات المنشأ وإخبار زملائك في العمل أنك صنعتها بنفسك. كل شيء جيد!