codu
1.0.0
مساحة للمبرمجين
CODú هو المجتمع النهائي لمطوري الويب للتعلم والمشاركة والحصول على دعم لمشاريعك ، إما كبيرة أو صغيرة. إنه المكان المثالي لشحذ مهاراتك وبناء محفظتك. في CODú ، كلنا هنا لمساعدة بعضنا البعض على النمو كمطورين على الويب. بالإضافة إلى ذلك ، يسهل Codú العثور على متعاونين لمشروعك الكبير التالي.
لدينا مجتمع رائع ينمو على الخلاف. انقر هنا للانضمام!
git clone https://github.com/YOUR_USERNAME/codu.git .cd codu دليل المشروع.npm install.nvmrc . إذا كنت تستخدم nvm ، فيمكنك تشغيل nvm use قبل تثبيت التبعيات..env وأضف المتغيرات التالية. يمكنك نسخ محتويات sample.env مع cat sample.env > .env . # This default value is if you run our local docker-compose.yml file to create the database.
DATABASE_URL=postgresql://postgres:[email protected]:5432/postgres
# Setup your GitHub ID & Secret on GitHub: https://developer.github.com/apps/building-oauth-apps/authorizing-oauth-apps
# For development, make sure you set up this with a Homepage URL of http://localhost:3000/ and an Authorization callback URL of http://localhost:3000/api/auth
GITHUB_ID=YOUR_GITHUB_APP_ID
GITHUB_SECRET=YOUR_GITHUB_APP_SECRET
NEXTAUTH_URL=http://localhost:3000/api/auth
للحصول على دليل أكثر تفصيلاً حول إعدادها ، انتقل إلى قسم متغيرات البيئة.
ملاحظة: قبل المتابعة ، تأكد من تشغيل قاعدة البيانات الخاصة بك.
npm run db:migrateيمكن رؤية الأمر الكامل في ملف package.json الخاص بنا.
npm run db:seedيمكن رؤية الأمر الكامل في ملف package.json الخاص بنا.
npm run devبعد الانتهاء من الأوامر المذكورة أعلاه ، انتقل إلى http: // localhost: 3000 في متصفحك لرؤية النتيجة.
يمكنك بدء رحلتك عن طريق تعديل pages/index.tsx . مع ميزة التحديث التلقائي ، تحديث الصفحات أثناء تحرير الملف.
يتم تعيين دليل pages/api إلى /api/* . يتم التعامل مع الملفات الموجودة في هذا الدليل كطرق API بدلاً من صفحات React.
تعرف على المزيد حول طرق API هنا.
DATABASE_URL عبارة عن سلسلة اتصال لقاعدة بيانات postgresql (الإصدار 15.0).
بشكل افتراضي ، نشير إلى قاعدة بيانات تعمل محليًا مع Docker من ملف docker-compose.yml الخاص بنا.
لتشغيل هذا الملف ، تأكد من تثبيت Docker وأن Docker قيد التشغيل.
تشغيل Command docker compose up .
بدلاً من ذلك ، إذا كان لديك PostgreSQL تعمل محليًا ، فيمكنك استخدام سلسلة الاتصال المحلية أو الاستيلاء على واحدة من خدمة مجانية مثل Supabase.
حاليا ، نسمح فقط المصادقة عبر جيثب. لتمكين هذا ، تحتاج إلى الحصول على قيمة GITHUB_ID و GITHUB_SECRET .
قم بإعداد معرف GitHub & Secret على Github:
للتنمية ، تأكد من إعداد هذا مع عنوان URL للصفحة الرئيسية
http://localhost:3000/
وعنوان الاتصال بالاتصال عن عنوان رد الاتصال
http://localhost:3000/api/auth
بعد النقر فوق الزر "تسجيل تطبيق" ، يجب أن ترى GITHUB_ID وتكون قادرًا على إنشاء سر عميل جديد. بعد إنشاء السر ، تأكد من نسخ هذه القيمة إلى ملف .env الخاص بك حيث لا يمكن رؤية هذه القيمة مرة أخرى بمجرد تحديث الصفحة.
مزيد من المعلومات حول تفويض OAuth في وثائق GitHub هنا.
من أجل استخدام تسجيل الدخول بدون كلمة مرور محليًا ، يجب أن يكون لديك قيمة ACCESS_KEY و SECRET_KEY .
تحقق من مثال .env env هنا لمعرفة كيفية ملء هذه القيم.
ملاحظة: حاليًا ، تم ترميز منطقة AWS لخدمة SNS إلى "EU-West-1" ؛ قد يكون من الضروري تغيير هذا إذا كانت خدمة SNS في منطقة مختلفة.
يجب ألا تحتاج إلى تغيير القيمة الافتراضية هنا. هذا متغير يستخدمه المصادق التالي باعتباره عنوان URL للمصادقة لموقعك.
NEXTAUTH_URL=http://localhost:3000/api/auth
مثال. يمكن العثور على ملف .ev هنا. يمكنك إعادة تسمية هذا إلى .env للبدء.
لمعرفة المزيد حول Next.js ، ألق نظرة على الموارد التالية:
للتعرف على اختصارات المحرر والمفاتيح الساخنة ، يمكنك الاطلاع على هذا المستند:
للحصول على معلومات حول اختبار E2E ، يرجى الرجوع إلى وثائقنا المخصصة هنا.
اهلا وسهلا بكم في فتح القضايا لمناقشة الأفكار حول تحسين كودي. يتم تشجيع التحسينات وتقديرها.
