Building the product · Independent · 20 Oct 2026

shipshapecode/shepherd

Guide your users through a tour of your app

← Building the product
Shepherd: app tour library. Guide users through your web app with step-by-step popups.

In simple English

When a new user signs up for your app, they often do not know where to click. This library lets you show step-by-step boxes that point to buttons and explain your features. You can write the steps in code and style them to match your pages. It works with React, Vue, Angular, and plain JavaScript. You need to write the tour steps yourself.

What it is

Shepherd (a JavaScript library for creating step-by-step user onboarding tours and floating message bubbles inside a web browser) helps developers build guided walkthroughs. It attaches message boxes to specific page elements and steps users through them.

What it is good for

Solo builders who want to reduce churn by showing new users how their web app works without building an onboarding system from scratch.

Stars14k
LicenceCustom
Latestv7.0.6-react-shepherd (2026-08-24)checked 20 Oct 2026
Last code change2026-10-20
Written inJavaScript
Setup effort
2 / 5
Payoff
4 / 5
Good
  • Supports React, Vue, Angular, Ember, and plain JavaScript.
  • Highly customisable styles so the popups match your design.
  • Lightweight package that does not slow down your app.
Watch for
  • Requires coding your tour steps manually in JavaScript.
  • AGPL-3.0 licence means commercial products may need a paid commercial licence.
  • Tour steps can break if your HTML element IDs or classes change.
Replaces

building a custom modal tooltip system from scratch

Works well with

React

Also reviewed on Repo Radar
  • python/mypy21k stars

    The reference type checker for Python, run from the command line.

  • HypothesisWorks/hypothesis9.1k stars

    A Python library that generates test inputs and reduces any failure to the smallest example that still fails.

  • wntrblm/nox1.6k stars

    Runs your tests and other jobs in fresh isolated environments, described in an ordinary Python file.

Install
npm install shepherd.js

Independent: reviewed for Repo Radar outside the daily editions. Every independent repository

On Stack Radar: Sales & Customers › Customer Success & Feedback › Onboarding.

Get the next edition in your inbox

A dozen repositories, opened and checked. The licence read, the last release dated, and the ones that did not make it named with the reason. It is the half most lists leave out.

No tracking pixels. One click to leave. The archive stays free either way.

We use your address to send the edition and nothing else. Confirm by email, leave in one click. How we handle it.