Tourist is a small library for building guided, step-by-step tours inside web applications, letting developers create interactive walk-throughs that highlight UI elements and explain workflows to end users. It provides a simple API for defining a sequence of steps, each tied to a DOM selector or screen area, with configurable titles, descriptions, next/previous controls, and optional callbacks for custom behavior. The library is designed to be flexible: steps can be triggered programmatically, attached to single-page app routing, or displayed conditionally based on user state, making it suitable for onboarding, feature discovery, or contextual help. Tourist aims to be framework-agnostic so it can be integrated into plain JavaScript projects as well as React, Vue, or other frontend stacks with minimal glue code. It also supports common niceties like mobile-friendly positioning, step-skipping, and hooks for analytics events so teams can measure adoption of guided flows.
Features
- Enables creation of interactive, guided walkthroughs for UI tutorials
- Works declaratively to define tour steps and flow
- Flexible enough for complex, event-driven front-end frameworks (e.g., Backbone.js)
- Lightweight and easy to integrate into existing codebases
- Provides callbacks/hooks for synchronization with app state
- Designed to be intuitive for both developers and users