Get your project ready before you upload
Short answerBefore you submit, have six things ready: complete source code with no secrets, a working live demo, setup documentation, technical details, at least five good screenshots, and deployment instructions.
Ten minutes of preparation saves days of back-and-forth. Here's the checklist our reviewers use — get these right and you'll fly through.
1. Clean, complete source code
- A Git repository or a ZIP with the complete source.
- No obfuscation, nothing missing.
- No secrets committed — no passwords, API keys or tokens in the code or config files. Use an example config file (like `.env.example`) instead.
2. A working live demo
A public address buyers can try. It must stay reachable during the review and while your listing is live. If it needs a login, prepare a demo account.
⚠️ A demo that's down is one of the most common reasons for "changes needed". Check it before you submit.
3. Setup documentation
- A README that takes someone from a clean machine to a running app.
- A CLAUDE.md or AGENTS.md that explains the codebase — handy for buyers who'll keep building with AI.
4. Technical details
Frameworks, database, authentication, how many screens and tables, server needs and rough hosting costs. Buyers use this to decide.
5. Screenshots and media
At least five screenshots, PNG or JPG, at least 1280 × 720 — we recommend 1920 × 1080. A demo video is optional but helps a lot.
6. Deployment instructions
Document at least two ways to deploy it — for example a VPS, Docker or a cloud platform.
Quick self-check
- Does the demo work in a private browser window?
- Could a stranger install it from your README alone?
- Did you search your code for "password", "secret" and "key"?
If yes, yes and yes — you're ready to submit.
Questions
What if my app needs paid services like maps or SMS?
That's fine. Document them in the setup guide. Buyers use their own accounts for third-party services.
Do I need a demo video?
No, it's optional — but a short walkthrough helps buyers decide faster.