MCPcopy
hub / github.com/shipshapecode/shepherd

github.com/shipshapecode/shepherd @v15.2.2-shepherd.js sqlite

repository ↗ · DeepWiki ↗ · release v15.2.2-shepherd.js ↗
179 symbols 505 edges 75 files 47 documented · 26%
README

Shepherd.js Logo

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

Shepherd is an open source, fully featured, digital adoption platform (DAP) and user on-boarding service.

Supported Browsers

| IE / Edge

Edge | Firefox

Firefox | Chrome

Chrome | Safari

Safari | | --------- | --------- | --------- | --------- | | Edge| last 2 versions| last 2 versions| last 2 versions

Shepherd

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.

Demo

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

Using Shepherd

Shepherd Open Source Library

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

React Shepherd Wrapper

Angular Shepherd Wrapper

Vue Shepherd Wrapper

Ember Shepherd Wrapper

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!

Resources

Contributing

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 RELEASE.md.

Projects Already Using Shepherd

Rails gems

abraham

Rails engine that generates and tracks Shepherd tours within an application

Websites and Apps

SimplePlanner

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

LogSeq uses Shepherd to guide users through initial setup steps.

Snapsure

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

Drupal

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 Shepherd Tour Plugin

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.

License

Shepherd.js is dual-licensed under AGPL-3.0 and a Commercial License.

  • Free for open source and non-commercial use under AGPL-3.0
  • Commercial license required for commercial products and revenue-generating companies

See LICENSE.md for complete details or visit shepherdjs.dev/pricing to purchase a commercial license.

FOSSA Status

Extension points exported contracts — how you extend this code

ShepherdContextType (Interface)
(no doc)
packages/react/src/index.tsx
EventOptions (Interface)
(no doc)
shepherd.js/src/tour.ts
TourOptions (Interface)
(no doc)
shepherd.js/src/tour.ts
StepOptions (Interface)
(no doc)
shepherd.js/src/step.ts
StepOptionsArrow (Interface)
(no doc)
shepherd.js/src/step.ts
StepOptionsAttachTo (Interface)
(no doc)
shepherd.js/src/step.ts

Core symbols most depended-on inside this repo

start
called by 84
shepherd.js/src/tour.ts
getCurrentStep
called by 34
shepherd.js/src/tour.ts
getElement
called by 33
shepherd.js/src/step.ts
addStep
called by 31
shepherd.js/src/tour.ts
next
called by 26
shepherd.js/src/tour.ts
createShepherdButton
called by 24
shepherd.js/src/components/shepherd-button.ts
createShepherdModal
called by 23
shepherd.js/src/components/shepherd-modal.ts
on
called by 22
shepherd.js/src/evented.ts

Shape

Function 99
Method 52
Interface 16
Class 12

Languages

TypeScript100%

Modules by API surface

shepherd.js/src/step.ts35 symbols
shepherd.js/src/tour.ts27 symbols
shepherd.js/src/components/shepherd-modal.ts20 symbols
shepherd.js/src/utils/general.ts11 symbols
shepherd.js/src/utils/floating-ui.ts8 symbols
shepherd.js/test/unit/step.spec.js7 symbols
shepherd.js/src/evented.ts6 symbols
shepherd.js/src/utils/type-check.ts5 symbols
shepherd.js/src/components/shepherd-element.ts5 symbols
shepherd.js/src/utils/dom.ts4 symbols
shepherd.js/test/cypress/integration/test.acceptance.cy.js3 symbols
shepherd.js/test/cypress/dummy/js/prism.js3 symbols

Dependencies from manifests, versioned

@arethetypeswrong/cli0.18.2 · 1×
@astrojs/check0.9.6 · 1×
@astrojs/mdx4.3.13 · 1×
@astrojs/rss4.0.15 · 1×
@astrojs/sitemap3.7.0 · 1×
@astrojs/starlight0.37.6 · 1×
@astrojs/vercel9.0.4 · 1×
@babel/core7.29.0 · 1×
@babel/plugin-transform-typescript7.28.6 · 1×
@babel/preset-env7.29.0 · 1×
@babel/preset-typescript7.28.5 · 1×
@eslint/js9.39.3 · 1×

For agents

$ claude mcp add shepherd \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact