B1App
B1App Next.js के साथ बनाया गया सार्वजनिक-सामने वाला चर्च सदस्य एप्लिकेशन है। यह प्रोफ़ाइल, समूह डायरेक्टरी, लाइव स्ट्रीमिंग और दान पृष्ठों सहित सदस्य अनुभव प्रदान करता है।
शुरू करने से पहले
- Node.js 22+ और Git इंस्टॉल करें -- देखें पूर्वापेक्षाएँ
- अपना API लक्ष्य (स्टेजिंग या स्थानीय) कॉन्फ़िगर करें -- देखें पर्यावरण चर
चेतावनी
B1App के लिए Node.js 22 या बाद का संस्करण आवश्यक है। पुराने संस्करण समर्थित नहीं हैं।
सेटअप
1. रिपॉज़िटरी क्लोन करें
git clone https://github.com/ChurchApps/B1App.git
2. डिपेंडेंसी इंस्टॉल करें
cd B1App
npm install
3. पर्यावरण चर कॉन्फ़िगर करें
cp dotenv.sample.txt .env
.env खोलें और NEXT_PUBLIC_*_API एंडपॉइंट URL कॉन्फ़िगर करें। ये स्टेजिंग API या आपके स्थानीय API इंस्टेंस पर पॉइंट कर सकते हैं।
4. डेव सर्वर शुरू करें
npm run dev
Next.js डेव सर्वर http://localhost:3301 पर लॉन्च होता है।
प्रमुख कमांड
| कमांड | विवरण |
|---|---|
npm run dev | पोर्ट 3301 पर Next.js डेव सर्वर शुरू करें |
npm run build | Next.js के माध्यम से प्रोडक्शन बिल्ड |
npm run test | Playwright के साथ एंड-टू-एंड टेस्ट चलाएँ |
npm run lint | Next.js lint चलाएँ |
प्रमुख पर्यावरण चर
| चर | विवरण |
|---|---|
NEXT_PUBLIC_*_API | प्रत्येक मॉड्यूल के लिए API एंडपॉइंट URL |
जानकारी
postinstall स्क्रिप्ट @churchapps/apphelper से लोकेल और CSS फ़ाइलें कॉपी करती है। यदि इंस्टॉल के बाद कंपोनेंट अनस्टाइल्ड दिखते हैं, तो npm run postinstall मैन्युअल रूप से चलाएँ।
तकनीकी स्टैक
- Next.js 16 TypeScript के साथ
- React 19 UI कंपोनेंट के लिए
- Material-UI 7 डिज़ाइन सिस्टम के लिए
- React Query 5 सर्वर स्टेट के लिए
@churchapps/apphelper*साझा कंपोनेंट के लिए पैकेज
डिप्लॉयमेंट
प्रोडक्शन बिल्ड S3 + CloudFront पर डिप्लॉय किए जाते हैं:
npm run buildऑप्टिमाइज़्ड Next.js बिल्ड जनरेट करता है- बिल्ड आउटपुट S3 बकेट पर सिंक किया जाता है
- नया संस्करण सर्व करने के लिए CloudFront इनवैलिडेशन ट्रिगर किया जाता है
सुझाव
विस्तृत डिप्लॉयमेंट निर्देशों के लिए, वेब ऐप डिप्लॉयमेंट गाइड देखें।