What's Changed

• Update env example by @winter100004 in #220
• Update .env.example by @winter100004 in #221
• Fix password error message by @winter100004 in #223
• Enhance docker-compose configuration with health checks by @winter100004 in #224

Full Changelog: v0.3.1...v0.3.2

🚀 Usertour v0.3.1 — Smarter license support, better caching

A small but important release focused on smoother upgrades and license key management.

✨ New Features

License Key Upload
You can now upload license keys directly from the admin panel — making it easier for self-hosted customers to unlock paid features.

🛠 Improvements

Smarter Nginx Configuration
We’ve updated the default Nginx setup to avoid browser caching issues with usertour.js and usertour.iife.js during upgrades. No more mysterious version mismatches.

Full Changelog: v0.3.0...v0.3.1

✨ New Features

OpenTelemetry Integration
Usertour now supports [OpenTelemetry](https://opentelemetry.io/) out of the box.
You can e F440 xport both traces and metrics by configuring your preferred endpoint — perfect for production observability.

• Report WebSocket session metrics in real time
• Trace request flows across your system
• Easily integrate with Grafana, Prometheus, and more

License Key Support for Paid Features
We’ve added license key validation to support our self-hosted Business and Enterprise plans.
Just drop in your license key and unlock premium features without cloud dependency.

Workspace-based Module Resolution
Cleaner internal structure and faster local development using workspaces.

Custom Cursor Configuration
You can now customize the pointer style (cursor) for tour steps — useful for highlighting interactive elements in your app.

🛠 Improvements

Smarter Launcher Handling
WebSocket sessions now respond immediately for launcher-based tours — improving perceived speed and interactivity.

Sentry Integration
We’ve integrated Sentry to help debug issues faster — for both us and those running their own instances.

Cleaner Package Naming
Smaller, more consistent packages — easier to read, install, and manage.

Branding Control
Added an environment variable to remove Usertour branding — available for paid plans.

🐞 Bug Fixes

• No more duplicated analytics calls when using WebSocket events
• Stability improvements across all real-time interactions
• Edge case handling for license validation and missing keys

Full Changelog: v0.2.7...v0.3.0

✨ New Features

• Conditional Variations by Theme
  Usertour now supports conditional content variations based on the active theme.
  You can target light vs dark modes, or use user traits and URL rules — perfect for adapting your experience visually.

• Smarter Content Refresh & Requests
  We've optimized how usertour.js fetches and syncs content:

  • Fewer network requests
  • Faster response between steps
  • Smoother transitions on click

🛠 Improvements

• WebSocket Performance Boost

  • Combined multiple fetches into one parallel call
  • Reduced response time on session analytics
  • Cleaner query syntax under the hood

• UI/UX Polishing

  • Better loading and disabled states after deletion actions
  • Fewer awkward moments when waiting for UI updates

• Developer Quality of Life

  • Avatar fallback fixes in environment switcher
  • Improved session navigation with wrapped links

🐞 Bug Fixes

• No more unnecessary listContents requests on SendEvent
• Segment filtering is now rock-solid

🙌 Shoutout

Thanks to @shodown96 for their first contribution! 🎉

Full Changelog: [v0.2.6...v0.2.7](v0.2.6...v0.2.7)

🚀 New Features

• Flexible Progress Bar Styles – You can now choose from 5 types of tooltip progress bars by setting the theme:

  • Narrow Progress Bar
  • Chain (Rounded or Squared)
  • Dots
  • Numbered (1 of 3)
    These options let you better match your product's style and vibe.

• Auto Dismiss for Checklists – Add autodismiss to your checklist. When users complete all items, the checklist will auto-close — no clicks required.

• Smarter Flow Logic – Temporarily hidden content no longer blocks other flows from starting. This makes auto-started content more predictable and reliable.

• User & Company Session Lists – You can now view a user's session history, and also see all members under a company. Super helpful for debugging or analytics.

🛠 Improvements

• Replaced all toast notifications with [Sonner](https://sonner.emilkowal.ski/) for a cleaner, more modern feel.
• Improved SDK component performance and animations.
• Loading states and spinners added for a smoother experience in detailed content views.
• Segment loading and filtering logic fully optimized.

🐞 Bug Fixes

• Fixed an issue where segment filtering caused incorrect results.
• Resolved bugs related to checklist progress bar display and default behavior.

Full Changelog: [v0.2.5...v0.2.6](v0.2.5...v0.2.6)

🚀 New Features

• New Animations – Tooltips now include smooth docking transitions. Checklists come with a completion animation and will automatically expand when users complete an item, creating a more dynamic experience.

• Flow + Checklist = Infinite Logic – We’ve enhanced how flows and checklists can work together. You can now build complex, multi-branch onboarding logic using a mix of flows and checklists — flexible enough to cover almost any use case.

• Push-based Updates – Usertour.js no longer relies on polling to fetch content. Instead, we now use Socket.IO to push real-time updates to users — including modals, surveys, and checklists. It’ 9C6D s faster, lighter, and smarter.

• 🔁 Start From a Specific Step – When triggering a flow from inside another flow or checklist, you can now choose which step to start from — not just the first step. This gives you more flexibility in designing contextual onboarding.

🎨 UX & Interaction Improvements

• Improved all loading and debounce logic across the app for smoother data handling.
• Reworked several core components to drastically improve the interactive experience.
• Added confirmation modal when dismissing incomplete checklists (fully completed ones dismiss instantly).
• Fixed checklist launcher sizing issues.
• Optimized checklist item interactivity and launcher visuals.

🐞 Bug Fixes

• Fixed an issue where attribute selectors could make the page unclickable.
• Added try-catch around eval() usage to prevent runtime crashes caused by malformed logic.
• Fixed flow startup rule behavior when used with checklists and branching flows.

Full Changelog: v0.1.13...v0.2.0

🚀 New Features

• Programmatic Flow Start – Added a start() method to trigger flows, checklists, or guides on demand. Great for custom triggers like a “Replay Tutorial” button in your app.

• Self-hosted Mode Member Invites – Now you can invite team members when using Usertour in self-hosted mode.

🐞 Bug Fixes

• Improved error handling on the startup rules page — invalid or missing rules won’t auto-save and now show clear error messages.

• Fixed flow activation and deactivation issues related to startup rules.

• Added exception handling to the list-content API to prevent crashes from misconfigurations.

🎨 Improvements

• Enhanced editor default placeholder text for a smoother editing experience.

Full Changelog: v0.1.12...v0.1.13