Open Source · MIT License

Tutorials as Code

Product tours that live in your Git repo.
No vendor lock-in. No per-user pricing. Just JSON files you own.

Free forever. No account required.

Why Trailguide exists

Most product tour tools charge per user, lock your content in their dashboard, and disappear when they shut down. We think that's broken.

You own your tours

Tours are JSON files in your repo. Review them in PRs. Roll back mistakes. Fork them for experiments. They're yours forever.

No surprise bills

The runtime is free for unlimited users. We'll never charge you based on how many people see your tours.

Works everywhere

React, Vue, Svelte, vanilla JS — if it runs in a browser, Trailguide works. No framework lock-in either.

The Old Way

  • Pay per monthly active user
  • Tutorials locked in vendor dashboard
  • No version control
  • Can't review changes in PRs
  • Vendor goes down = tours gone

The Trailguide Way

  • Free runtime, unlimited users
  • Tutorials are JSON in your repo
  • Full Git history
  • Review tour changes like code
  • You own everything

Ship a tour in 5 minutes

Three steps. No account required.

1

Install the package

npm install @trailguide/core
2

Create a trail file

// tours/welcome.json
{
  "id": "welcome",
  "title": "Welcome Tour",
  "steps": [
    {
      "target": "[data-trail-id='create-btn']",
      "title": "Start here",
      "content": "Click to create your first project.",
      "placement": "bottom"
    }
  ]
}
3

Start the tour

import { start } from '@trailguide/core';
import '@trailguide/core/dist/style.css';

fetch('/tours/welcome.json')
  .then(res => res.json())
  .then(trail => start(trail));

Built for developers

Trailguide is for teams who want control over their onboarding.

Good fit

  • Dev teams who want onboarding without a SaaS dependency
  • Products that ship behind firewalls or on-prem
  • OSS maintainers documenting complex UIs
  • Teams tired of per-seat pricing

Not a fit

  • No-code teams that never touch Git
  • Marketing-led tours managed by non-technical users

Everything you need, nothing you don't

Git-Native

Tours are JSON files. Review changes in PRs, roll back mistakes, branch for experiments.

No Lock-In

You own your tour data. Export, migrate, or self-host forever. We can't hold your tutorials hostage.

No Per-User Pricing

The runtime is free. Forever. Show tours to a million users without paying a cent.

Developer-First

TypeScript types, React hooks, clean APIs. Built by developers who've used the clunky alternatives.

Themeable

CSS custom properties for every color, radius, and shadow. Match your brand with a few lines of CSS — dark mode included.

Tiny Bundle

Under 13kb gzipped (JS + CSS). No analytics bloat, no tracking scripts, no third-party requests.

Pro Feature

Know exactly where users drop off

Stop guessing. See real completion data for every trail.

Trail Analytics

Last 30 days
2,847 Tours Started
73% Completion Rate
1m 24s Avg. Duration
Step-by-Step Funnel
Welcome
100%
Create Project
89%
Add First Task
81%
Invite Team
52%
Complete
73%

Find the friction

See exactly which step loses users. In this example, "Invite Team" drops 29% — maybe it needs clearer copy or a skip option.

Measure improvements

Ship a change, watch completion rates climb. No more hoping your onboarding works — now you'll know.

Track over time

Daily and weekly trends show if your onboarding is getting better or worse. Catch regressions before they hurt.

Try Pro Analytics Free

14 days of Pro — no credit card

Pro Feature

Anyone on your team can build a trail

No code required. Record a flow, tweak the copy, publish.

Record a full flow in one click

Hit Record, click through your app, and every click becomes a trail step. No extension needed — it all happens inside the editor.

Point and click to select elements

No CSS selectors to write. Just click on any button, input, or element on your site and it's captured automatically.

Write copy in a friendly editor

Rich text editing for step titles and content. Add formatting, links, and emoji without touching JSON.

Preview the trail before you ship

Play through the full trail inside the editor — see every tooltip, highlight, and transition exactly as your users will.

Selector quality grades

Every captured element is graded Stable, Moderate, or Fragile — with hints to make brittle selectors production-safe.

Drag to reorder steps

Reorganize your flow instantly. Insert steps, move them around, delete what you don't need.

Trail Editor
1 Welcome message
2 Create first project
3 Invite your team
4 Set up integrations
+ Add step
Welcome to Acme!
Let's take a quick tour to get you started. This will only take a minute.
[data-tour="welcome"] Pick

Built for your whole team

Product Managers

Create onboarding flows without waiting for engineering sprints.

Customer Success

Build walkthroughs for tricky features that generate support tickets.

Developers

Review trails in PRs. The visual editor outputs clean JSON you can trust.

Try the Visual Editor

No credit card required. Exports to JSON you own.

Simple pricing

Free to use. Pay only for convenience and insights.

Open Source

$0 forever

Full power. Full control. No limits.

  • Runtime package for any framework
  • Unlimited users, unlimited tours
  • Recorder tool for capturing steps
  • Trail validation utilities
  • Self-host everything
  • MIT License
View on GitHub

No lock-in. Everything Pro produces is still just JSON files in your repo.

Ready to build better onboarding?

Start with the free open source runtime, or try the Pro Editor for visual editing and GitHub sync.