3.0.2

• Fix React 18 aggressive batching: 79a7ef0
• Re-organize modules: 324b5c9
• Propagate origin through all UI-triggered control methods: ee6aad3

3.0.1

• Upgrade dependencies: 2199f9e
• Add support to spotlight styles (SVGPath): 40e6faa

3.0.0

V3 is a complete rewrite focused on modern React patterns, smaller bundle size, and a more intuitive API.

Highlights

• useJoyride hook — replaces getHelpers with a proper hook returning controls, state, current step, failures, and event subscriptions
• New event system — discriminated event types (tour:start, step:before, tooltip, etc.) with onEvent(data, controls) and selective subscription via on()
• Step hooks — async before/after callbacks for per-step logic
• Floating UI — replaced Popper.js/react-floater with direct @floating-ui/react-dom integration
• Flexible targets — scrollTarget and spotlightTarget for independent positioning; targets accept RefObject, callbacks, and CSS selectors
• SVG overlay — precise spotlight rendering replacing CSS box-shadow
• Portal rendering — tour UI renders via React portal with custom container support
• New component props — arrowComponent, loaderComponent
• React 16.8–19 support
• ~30% smaller bundle through dependency replacement

Breaking changes

• Named export: import { Joyride } from 'react-joyride'
• callback replaced by onEvent prop
• run defaults to false
• getHelpers replaced by useJoyride() hook
• Step-level props consolidated into flat options (set globally or per-step)
• styles.options theming moved to options prop
• Button visibility via buttons array (['back', 'close', 'primary'])
• Multiple prop renames (disableBeacon → skipBeacon, disableCloseOnEsc → dismissKeyAction, floaterProps → floatingOptions, etc.)
• Removed: disableScrollParentFix, styles.spotlight, legacy overlay styles

Full migration guide: https://react-joyride.com/docs/migration
What's new: https://react-joyride.com/docs/new-in-v3

For a complete list of changes, check the PR.

---

We'd love your feedback! If you run into issues, have questions about migrating, or want to share ideas, join the discussion: #1196

2.9.3

• Update custom-components docs: 650ab36
• Upgrade dependencies: 9874150
• Fix scroll for targets with custom scroll parent or fixed position: 3648311
• Disable tooltip keyboard focus if the disableScrolling is set: af6fa9e
• Fix locale handling of custom components: 826669d

2.9.2

• Fix primary button text with showProgress: 58ecae0
• Fix lifecycle for centered steps: 8ee561a
• Fix docs and types: 6bf66ca

2.9.1

• Remove duplicate store update for placement "center": 9bac425

2.9.0

• Upgrade dependencies: 76b0eae
• Add try/catch to getElement helper: 92e204d
• Add LIFECYCLE.INIT to Overlay "hideSpotlight": e4a75a4
• Add "nextLabelWithProgress" to step locale: 0fbf346
• Update "getDocumentHeight" median parameter default to false: d7febf7
• Fix types and defaults: 805356c

2.8.2

• Upgrade dependencies: 0b4912f
• Update GH Actions workflow: 7327b2c
• Hide the Beacon for centered steps or disableBeacon: 8fc34df

2.8.1

• Replace @gilbarbara/helpers with local utils: 84f8b24
• Upgrade dependencies: 7f078e3
• Add optional "data" to step: d6d6eaa

2.8.0

• Upgrade dependencies and migrate to pnpm: 6dd35ef
• Remove unnecessary "as const" statements: 703c453
• Fix getStyles: af4a702
• Update Tooltip to hide the primary button if the locale is empty: 444b7c9
• Refactor Overlay: 77dc4c8
• Migrate tests to vitest: 024f3e0