Hopscotch vs Shepherd.js

Shepherd.js is an open-source library for creating guided tours. It's well-maintained and feature-rich, but is it the right choice for your team?

Overview

Shepherd.js is a JavaScript library that guides users through your app with customizable tours. Originally created by HubSpot, it's now maintained by Ship Shape and has an active community.

Hopscotch is a complete user onboarding platform that lets product and marketing teams create tours, tooltips, and surveys without writing code — and without waiting for developer availability.

Feature Comparison

The True Cost: Developer Time

Shepherd.js is free to download, but implementation requires significant developer investment.

Implementation Cost

Building a production-ready onboarding with Shepherd.js requires:

• Installing and configuring the library
• Writing JavaScript/TypeScript for each tour
• Creating custom CSS to match your brand
• Handling dynamic content and SPAs
• Managing tour state and user progress
• Building your own analytics (or going without)
• Testing across browsers and devices

Estimated time: 30-60 hours

At $150/hour, that's $4,500 - $9,000 before you've onboarded a single user.

Ongoing Maintenance

With Shepherd.js, every tour change requires:

• Developer time to modify code
• Code review and QA
• Deployment to production
• Coordination between product and engineering

Time per update: 2-8 hours

Product manager wants to test different copy? That's a ticket. Marketing wants to add a tour for a campaign? Better plan it into the roadmap.

With Hopscotch

• Implementation: 15 minutes (one script tag)
• Create a tour: 10 minutes (visual editor)
• Update a tour: 2 minutes (instant publish)
• Who can do it: Anyone — no code required

What About Using AI to Build It?

AI coding assistants can help you implement Shepherd.js faster, but they don't solve the fundamental problem: every tour change still requires a developer, code review, and deployment. If AI makes your team 10x more productive, that productivity is better spent on your core product—not onboarding plumbing. Read more about build vs buy in the AI era.

When to Choose Shepherd.js

Shepherd.js might be right for you if:

• You have frontend developers with dedicated bandwidth
• You need deep customization at the code level
• You're building a one-time onboarding that won't change
• You want to own and host everything yourself
• Analytics and user segmentation aren't priorities
• You're comfortable with community-based support

When to Choose Hopscotch

Hopscotch is the better choice when:

• You want to launch tours in days, not weeks
• Product or marketing teams need to create tours independently
• You need analytics to measure tour effectiveness
• You want to segment users and personalize experiences
• Iteration speed matters — test and update without deploys
• You value responsive customer support
• You need surveys and tooltips alongside tours

The Real Cost of "Free"

We talk to teams every week who started with Shepherd.js or similar libraries. The story is usually the same:

1. "We'll just build it ourselves — how hard can it be?"
2. Weeks of development time
3. A basic tour that works... mostly
4. No analytics, no segmentation, hard to update
5. Eventually switching to a platform like Hopscotch

One engineering lead told us: "We spent 6 weeks building onboarding with Shepherd. If I'd known Hopscotch existed, we would have saved a month of engineering time."

Pricing Comparison

Total first-year cost:

• Shepherd.js: $4,500+ (plus ongoing dev time)
• Hopscotch: $1,188 (everything included)

Related Comparisons

Exploring other open-source options? See our other comparisons:

• Hopscotch vs Intro.js - The original step-by-step guide library
• Hopscotch vs Driver.js - Minimal, dependency-free highlighting
• Hopscotch vs React Joyride - Popular React tour component
• Hopscotch vs React Tour - Lightweight React alternative

Want to understand the full picture? Read Build vs Buy: The Real Cost of In-App User Onboarding.

Comparing SaaS solutions? Check out Hopscotch vs Appcues and Hopscotch vs Chameleon.