Tour Guide: A Zero-Dependency Product Tour Web Component for Any Framework

The author built @xkid1/tour-guide, a product-tour Web Component with no runtime dependencies, after struggling with common onboarding-tour problems like popovers overflowing small screens, hidden targets, CSS conflicts, and accessibility gaps. The tour runs in plain HTML as well as React, Vue, Svelte, Angular, Electron, and mobile WebViews, using a single shared implementation. Its Shadow DOM isolates styles while still allowing theming through CSS variables and parts. Framework adapters receive the developer's own framework instance, so the package never bundles a second copy, and the full browser bundle is about 16 KB gzipped. Steps support async hooks and function-based targets so the tour can wait for dynamically rendered elements, and errors cancel the step transition while emitting a tour-error event.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in