🎪 The short version
Banana.dog is open source. So there's no form to fill in, no fee to pay and no "premium placement" to buy. Your tool gets in the same way code gets in: through a merge request on GitLab.
- Fork the banana-www repository on GitLab.
- Add a card for your tool to
index.html, at the END of thetools-gridsection. No cutting in line! - Open a merge request. That's it. 🚀
Then the banana bot sniffs your submission for formatting crimes, and a human takes your tool for a spin. If both are happy, welcome to the banana brigade!
🎨 What a card looks like
Every tool is one tiny block of HTML: a category, a name that links to the tool, and a snappy one-liner.
<div class="tool-card">
<span class="tool-category">Your Category</span>
<a href="https://yourtool.com" target="_blank" rel="noopener" class="tool-name">YourTool.com</a>
<p class="tool-description">A snappy one-liner about what makes your tool special. Keep it fun, keep it real.</p>
</div>
For example, this is how CertDecoder.com is listed:
<div class="tool-card">
<span class="tool-category">Security</span>
<a href="https://certdecoder.com" target="_blank" rel="noopener" class="tool-name">CertDecoder.com</a>
<p class="tool-description">Decode X.509 certificates right in your browser. No server, no uploads, just pure client-side certificate magic.</p>
</div>
Your card goes after the last existing one. Don't reorder the other tools, and don't sneak yours to the top. Be a good banana and join the queue at the back.
📏 Size limits (yes, size matters)
- Tool name: max 50 characters. Keep it snappy!
- Category: max 20 characters. Short and sweet.
- Description: max 200 characters. A one-liner, not a novel.
- Tools per merge request: max 3. Don't be greedy!
The banana bot enforces all of these, and it cannot be bribed. It also checks
that your card is at the end of the list, that the tool isn't already listed and
that your merge request touches nothing but index.html.
🏷️ Pick a category
Use one of these or make up your own (keep it short!):
- Fun: for tools that spark joy.
- Security: for the paranoid and the protectors.
- Generator: for creating random chaos.
- Utility: for actually useful stuff.
- Weird: for... well, the weird ones.
- Games: for time wasters and brain teasers.
- Dev Tools: for the code monkeys among us.
The filter buttons on the front page are built from the cards, so a brand-new category shows up there all by itself. Magic. ✨
🚫 The no-go zone
Your tool will be REJECTED faster than a spoiled banana if it:
- 🔞 Contains adult content
- 🎰 Involves gambling or betting
- 💊 Promotes sketchy substances
- 🤥 Doesn't actually do what it claims
- 💀 Is a scam, malware or a phishing attempt
- 😴 Has been offline for ages (we check!)
- 🗑️ Is just plain spam
- 💸 Has no free version
Free means free! Visitors must be able to try your tool's main feature without paying. A daily limit or starter credits is fine, but a paywall on the first try is not.
⚡ The fine print (but make it fun)
- No guarantees! Opening a merge request doesn't mean automatic acceptance. We're picky about our bananas.
- We reserve the right to remove any tool that goes rotten (offline for too long, turns evil, that sort of thing).
- No warranties! We're not responsible if a tool makes your computer grow actual bananas.
- Quality matters! Your tool should actually work and do something useful, fun or weird.
- Be original! We love tools that make us go "wait, that exists?!"
🎯 Pro tips for getting accepted
- Make it work. Test your tool before submitting.
- Keep it clean. Family-friendly is the way.
- Be creative. Boring tools need not apply.
- Write a good description. Make us want to click!
- Don't be evil. Seriously, just don't.
Merge request rejected and you're genuinely confused why? Open a work item on GitLab (that's GitLab's new name for issues). But remember: this is a benevolent dictatorship, not a democracy. The banana has spoken! 🍌
🤝 Code of conduct
Be nice. Be weird. Be wonderful. But most importantly, be bananas!
Life's too short for boring tools. Make something that makes people smile, scratch their heads, or ideally both.