Marketplace

यह क्या है और इसे कैसे खोलें

Marketplace मुख्य pager के पाँच पेजों में से एक नहीं है। यह आप जो कर रहे थे उसके ऊपर फ़ुल-स्क्रीन overlay के रूप में खुलता है, और इसकी अपनी स्क्रीनें हैं: Home, सर्च, category list, asset पेज और My library।

अंदर जाने के छह तरीके

Settings में Marketplace की कोई एंट्री नहीं है।

इसमें घूमना

• Back यानी सिस्टम का back gesture। किसी भी स्क्रीन से यह Home तक ऊपर जाता है; Home से यह Marketplace बंद कर देता है (और अगर आप editor से आए थे तो वहीं वापस ले जाता है)। स्क्रीन पर कोई back arrow नहीं हैं।
• पहली बार: तीन कार्डों की welcome स्क्रीन (A curated catalog, One-tap install, Your library) जिसमें Skip, Next और Got it हैं। यह सिर्फ़ एक बार दिखती है।
• Catalog कहाँ से आता है: PocketCode के सर्वर api.pocketcodeapp.com से। ऐप में कोई catalog पहले से नहीं आता, इसलिए ब्राउज़ करने के लिए कनेक्शन चाहिए। सिर्फ़ My library (Installed और Saved) ऑफ़लाइन चलती है।
• Account: ब्राउज़ करने के लिए account नहीं चाहिए; इंस्टॉल करने के लिए चाहिए। editor का Snippets panel ऐप के अपने शब्दों में यही कहता है: “Sign in to install Marketplace snippets. Browsing doesn't need an account.”

Home

Home पहली स्क्रीन है। हर section एक साथ लोड होता है और तभी दिखता है जब उसमें दिखाने को कुछ हो। सबको रिफ़्रेश करने के लिए नीचे खींचें, या Reload दबाएँ। अगर कुछ लोड न हो तो आपको Couldn't load the marketplace और Retry दिखता है।

सबसे ऊपर: Search the marketplace फ़ील्ड (यह सिर्फ़ Search खोलता है; टाइप आप वहीं करते हैं), My library आइकन और Reload आइकन।

सर्च और फ़िल्टर

Home पर Search the marketplace फ़ील्ड दबाएँ। कीबोर्ड खुलता है और कर्सर पहले से फ़ील्ड में होता है। सर्च catalog सर्वर पर चलती है और आपके टाइप रोकने के चौथाई सेकंड बाद, या search key दबाने पर रिफ़्रेश होती है। आपको compact कार्डों में 30 तक नतीजे मिलते हैं। दिखाने को कुछ न हो तो No results for “…” दिखता है; अगर सर्वर जवाब न दे तो Couldn't load और retry दिखता है, इसलिए नेटवर्क की गड़बड़ी कभी खाली नतीजे जैसी नहीं लगती। फ़ील्ड खाली होने पर Search Recent searches (8 तक; कोई शब्द तभी सेव होता है जब आप search key दबाते हैं) और Browse by category दिखाती है; Clear फ़ील्ड खाली कर देता है।

Filters

Filters आइकन Filter results खोलता है, और फ़िल्टर चालू रहने तक आइकन पर संख्या वाला badge रहता है। Kind में सभी 12 asset types हैं (Plugins और Workflows समेत), Tier में Free और Pro हैं, और Category में catalog की categories हैं। हर समूह में ज़्यादा से ज़्यादा एक chip चुनें (उसे हटाने के लिए दोबारा दबाएँ, या Any चुनें), फिर Apply; Clear all तीनों समूह रीसेट करता है। फ़िल्टर खाली सर्च के साथ भी काम करते हैं, इसलिए आप, मान लीजिए, हर Pro theme की list निकाल सकते हैं।

Categories और See all

कोई category chip (Home या Search में) या See all एक list खोलता है जिसका title category या section का नाम होता है। यह कार्डों का grid है जो स्क्रॉल करने पर 30-30 करके लोड होता है। खाली हो तो Nothing here yet — come back soon दिखता है; नेटवर्क फ़ेल हो तो error और retry। किसी list को type से सीमित करने के लिए Search के Filters इस्तेमाल करें।

Sort by में Popular (सबसे ज़्यादा downloaded), Newest और Rating मिलते हैं। क्रम आपके फ़ोन पर उसी पर लगाया जाता है जो पहले से लोड हो चुका है, क्योंकि catalog सर्वर सिर्फ़ आखिरी अपडेट के हिसाब से क्रम देता है। list हमेशा Popular से शुरू होती है, New & updated के See all के बाद भी।

Asset पेज

asset का पेज खोलने के लिए कोई भी कार्ड दबाएँ। फ़ैसला लेने के लिए जो कुछ चाहिए वह इसी पर है, और उसे इंस्टॉल करने वाले बटन भी। मुख्य बटन क्या करता है यह asset के type पर निर्भर है (अगला section देखें)।

Header और विवरण

• Title bar. यह asset का type दिखाती है (Themes, Pages, Buttons…), नाम नहीं। दाईं ओर: Bookmark, Share और ⋮ मेनू जिसमें Report है।
• Summary. आइकन, नाम, author (प्रोफ़ाइल खोलने के लिए दबाएँ) और category, फिर एक पंक्ति जिसमें रेटिंग (रेटिंग न हों तो डैश) और उनकी गिनती, downloads और Tier हैं, जो PRO badge या Free pill के रूप में दिखता है।
• Type कार्ड. एक कार्ड बताता है कि मुख्य बटन क्या करेगा: Code snippet, Editor color theme, AI slash command, Regex pack, MCP server, AI agent persona, Project template, Executable plugin (workflows के लिए भी इस्तेमाल होता है) या Unsupported asset।
• इंस्टॉल से पहले preview. catalog से मिलने पर themes, regex packs, MCP servers, prompts और agents के लिए color swatches, नमूना patterns, launch command या छोटा अंश दिख सकता है।
• Screenshots और मिलते-जुलते assets. asset में screenshots हों तो वे आगे आते हैं, और आख़िर में Similar to this (Other assets you might like) में catalog के सुझाए संबंधित assets की list होती है।
• Bookmark और Share. Bookmark asset को इंस्टॉल किए बिना Saved में रख देता है (पलटने के लिए फिर दबाएँ, Remove bookmark)। Share सिस्टम के share sheet से Name · https://pocketcodeapp.com/m/<slug> भेजता है।
• जब लोड न हो. आपको फ़ेल हुई request का error टेक्स्ट दिखता है, या अगर वह न हो तो Couldn't load this asset। अगर दिखाने को कुछ भी न हो तो Asset not found।

Install, apply और save

अगर asset Pro है और आप Free पर हैं, तो पूरी install पंक्ति की जगह Pro asset कार्ड आ जाता है (Free, Pro और theme trial देखें)। वरना बटन type पर निर्भर करते हैं। इंस्टॉल चलते समय बटन spinner बन जाता है ताकि डबल टैप से वह दो बार शुरू न हो, और एक संदेश नतीजा बताता है। पेज अपने बटन को “Installed” नहीं करता; जो बदलता है वह यह है कि Inside tab और review box दिखने लगते हैं। दबाने पर क्या होता है:

1. 1अगर asset permissions घोषित करता है, तो पहले Allow this asset to… खुलता है (नीचे)। project template यह भी जाँचता है कि कुछ भी डाउनलोड होने से पहले आपके प्लान में एक और project की जगह है।
2. 2ऐप PocketCode के सर्वर से install link माँगता है, asset और आपके ऐप का version भेजकर। सर्वर जाँचता है कि आप साइन-इन हैं, asset का tier आपके प्लान में आता है और आपका ऐप काफ़ी नया है, और समय-सीमा वाला signed download link लौटाता है।
3. 3ऐप bundle डाउनलोड करता है और उसका SHA-256 fingerprint सर्वर द्वारा बताए गए fingerprint से मिलाता है। अगर सर्वर Ed25519 signature भी देता है, तो उसे marketplace की public key से verify किया जाता है। मेल न खाने पर install रुक जाता है और डाउनलोड हटा दिया जाता है।
4. 4bundle ऐप के cache में unpack होता है। 512 MB या 20,000 files से ऊपर की कोई भी चीज़, compressed आकार के 200 गुना से ज़्यादा फैलने वाली कोई भी चीज़, और अपने फ़ोल्डर से बाहर जाने की कोशिश करने वाला कोई भी path, अस्वीकार कर दिया जाता है।
5. 5asset को उसके type के हिसाब से apply किया जाता है (अगले section की तालिका) और My library में जोड़ दिया जाता है।
6. 6ऐप सर्वर को बताता है कि install सफल रहा या नहीं: asset की ID और सफलता या विफलता।

Tabs

छह तक tabs, और हमेशा सब नहीं:

Permissions: एक चेतावनी, sandbox नहीं

जब कोई asset permissions घोषित करता है, तो उसके मुख्य बटन (या Copy जैसे किसी गौण बटन) को दबाने पर पहले Allow this asset to… खुलता है: “Review what this asset can do on your device. You can install it anyway or cancel.” यह हर permission की एक पंक्ति दिखाता है, जैसे Read files from your projects, Modify files in your projects, Make network requests, Insert code into your editor, Change your editor theme, Read or change app settings, Add tools available to your AI chat, Spawn an MCP server process, Run shell commands, Write to the clipboard और Read stored secrets / API keys। जो permission dialog नहीं पहचानता वह कच्चे टेक्स्ट में दिखती है। MCP server हमेशा Spawn an MCP server process दिखाता है, भले ही उसके manifest में न हो। Install anyway या Cancel दबाएँ।

Reviews

Reviews tab सार्वजनिक reviews दिखाता है, Load more के साथ 20-20 करके: सितारे, तारीख और टेक्स्ट, बिना नामों के। खाली हो तो: No reviews yet. Be the first. review लिखने के लिए asset इसी डिवाइस पर इंस्टॉल होना चाहिए: Your review कार्ड तभी दिखता है। 1 से 5 सितारे चुनें, चाहें तो टेक्स्ट जोड़ें (1,000 अक्षरों तक) और Post review दबाएँ। अगर यह फ़ेल हो तो Couldn't publish your review. Try again. दिखता है।

Report this asset

⋮ → Report Report this asset खोलता है: “Tell us what's wrong. Reports are reviewed by the team.” पाँच कारणों में से एक चुनें (Malicious or unsafe, पहले से चुना हुआ, Spam or misleading, Doesn't work, Inappropriate content या Other), 500 अक्षरों तक का वैकल्पिक नोट जोड़ें और Send report दबाएँ। आपको Thanks for the report — we'll review it. या Couldn't send the report: … मिलता है। ऐप यह नहीं दिखाता कि रिपोर्ट के बाद क्या होता है।

Author और screenshots

• Author. author का नाम दबाने पर एक फ़ुल-स्क्रीन sheet खुलती है जिसमें उनका avatar (अगर हो), नाम, bio, Verified author आइकन जब catalog उन्हें verified चिह्नित करे, और N assets by this author होते हैं; किसी एक को दबाकर उसका पेज खोलें। ऐप author को नाम से निकाले गए slug के ज़रिए ढूँढता है; अगर यह फ़ेल हो तो Couldn't load this author's profile दिखता है।
• Screenshots. ये thumbnails की एक पंक्ति के रूप में दिखते हैं। एक को दबाकर फ़ुल-स्क्रीन देखें, अगले पर जाने के लिए इमेज दबाएँ (आख़िर के बाद फिर पहले पर आ जाता है) और बाहर निकलने के लिए close बटन इस्तेमाल करें। catalog जितने screenshots देता है, ऐप उतने दिखाता है।

12 तरह के asset

catalog में 12 asset types हैं। Filters में सभी 12 दिखते हैं, और जिस asset का type ऐप का यह version नहीं पहचानता, उस पर एक disabled Unsupported asset बटन दिखता है। तालिका हर type का मुख्य बटन और इंस्टॉल करने पर क्या होता है, बताती है।

जिस asset का type यह version नहीं जानता, वह कहता है “This asset uses a type the app doesn't recognise yet. Try updating PocketCode.” आप जो कुछ भी इंस्टॉल करते हैं वह My library में भी listed होता है।

MCP servers बंद हालत में शुरू होते हैं

MCP server एक Node process है जो PocketCode जैसी ही permissions के साथ चलता है, इसलिए Marketplace कभी आपके लिए उसे शुरू नहीं करता:

1. 1Connect MCP server दबाएँ। ऐप launch line जाँचता है: सिर्फ़ node या npx स्वीकार होते हैं, और वह उन flags को अस्वीकार करता है जो कोड चलाते हैं (-e, --eval, -p, --print, -r, --require, --import, --loader, --experimental-loader, और npx के लिए -c तथा --call भी)। NODE_OPTIONS और NODE_PATH वेरिएबल हटा दिए जाते हैं। असल में सिर्फ़ node servers शुरू हो सकते हैं: ऐप में npm नहीं है, इसलिए npx वाला server बंद हालत में इंस्टॉल होता है और उसे चालू करने पर Settings में “npx is not available: npm is not bundled with the app” दिखता है।
2. 2सर्वर बंद और पुष्टि के इंतज़ार की हालत में सेव होता है, और एक संदेश आपको Settings > MCP की ओर भेजता है। उस स्क्रीन का नाम MCP Servers है।
3. 3सर्वर को वहीं चालू करें। This server will run on your phone शीर्षक वाला dialog launch line दिखाता है और बताता है कि वह PocketCode जैसी ही permissions के साथ चलता है। सिर्फ़ Run it उसे शुरू करता है; रद्द करने पर वह बंद ही रहता है। एक बार आपके पुष्टि कर देने के बाद, वह आगे हर बार ऐप के साथ शुरू होता है; हर बार Settings > MCP खोलने की ज़रूरत नहीं।
4. 4अगर asset का कोई बाद का version command, arguments या environment बदल दे, तो सर्वर फिर से बंद हालत में आ जाता है और दोबारा पूछता है। अगर कुछ नहीं बदला, तो आपका पिछला फ़ैसला बना रहता है।

My library

Home पर My library आइकन दबाएँ। ये lists आपके फ़ोन के डेटाबेस से आती हैं: हर पंक्ति कुछ ऐसा है जो आपने इंस्टॉल या bookmark किया। Installed और Saved ऑफ़लाइन चलते हैं; Updates को कनेक्शन चाहिए।

Updates, Installed और Saved

• Installed (N) इस डिवाइस पर इंस्टॉल की हुई हर चीज़ दिखाता है। पंक्ति में type आइकन, नाम, “type • author • version” और दो आइकन होते हैं: Re-apply और Remove। खाली हो तो: No installs yet।
• Saved (N) आपके bookmark किए हुए assets दिखाता है, इंस्टॉल हों या नहीं। Remove bookmark एक को हटाता है; जो asset इंस्टॉल नहीं है, उसे यह library से भी हटा देता है। खाली हो तो: No saved items।
• Updates (N) तभी मौजूद होता है जब किसी का नया version हो। जब आप My library खोलते हैं, तो ऐप catalog से आपकी इंस्टॉल की हर चीज़ का नवीनतम version एक batched request में पूछता है (दोबारा जाँचने के लिए नीचे खींचें), और version नंबर मिलाता है। पंक्ति में v1.0.0 → v1.1.0 दिखता है। पंक्ति पर कोई update बटन नहीं है: उसे दबाकर asset पेज खोलें और दोबारा इंस्टॉल करें, जो नवीनतम version डाउनलोड करता है। अगर जाँच फ़ेल हो, तो यह कहने की जगह कि सब अप-टू-डेट है, आखिरी सही नतीजा बना रहता है।

Re-apply और Remove

Re-apply फ़ोन में पहले से रखे bundle से चलता है, बिना डाउनलोड के। Remove कोई पुष्टि नहीं माँगता और … removed from your library दिखाता है। हर एक क्या करता है यह type पर निर्भर है:

Marketplace preferences

• गियर आइकन (Library settings) Marketplace preferences खोलता है।
• Auto-update assets डिफ़ॉल्ट रूप से बंद है: “Once a day on Wi-Fi while charging, install new versions of every asset already in your library.” यह versions जाँचता है और सिर्फ़ उसी asset को डाउनलोड करता है जिस पर वैध Ed25519 signature हो। updates चुपचाप लागू होते हैं: snippets, pages और buttons सिर्फ़ सेव की हुई कॉपी रिफ़्रेश करते हैं; theme के colors आपकी theme बदले बिना रिफ़्रेश होते हैं; template कभी दूसरा project नहीं बनाता; prompts, regex packs, agents और components वहीं दोबारा लिखे जाते हैं; जिस MCP server की launch line बदल गई हो वह बंद हालत में लौट आता है। अगर कम से कम एक asset अपडेट हुआ, तो आपको Marketplace updated नोटिफ़िकेशन मिलता है, जो आपकी notification settings और quiet hours के अधीन है।
• Redeem promo code: कोड टाइप करें (40 अक्षरों तक, टाइप करते समय capitals में बदल जाता है) और Redeem दबाएँ। सफल होने पर N days of Pro added — enjoy. दिखता है। errors समस्या निवारण में दिए गए हैं।

Publish करना

आप ऐप से कोई asset publish नहीं कर सकते। कोई upload स्क्रीन नहीं है, कोई Publish बटन नहीं है, और कोई Pro फ़ीचर भी नहीं जो इसे खोल दे। फ़ोन पर catalog read-only है, और PocketCode टीम उसकी सामग्री ऐप के बाहर से, एक आंतरिक repository और स्वचालित जाँचों के ज़रिए publish करती है।

Free, Pro और theme trial

Marketplace का अपना कोई plan lock नहीं है। आपके प्लान पर जो निर्भर करता है वह है asset का अपना tier, templates के लिए project सीमा और editor के Snippets panel की custom-snippet सीमा।

Pro assets और 5 मिनट का theme trial

• Free पर रहते हुए Pro asset पर install पंक्ति Pro asset कार्ड बन जाती है: “Subscribe to PocketCode Pro to install it.” और Get Pro, जो paywall खोलता है। विवरण, screenshots, reviews और tabs दिखते रहते हैं। अगर सर्वर जवाब दे कि asset को Pro चाहिए, तो आप paywall पर भी पहुँचते हैं।
• Pro theme पर, उपलब्ध होने पर, आपको Try theme for 5 min भी मिलता है। यह theme apply करता है और पाँच मिनट बाद आपकी पिछली theme लौटा देता है; टाइमर ऐप बंद करने पर भी चलता रहता है। हर theme और डिवाइस पर एक trial मिलता है, और एक समय में सिर्फ़ एक।
• project सीमा Unlimited Projects के रूप में दिखती है: “The free plan includes one project and yours is in use. Go Pro to add more, or delete a project you no longer need.” कुछ भी डाउनलोड नहीं होता और इसे install में नहीं गिना जाता।