Firstrun – Turn static documentation into interactive walkthroughs

Hi HN,

I’m the builder behind Firstrun (https://firstrun.dev). It’s a tool that takes your static documentation and turns it into interactive, step-by-step walkthroughs that you can embed anywhere.

The Problem:

Every developer knows the pain of spending hours writing great documentation, only for users to skim it, miss a crucial step, and open a support ticket saying "it doesn't work."

Static text and outdated screenshots just aren't great for complex setups or onboarding flows.

What Firstrun does:

I wanted to build the fastest way to create interactive guides without needing heavy engineering time or a bloated enterprise tool.

Create: You add your content (or extract steps from existing docs).

Generate: Firstrun turns it into a clean, interactive step-by-step UI.

Embed: You drop a simple script tag into your docs site or SaaS app.

Track: It gives you analytics on exactly where users are dropping off or failing, so you know which step of your setup is confusing them.

You can try it out here: https://firstrun.dev

I’d love to get your feedback on the UX and the embedded widget. Does this solve a pain point for your SaaS or open-source projects?

How do you currently handle onboarding flows and interactive docs?

Happy to answer any technical questions!