Skip to content


Repository files navigation

Shepherd.js Logo

npm version Download count all time npm FOSSA Status npm bundle size Test Maintainability Test Coverage StackShare

Shepherd is an open source, fully featured, digital adoption platform (DAP) and user on-boarding service. Use our hosted SaaS or deploy to your own infrastructure to run on-premise.

Supported Browsers

IE / Edge
Edge last 2 versions last 2 versions last 2 versions


Shepherd makes it simple to create custom user on-boarding tours, trainings and announcements to drive user adoption.

Shepherd enables you to guide users through a custom tour or journey within your app or website. Highly customizable with minimal styles, Shepherd allows for powerful customization while being easy to use. Various frameworks supported including React, Ember, Angular, Vue.js, ES Modules, or plain JavaScript.

Shepherd Pro

Unlock additional capabilities and more full featured Journeys.

  • Customizable Tour Templates: Pre-designed templates for different types of software that can be easily customized.
  • Analytics Integration: To track user engagement and effectiveness of the tours.
  • Multi-Language Support: For global reach and accessibility.
  • User Behavior Tracking: To understand how users interact with the tours and optimize accordingly.
  • Integration Capabilities: Easy integration with a wide range of web applications and software.
  • Responsive Design: Ensuring tours work seamlessly on all devices.
  • Feedback Mechanisms: Allowing users to provide feedback directly within the tours.
  • Advanced Branching Logic: For personalized tour experiences based on user actions or profiles.


See Shepherd Live on our docs website by clicking on the image: Guide your users through a tour of your app

Using Shepherd

Shepherd Pro hosted SaaS (Alpha)

You can try our hosted version for free at

The Entire Shepherd Service that powers Shepherd Pro is the newest iteration of Shepherd and includes the features of Shepherd Pro. You can set that up on your own infrastructure by using our Docker File, located here.

Shepherd Library (MIT License)

The Shepherd Standalone Library has been open source since the very beginning. Check out our tutorials here:

White Glove Services

If you have an idea or project in mind and would like to engage our team to build a custom tour, training or on-boarding experience, get in touch!



We encourage contributions of all kinds. If you would like to contribute in some way, please review our guidelines for contributing. Our release process is mostly automated. For more details, see

Projects Already Using Shepherd

SimplePlanner uses Shepherd to help new users get familiar with its collaborative scheduling approach. You do need to sign up via OAuth or email to see the scheduling tour. Check out the Envato Tuts+ Startup Series on its codebase which describes how Simple Planner was built.

LogSeq uses Shepherd to guide users through initial setup steps.

Snapsure uses Shepherd to help photographers learn how to set up alerts for their desired picture-perfect weather conditions.

The Drupal CMS uses Shepherd to offer tours of it's core modules, and allows developers to add Tours to their custom and contributed modules.

Budibase is an open source application which allows you develop low code applications rapidly and efficiently.This Budibase Shepherd tour plugin allows you to create interative walkthroughs for your application.

Your Project Here

If you have a cool open-source library built on Shepherd, PR this doc.


FOSSA Status