शुरुआत करें
डाउनलोड से लेकर चलाने, modules जोड़ने, सेटिंग्स, असली बैकएंड जोड़ने, डिज़ाइन और अपडेट तक - पहले दिन के लिए ज़रूरी हर कदम।
कीमत वाले पेज पर PayPal से अपनी ज़रूरत का edition खरीदें। यह एक बार की खरीद है, सब्सक्रिप्शन नहीं।
Header में मेरा अकाउंट → मेरे प्रोडक्ट। React, Vue और Next.js की zip फ़ाइलों में edition फ़ोल्डर और shared mock backend (initfn-mock) साथ-साथ होते हैं।
initfn-react-1.0.0/
initfn-react/ # React edition
initfn-mock/ # mock backend (found at ../initfn-mock - keep both side by side)Node.js 24 (हर edition में .nvmrc देखें) और npm। Vanilla के लिए ज़रूरी नहीं।
पहले mock backend चलाएं, फिर ऐप। admin / 1234 से लॉग इन करें।
cd initfn-mock && npm i && cd ..
cd initfn-react && npm i # initfn-vue for Vue
npm run mock # mock backend http://localhost:4000
npm run dev # React :4001 · Vue :4003 · docs at /docसिर्फ़ Next सर्वर (monolith) से शुरू करें या इसे mock backend से जोड़ें।
cd initfn-nextjs && npm i
npm run mock # when using the mock backend
npm run dev # http://localhost:4002 · docs at /docकोई build step नहीं। इस्तेमाल का तरीका और उदाहरण source देखने के लिए _guide की HTML फ़ाइलें browser में खोलें, फिर अपने पेजों से css, js और font फ़ोल्डर link करें।
React, Vue और Next.js editions में 50 modules में से कोई भी एक कमांड से जोड़ें या हटाएं - स्क्रीन, API और मेन्यू साथ-साथ जुड़ते और हटते हैं।
npm run preset # list modules
npm run preset add social-login mfa # add
npm run preset remove mfa # removeReact, Vue और Next.js एडिशन सेटिंग्स को तीन फ़ाइलों में बाँटते हैं। .env में डेवलपमेंट और प्रोडक्शन दोनों के साझा मान होते हैं (साइट के नाम जैसे, कुछ भी गुप्त नहीं), .env.development सिर्फ़ डेवलपमेंट के लिए और .env.production सिर्फ़ प्रोडक्शन के लिए है। इनमें से कोई भी git में नहीं जाती, और सिर्फ़ आपकी मशीन के मान .env.local में रखें।
.env # shared, not secret - site name, public IDs
.env.development # dev only - local backend URL, sandbox keys
.env.production # production only - live URL, live keys, analytics ID
.env.local # your machine only (overrides the others)module जोड़ने पर उसे चाहिए वाली setting keys सही फ़ाइल के आख़िर में समझाने वाली टिप्पणी के साथ जुड़ जाती हैं, और अंत में बताया जाता है कि कौन-सी keys भरनी बाकी हैं। पहले से मौजूद मान कभी नहीं छुए जाते, और module हटाने पर भी वे नहीं मिटते।
npm run preset add paypal
# -> adds PAYPAL_* keys to .env.development
# and .env.production, then lists keys to fillबैकएंड का पता core/config/apiConfig.js की टेबल में एक लाइन और .env.development (प्रोडक्शन में .env.production) में एक लाइन है। स्क्रीन कोड नहीं बदलता।
# .env.development (production: .env.production)
BACKEND_API_URL=http://your-backend:8080initfn-mock/openapi.yaml बताता है कि frontend कैसी API चाहता है। इसे अपने backend डेवलपर्स को दें - इसी तरह जवाब देने वाला backend बिना कोड बदले जुड़ जाता है।
स्टाइल तीन परतों में बँटे हैं। रंग, फ़ॉन्ट, कोनों की गोलाई और छाया जैसे मान initfn-token.css में, बटन, इनपुट, कार्ड और blocks जैसे छोटे UI का लुक initfn-base.css में, और पेज व सेक्शन जैसे बड़े डिज़ाइन initfn-global.css में लिखे जाते हैं। सिर्फ़ ब्रांड रंग बदलना हो तो token फ़ाइल के आख़िर में --color-brand-* ही बदलें।
src/core/style/ # Vanilla: css/ · font/ · image/
css/initfn-token.css # values - colors, fonts, radius, shadows
css/initfn-base.css # small UI, components, blocks
css/initfn-global.css # pages and sections
font/ image/मॉकअप या चाहा गया अंदाज़ दें और कहें कि पहले आपके एडिशन में शामिल design skill पढ़कर बदलाव करे। यह skill हर तरह के अनुरोध के लिए तय करती है कि कौन-सी फ़ाइल बदलनी है, इसलिए AI स्क्रीन कोड को छोड़कर इन्हीं तीन फ़ाइलों को बदलता है।
.claude/skills/ssr-design/ # Next.js
.claude/skills/csr-design/ # React
.claude/skills/vue-design/ # Vue
.claude/skills/vanilla-design/ # VanillaCSS में हर नियम एक लाइन में लिखा जाता है (सिर्फ़ token फ़ाइल में लाइन ब्रेक), और VS Code में सेव करते ही अपने-आप ठीक हो जाता है। फ़ॉन्ट में Pretendard के सिर्फ़ वही हिस्से लोड होते हैं जो स्क्रीन को चाहिए, इसलिए पहली स्क्रीन के फ़ॉन्ट लगभग 1MB हैं। React, Vue और Next.js एडिशन में साझा Image component इमेज को ज़रूरत पड़ने पर लोड करता है और avif/webp में हल्का भेजता है।
npm run format # tidy CSS - one rule per line
node scripts/format-css.mjs # VanillaReact, Vue और Next.js एडिशन में नए zip के .preset फ़ोल्डर से अपने प्रोजेक्ट का .preset overwrite करें और फिर update चलाएँ। सूची में ⬆ का मतलब है इंस्टॉल किए module का नया वर्ज़न, और 🆕 का मतलब है नया module। आपकी बदली फ़ाइलें कभी overwrite नहीं होतीं - नया वर्ज़न उनके पास .preset-new के रूप में रखा जाता है, तुलना करके मिलाएँ और फिर उसे हटा दें।
# 1. copy .preset from the new zip over your project's .preset
npm run preset # 2. list - ⬆ update available · 🆕 new module
npm run preset update # 3. update installed modules
npm run preset add <name> # 4. add a new module
npm run lint && npm test && npm run buildकौन-से modules किस वर्ज़न में जोड़े गए, यह प्रोजेक्ट रूट की preset.lock.json में दर्ज रहता है। यह .preset फ़ोल्डर के बाहर है ताकि फ़ोल्डर overwrite करने पर भी रिकॉर्ड बना रहे - इसे भी git में commit करें।
अगर core और shared जैसे बेस कोड के सुधार भी लेने हैं, तो zip से एक git repository शुरू करें और बिना बदला original initfn branch पर रखें। अपना काम main पर करें।
git init && git add . && git commit -m "initfn 1.0.0"
git branch initfn # untouched originalअकाउंट से नया zip डाउनलोड करें, उसे initfn branch पर overwrite करें, main में merge करें और फिर npm run preset update से इंस्टॉल किए modules भी मिला लें। सिर्फ़ वही जगहें conflict दिखाती हैं जिन्हें आपने खुद बदला है। क्या बदला, यह रिलीज़ नोट्स में है।
git switch initfn
# unzip the new version over it (keep node_modules and your .env files)
git add -A && git commit -m "initfn 1.1.0"
git switch main && git merge initfn
npm run preset update # sync installed modulesहर edition में कमांड के नाम एक जैसे हैं।
npm run lint && npm test # rules and unit tests
npm run build # production build
npm run test:e2e # browser E2EDeployment ऐप के अंदर की डेवलपर गाइड (/doc) में है। End Product को deploy या deliver करते समय edition की THIRD_PARTY_NOTICES.md (open-source notices) शामिल करें।
पूरी, विस्तृत गाइड प्रोजेक्ट archive के अंदर आती है। यह पेज सिर्फ़ पहले दिन की ज़रूरी बातें बताता है। बाकी सब - इंस्टॉलेशन, सेटिंग्स, components, modules और deployment - डाउनलोड किए गए archive में है: बिल्ट-इन गाइड साइट (7 भाषाएं), README और AI coding tools के लिए docs (AGENTS.md)।
FAQ और license देखें, या हमें numerxlab@gmail.com पर बताएं।