GitHub इंटीग्रेशन: संपूर्ण गाइड

अपने मोबाइल से Git और GitHub

पहले मोबाइल से रिपॉज़िटरी प्रबंधित करना जटिल हुआ करता था। PocketCode में Git बिल्ट-इन है (JGit लाइब्रेरी, कुछ इंस्टॉल करने की ज़रूरत नहीं), इसलिए रोज़ का पूरा चक्र आपके फ़ोन से चलता है: क्लोन, stage, commit, push और pull request। यह गाइड असली स्क्रीन के हिसाब से चलती है; हर स्क्रीन की पूरी जानकारी Git और GitHub डॉक्स में है।

प्रारंभिक सेटअप

1. अपना GitHub अकाउंट कनेक्ट करें

1. Settings → Integrations → Connected Services खोलें और GitHub चुनें
2. Sign in with a code पर टैप करें, फिर Get a code from GitHub पर
3. Open GitHub पर टैप करें, खुलने वाले पेज (github.com/login/device) पर PocketCode का दिखाया कोड डालें और मंज़ूर करें (OAuth device flow)
4. शीट खुली रखें: आपके मंज़ूर करते ही वह अपने आप कनेक्ट हो जाती है

कॉपी करने के लिए कोई टोकन नहीं है। कोड लगभग 15 मिनट चलता है; एक्सपायर हो जाए तो नया माँग लें। Free प्लान में हर प्रोवाइडर का पहला अकाउंट शामिल है; और अकाउंट कनेक्ट करना Pro है।

2. एक रिपॉज़िटरी क्लोन करें

1. Projects में जाएँ और Clone पर टैप करें
2. Clone from GitHub (या GitLab / Bitbucket) चुनें। अगर अभी कनेक्ट नहीं किया है तो पहले Connect पर टैप करें
3. अपनी रिपॉज़िटरी में से एक चुनें (खोज भी सकते हैं) और Clone पर टैप करें

रिपॉज़िटरी एक नए प्रोजेक्ट के रूप में दिखती है। अगर वह नाम पहले से है तो क्लोन के नाम में repo (2) जैसा suffix जुड़ जाता है। आप अपनी ही रिपॉज़िटरी की सूची से क्लोन करते हैं और सिर्फ़ HTTPS से: SSH remote और URL पेस्ट करके क्लोन करना समर्थित नहीं है। लोकल टर्मिनल में git प्रोग्राम नहीं है, इसलिए वहाँ git clone नहीं चलता; Clone टाइल इस्तेमाल करें।

बुनियादी वर्कफ़्लो

बदलाव करें

1. फ़ाइलें सामान्य रूप से एडिट करें
2. रिपॉज़िटरी में फ़ाइल एक्सप्लोरर बदली हुई फ़ाइलों पर निशान लगाता है, और स्टेटस बार ब्रांच को उसके ↑↓ काउंट के साथ दिखाता है
3. Source Control खोलें (एडिटर मेनू → Git, या फ़िज़िकल कीबोर्ड पर Ctrl+Shift+G, या स्टेटस बार में ब्रांच के नाम पर टैप) और किसी फ़ाइल पर टैप करके उसका diff देखें: जोड़ी और हटाई गई पंक्तियाँ एक ही सूची में

Commit और Push

एडिटर में:

• Source Control खोलें
• बदलाव देखें और जो फ़ाइलें चाहिए उन्हें Stage करें (सब के लिए Stage All, या फ़ाइल के सिर्फ़ एक हिस्से के लिए Stage by hunk)
• commit संदेश लिखें और Commit पर टैप करें
• हेडर में Push आइकन पर टैप करें

एडिटर commit, push या pull के बाद सफलता या त्रुटि का संदेश नहीं दिखाता: नतीजा सूचियों और ↑↓ काउंटर से परखें। अगर push कुछ करता नहीं दिखे तो उसे Projects से दोहराएँ, वहाँ त्रुटि दिखती है।

Projects में प्रोजेक्ट कार्ड से भी आप Commit पर टैप करके फ़ाइलें चुन सकते हैं, संदेश लिखकर Commit & Push दबा सकते हैं (जब प्रोजेक्ट में remote हो)। पहले Git में Your name on commits सेट करें।

AI message बटन चार शैलियों में commit संदेश सुझाता है, लेकिन वह AI नहीं है: यह आपकी बदली हुई फ़ाइलों के नामों से बना लोकल, नियम-आधारित सुझाव है, इसमें कोई मॉडल या कुंजी शामिल नहीं।

उन्नत सुविधाएँ

1. ब्रांच प्रबंधन

• बनाना और बदलना: प्रोजेक्ट कार्ड पर Git टैप करें, फिर Branch। किसी ब्रांच पर टैप करके उस पर जाएँ, या Create new branch करें। ये पंक्तियाँ तब दिखती हैं जब प्रोजेक्ट में remote (origin) हो; टर्मिनल का Git Panel भी लोकल ब्रांच बदल और बना सकता है
• Merge: Source Control में Merge टैप करें, अपनी लोकल ब्रांचों में से एक चुनें और Merge into main (या जिस ब्रांच पर आप हैं) टैप करें
• Compare: Compare दिखाता है कि दो लोकल ब्रांच कितनी दूर हैं: आगे और पीछे के commit, और बदली हुई फ़ाइलें

इन सूचियों में सिर्फ़ लोकल ब्रांच दिखती हैं।

2. Pull Requests

एडिटर के Git मेनू से GitHub PRs & Issues खोलें। यह उन प्रोजेक्ट के साथ चलता है जिनका origin github.com पर है और आपके कनेक्ट किए अकाउंट का इस्तेमाल करता है।

1. अपने बदलाव किसी ब्रांच में करें
2. ब्रांच push करें (प्रोजेक्ट की Git शीट में Upload changes)
3. PRs टैब में New pull request from … पर टैप करें
4. शीर्षक और विवरण भरें, base और head ब्रांच चुनें (चाहें तो draft के रूप में)
5. Create pull request पर टैप करें

इसी शीट में Issues, CI और Alerts टैब भी हैं। pull request पर आप Merge (merge commit, squash या rebase), Close PR और comment कर सकते हैं।

3. Conflict सुलझाएँ

PocketCode में conflict सुलझाने का एक ही guided resolver है, और वह interactive rebase के अंदर है: हर conflicting ब्लॉक के लिए आप Ours, Theirs या Both चुनते हैं। conflict वाले merge या pull के लिए कोई resolver नहीं है: conflict मार्कर (<<<<<<<, =======, >>>>>>>) आपकी फ़ाइलों में रह जाते हैं और एडिटर conflict वाली फ़ाइलों की सूची नहीं देता। प्रभावित फ़ाइलें खोलें, जो संस्करण चाहिए उसे रखें, मार्कर हटाएँ, फिर stage और commit करें।

4. बदलाव Stash करें

Source Control से बदलावों को अस्थायी रूप से सहेजें: Stash टैप करें, फिर Stash changes। किसी एंट्री पर टैप करके Apply, Pop या Drop करें। ध्यान रखें: नई (untracked) फ़ाइलें stash नहीं होतीं, stash संदेश सहेजा नहीं जाता, और Pop हमेशा सबसे नई एंट्री लेता है।

5. Rebase और Cherry-pick

Interactive rebase (Pick, Reword, Squash, Fixup, Drop, restore हो सकने वाले backup के साथ) और Cherry-pick (commit hash से) GitHub शीट के ⋮ मेनू से खुलते हैं, और सिर्फ़ तब जब प्रोजेक्ट का origin github.com पर हो। Projects → Git → History में किसी commit पर टैप करने से Revert, Reset Soft, Reset Hard और Cherry-pick मिलते हैं। Reset Hard बिना पूछे चलता है और बिना commit किया काम मिटा देता है।

आम वर्कफ़्लो

वर्कफ़्लो 1: त्वरित फ़िक्स

1. प्रोजेक्ट कार्ड पर Git → Branch खोलें और main पर जाएँ
2. नवीनतम लाने के लिए Download changes टैप करें
3. एडिटर में फ़िक्स करें
4. Commit टैप करें, संदेश लिखें और Commit & Push टैप करें

वर्कफ़्लो 2: नया फ़ीचर

1. main पर जाएँ, Download changes टैप करें, फिर switch चालू रखकर Create new branch करें (जैसे feature/new-api)
2. विकसित करें, Source Control से बार-बार commit करते हुए
3. Upload changes टैप करें, फिर GitHub शीट में New pull request from …

वर्कफ़्लो 3: हॉटफ़िक्स

1. प्रोडक्शन ब्रांच पर जाएँ और hotfix/critical-bug बनाएँ
2. फ़िक्स करें और commit करें
3. वापस प्रोडक्शन ब्रांच पर जाएँ, Source Control → Merge खोलें, hotfix ब्रांच चुनें और Merge into … टैप करें
4. Upload changes टैप करें

सर्वोत्तम अभ्यास

Commits

✅ अच्छे संदेश:

feat: add Google login
fix: correct email validation
docs: update README with instructions
refactor: simplify search function

❌ बुरे संदेश:

changes
fix
wip
asdfgh

ब्रांच

वर्णनात्मक नाम इस्तेमाल करें:

• feature/feature-name
• fix/bug-description
• hotfix/critical-issue
• refactor/refactor-name

Push से पहले

1. ✅ अपने बदलाव जाँचें
2. ✅ टेस्ट चलाएँ (अगर हैं)
3. ✅ पहले remote के बदलाव डाउनलोड करें (conflict से बचने के लिए)
4. ✅ वर्णनात्मक संदेश लिखें

उन्नत कॉन्फ़िगरेशन

आपका टोकन और वह कहाँ जाता है

• Sign in with a code से मिला टोकन आपके फ़ोन पर एन्क्रिप्टेड सहेजा जाता है (Android Keystore की कुंजी से AES-256-GCM), हर PocketCode अकाउंट और हर प्रोवाइडर अकाउंट के लिए अलग
• Git उसे सिर्फ़ github.com, gitlab.com और bitbucket.org को भेजता है (होस्ट का सटीक मिलान)। GitHub शीट उसे आपके फ़ोन से सीधे api.github.com को भेजती है। किसी और होस्ट पर मौजूद remote (GitHub Enterprise, अपना GitLab, Gitea…) को क्रेडेंशियल नहीं मिलते, इसलिए वहाँ की प्राइवेट रिपॉज़िटरी विफल होती हैं
• अगर आप PocketCode में ही GitHub से साइन-इन करते हैं, तो वह GitHub टोकन PocketCode के बैकएंड पर भी एन्क्रिप्टेड (AES-256-GCM) सहेजा जाता है: बैकएंड उसे आपकी रिपॉज़िटरी की सूची बनाने में इस्तेमाल करता है, और ऐप उसे वहाँ से वापस पा सकता है

.gitignore

Start tracking this project (प्रोजेक्ट कार्ड → Git) एक लोकल रिपॉज़िटरी बनाता है, जिसमें .gitignore PocketCode के अपने .pocketcode/ फ़ोल्डर को बाहर रखता है। अपने नियम जोड़ने के लिए उस फ़ाइल को एडिट करें:

# Dependencies
node_modules/
venv/
__pycache__/

# Build outputs
dist/
build/
*.pyc

# Environment
.env
.env.local

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

जो समर्थित नहीं है

• SSH remote (git@…, ssh://): HTTPS पता इस्तेमाल करें
• Git LFS (फ़ाइलें छोटे टेक्स्ट पॉइंटर के रूप में रहती हैं), submodule और commit signing
• Git hooks: ये कभी नहीं चलते
• GitLab, Bitbucket या GitHub Enterprise के pull request, issue, CI और alerts: इनके लिए github.com की रिपॉज़िटरी चाहिए
• GitHub शीट की सूचियाँ 300 आइटम पर रुक जाती हैं

सहयोग

मोबाइल से कोड रिव्यू

1. PR खोलें
2. उसके मौजूदा reviews, checks और approval स्थिति देखें
3. PR की बातचीत में comment जोड़ें

औपचारिक approve/request-changes review जमा करना, और किसी पंक्ति से जुड़े comment, अभी ऐप में जुड़े नहीं हैं — ये GitHub के वेब UI से करें। PocketCode आज PR की review स्थिति और बातचीत दिखाता है।

चर्चाएँ

• PR या issue की बातचीत में comment लिखें
• @username से सहयोगियों को mention करें

समस्या निवारण

"Push नहीं हो रहा"

अगर ऐप कहे "The remote rejected the upload. Download the remote changes first, then upload again.":

1. Download changes टैप करें
2. अगर conflict हों तो सुलझाएँ (ऊपर देखें)
3. फिर से Upload changes टैप करें

"रिपॉज़िटरी क्लोन कर ली, पर फ़ाइलें नहीं दिख रहीं"

जाँचें:

1. क्लोन Projects पेज पर एक नया प्रोजेक्ट है: उसे वहीं से खोलें
2. क्या रिपॉज़िटरी खाली है?
3. Git LFS से प्रबंधित फ़ाइलें छोटे टेक्स्ट पॉइंटर के रूप में आती हैं, असली सामग्री नहीं

"बदलाव GitHub पर नहीं दिख रहे"

अकेला commit कुछ upload नहीं करता, और Publish सिर्फ़ ख़ाली रिपॉज़िटरी बनाकर लिंक करता है। अगर स्टेटस बार आगे के commit (↑) दिखाए या प्रोजेक्ट कार्ड पर Push लिखा हो, तो Upload changes (या Source Control में Push आइकन) टैप करें।

निष्कर्ष

PocketCode के साथ आपके मोबाइल पर रोज़ का Git और GitHub वर्कफ़्लो है। उस ज़रूरी कमिट को न करने का अब कोई बहाना नहीं।

अगला ट्यूटोरियल: Vercel के साथ GitHub से स्वचालित डिप्लॉय

सवाल हैं? [email protected] पर लिखें

हैप्पी कोडिंग! 🚀