🍌 Banana.dog

Submit your tool

Got a weird, wonderful or slightly unhinged tool? Join the banana brigade. It's free. 🍌

🎪 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.

  1. Fork the banana-www repository on GitLab.
  2. Add a card for your tool to index.html, at the END of the tools-grid section. No cutting in line!
  3. 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)

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!):

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:

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)

🎯 Pro tips for getting accepted

  1. Make it work. Test your tool before submitting.
  2. Keep it clean. Family-friendly is the way.
  3. Be creative. Boring tools need not apply.
  4. Write a good description. Make us want to click!
  5. 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.