If you are marketing a dev tool, especially an open-source infra dev tool, then sharing your product on Hacker News is a must. 

Now the question is how to do that exactly, as marketing to the HN audience is just really hard.

Obviously, the best thing you can do for your marketing is to actually have a good product to market. But assuming you do, how do you pitch it on HN so that people see it too?

In this post, I am going deep into that:

And through all that research there seems to be a clear pattern that is pretty much explained openly by Hacker News admins. 

Rules for launching your product on HN directly from Hacker News admins

So HN Admins actually share the guidelines for Launching on HN directly in this doc:

https://news.ycombinator.com/yli.html

and

https://news.ycombinator.com/yli.html

They explain exactly how to write it in there so make sure to read it. 

But here is a TLDR.

Style:

  1. “Write in your own voice, not a corporate one.“
  2. “Talk to HN as fellow builders and engineers. Imagine you're having a drink with a friend you used to work with.”
  3. “Don't use superlatives (fastest, biggest, first, best). Modest language is stronger.”
  4. “Don't sell to this audience. If you try, they will close the tab. Instead, interest them, then let them sell themselves.”

Product/Offer:

  1. Give people an easy way to try it out. For free. Remove all barriers possible. The second best thing is a demo or video.
  2. “Make your pricing transparent.” and “Say how you make money or plan to.”
  3. Your CTA should invite people to share their suggestions/experiences/feedback.

Format of the announcement:

  1. introduce yourselves
  2. say in one clear sentence what your company does
  3. explain the problem: how is it hard? why does it matter?
  4. tell your backstory of how you came to work on this
  5. explain your solution, giving technical details
  6. explain what's different about your solution, giving technical details
  7. invite the community to share feedback

How to comment/answer:

  1. When you launch be ready to answer comments. And quickly. 
  2. Make sure your friends/employees/cofounders DON’T post booster comments.
  3. Go deep into details. Remember HN community is genuinely curious. 
  4. “Answer objections by first finding something to agree with, even if it's just the positive intention behind the comment.”
  5. “When criticized, act like the critics are doing you a favor. Who knows, maybe they are, and it will win you favor either way.” You won’t convince the critic but you can convince the audience reading it. 

Let’s look at the highest-upvoted devtool announcement ever through this lens. 

The best dev tool HN launch ever

I want to go over these guidelines looking at the most upvoted dev tool HN launch of all time: Fly.io. 

 Launch HN: Fly.io (YC W20) – Deploy app servers close to your users

https://news.ycombinator.com/item?id=22616857

I will go over all the points from Style, Product/Offer, Format, and Comments subpoints and see how they approached it. Spoiler alert. They did tick all the boxes. 

Style:

  1. “Write in your own voice, not a corporate one.“
  1. “Talk to HN as fellow builders and engineers. Imagine you're having a drink with a friend you used to work with.”
  1. “Don't use superlatives (fastest, biggest, first, best). Modest language is stronger.”

             Instead of saying “fastest deployment” they just said “deploy servers close to your users” or

  1. “Don't sell to this audience. If you try, they will close the tab. Instead, interest them, then let them sell themselves.”

Product/offer:

  1. Give people an easy way to try it out. For free. Remove all barriers possible. The second best thing is a demo or video.
  1. “Make your pricing transparent.” and “Say how you make money or plan to.”
  1. Your CTA should invite people to share their suggestions/experiences/feedback.

Format of the announcement:

  1. introduce yourselves
  1. say in one clear sentence what your company does
  1. explain the problem: how is it hard? why does it matter?
  1. tell your backstory of how you came to work on this
  1. explain your solution, giving technical details
  1. explain what's different about your solution, giving technical details
  1. invite the community to share feedback

How to comment/answer:

  1. When you launch be ready to answer comments. And quickly. 

              I saw “mrkurt” answer 53 comments in this thread. Not sure how quickly that was but I presume pretty quickly. 

  1. Make sure your friends/employees/cofounders DON’T post booster comments.

             No way to check it but I didn’t see anything fishy. 

  1. Go deep into details. Remember HN community is genuinely curious. 
  1. “Answer objections by first finding something to agree with, even if it's just the positive intention behind the comment.”
  1. “When criticized, act like the critics are doing you a favor. Who knows, maybe they are, and it will win you favor either way.” You won’t convince the critic but you can convince the audience reading it. 

So fly.io HN Launch pretty much ticks all of the boxes. And it didn’t feel unnatural or weird to tick them either. That launch is just descriptive, interesting, and engaging.   

More tips for Launching dev tools on HN

In addition to all that there are a few more things you can do to increase your chances of success. Maybe they are not directly coming from the HN Admin guidelines but seen myself and heard them from people in the community.

HN crowd really likes and overindexes on open-source, privacy-first products. So if you actually are an "open-source alternative to X", say it right in the title.

Make the title crystal clear and explicit. It should be obvious right away what you've built. And if there is something that pretty much all successful HN posts have in common, is that it is obvious where you'll go when you click on the link. Make it obvious.

Link out to the GitHub repo. This makes your "offer" more HN dev audience-centric by design. The repo hints at it being easy to run yourself, at it being an actual working product/library/framework, and at it being a dev tool. No other website domain brings those expectations.

Conclusions

Ok, so summing up. If you are preparing for the HN Launch or HN Show just make sure to:

  • follow the HN Admin guidelines
  • look over some more examples (and anti examples) of implementing this below
  • if you can positioning your tool as an open-source or privacy-first
  • and get your servers ready for more traffic/signups than you hoped for ;)

If you need help with this, reach out, I can help you craft this. 

APPENDIX top/bottom HN launch and HN show posts

Now, to get a better feel I looked at the last 4 years of HN dev tool Launch HN and Show HN posts and copy-pasted top/bottom Launch HN and top/bottom Show HN in here. 

You can compare them against the guidelines I mentioned but generally, they seem to hold water. I am planning on actually scoring all of them against these guidelines and looking into this data but this is a TODO. 

Top Launch HN devtool examples

Launch HN: Fly.io (YC W20) – Deploy app servers close to your users

https://news.ycombinator.com/item?id=22616857

Launch HN: Fig (YC S20) – Autocomplete for the Terminal

https://news.ycombinator.com/item?id=27277819

Launch HN: Pynecone (YC W23) – Web Apps in Pure Python

https://news.ycombinator.com/item?id=35136827

Launch HN: Lago (YC S21) – Open-source usage-based billing

https://news.ycombinator.com/item?id=34773442

Launch HN: Resend (YC W23) – Email API for developers using React

https://news.ycombinator.com/item?id=36309120

Launch HN: Twenty.com (YC S23) – Open-source CRM

https://news.ycombinator.com/item?id=36791434

Launch HN: Neptyne (YC W23) – A programmable spreadsheet that runs Python

https://news.ycombinator.com/item?id=34818706

Launch HN: Chatwoot (YC W21) – Open-Source Alternative to Intercom, Zendesk

https://news.ycombinator.com/item?id=26501527

Launch HN: Vocode (YC W23) – Library for voice conversation with LLMs

https://news.ycombinator.com/item?id=35358873

Launch HN: QuestDB (YC S20) – Fast open source time series database

https://news.ycombinator.com/item?id=23975807

Top Show HN dev tool examples

Show HN: Redbean – Single-file distributable web server

https://news.ycombinator.com/item?id=26271117

Show HN: GPT-4-powered web searches for developers

https://news.ycombinator.com/item?id=35543668

Show HN: I'm building an open-source Amazon

https://news.ycombinator.com/item?id=32690410

Show HN: Imba – I have spent 7 years creating a programming language for the web

https://news.ycombinator.com/item?id=28207662

Show HN: I wrote my own RTS game engine in C

https://news.ycombinator.com/item?id=27132334

Show HN: Heynote – A dedicated scratchpad for developers

https://news.ycombinator.com/item?id=38733968

Show HN: htmz – a low power tool for HTML

https://news.ycombinator.com/item?id=39429370

Show HN: Warp, a Rust-based terminal

https://news.ycombinator.com/item?id=30921231

Show HN: OpenAPI DevTools – Chrome extension that generates an API spec

https://news.ycombinator.com/item?id=38012032

Show HN: Restfox – Open source lightweight alternative to Postman

https://news.ycombinator.com/item?id=33287137

Bottom Launch HN dev tool examples

Launch HN: Acho (YC S20) – No code data warehouse for big data

https://news.ycombinator.com/item?id=25336179

Launch HN: Refinery (YC S20) – Edit your React app in-browser and generate code

https://news.ycombinator.com/item?id=26752294

Launch HN: Corgea (YC S23) – Auto fix vulnerable code

https://news.ycombinator.com/item?id=38928064

Launch HN: Feroot (YC W21) – security scanner for front-end JavaScript code

https://news.ycombinator.com/item?id=26024912

Launch HN: Method Financial (YC S19) – API to embed debt repayment into your app

https://news.ycombinator.com/item?id=30685921

Launch HN: Dioptra (YC W22) – Improve ML models by improving their training data

https://news.ycombinator.com/item?id=31825473

Launch HN: GradientJ (YC W23) – Build NLP Applications Faster with LLMs

https://news.ycombinator.com/item?id=35445097

Launch HN: Signadot (YC W20) – Lightweight Test Environments for Microservices

https://news.ycombinator.com/item?id=32854746

Launch HN: DevCycle (YC W14) – a feature flag platform built for developers

https://news.ycombinator.com/item?id=36295460

Launch HN: DeploySentinel (YC S22) – End-to-end tests that don't flake

https://news.ycombinator.com/item?id=32319404

Bottom Show HN dev tool examples

Show HN: The world's most comprehensive Python Accounting Library

https://news.ycombinator.com/item?id=39561664

Show HN: JavaScript tiny tool; to acquire CSS selector

https://news.ycombinator.com/item?id=39561664

Show HN: Revolution in CSS With

https://news.ycombinator.com/item?id=39570187

Show HN: Commitm, a CLI that generates your commit messages for you

https://news.ycombinator.com/item?id=39573775

Show HN: PGCacheWatch – Elevate PostgreSQL Performance with Smart Caching

https://news.ycombinator.com/item?id=39470843

Show HN: Hivekit – realtime geospatial API Platform

https://news.ycombinator.com/item?id=39478971

Show HN: I built an internal linking visualization tool

https://news.ycombinator.com/item?id=39490044

Show HN: I Made a Laravel Boilerplate to Speed Up Development Process

https://news.ycombinator.com/item?id=39499188

Show HN: UnWebhook – A tool for working with webhooks in teams and staging

https://news.ycombinator.com/item?id=39511849

Show HN: I Decided to Build Multiwoven, an Open-Source Reverse ETL

https://news.ycombinator.com/item?id=39516951