This release includes 1 breaking change for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+8 more
ReleasePort's take
Light signalUserTour v0.7.5 moves all 60 workspace packages from @usertour-packages/* to @usertour/* namespace. Applications using these packages must update their imports.
Why it matters: All 60 workspace packages moved to @usertour/* in v0.7.5; update imports for all dependent projects to maintain compatibility.
Summary
AI summary@usertour-packages/* packages are removed and moved to @usertour/* namespace.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Breaking | Medium |
All 60 workspace packages move to @usertour/* from @usertour-packages/* All 60 workspace packages move to @usertour/* from @usertour-packages/* Source: llm_adapter@2026-05-21 Confidence: low |
— |
| Feature | Low |
@usertour/sdk version bumped to 0.7.0 to signal namespace change @usertour/sdk version bumped to 0.7.0 to signal namespace change Source: granite4.1:30b@2026-05-22-audit Confidence: low |
— |
| Refactor | Low |
Unified package namespace: all packages now under @usertour/* Unified package namespace: all packages now under @usertour/* Source: granite4.1:30b@2026-05-22-audit Confidence: low |
— |
| Refactor | Low |
Updated 791 import sites to reflect new @usertour/* namespace Updated 791 import sites to reflect new @usertour/* namespace Source: granite4.1:30b@2026-05-22-audit Confidence: low |
— |
| Refactor | Low |
Modified package.json name and dependencies entries for all packages Modified package.json name and dependencies entries for all packages Source: granite4.1:30b@2026-05-22-audit Confidence: low |
— |
| Refactor | Low |
Adjusted build:deps script, turbo.json, and Vite manual-chunk regex to use @usertour/* Adjusted build:deps script, turbo.json, and Vite manual-chunk regex to use @usertour/* Source: granite4.1:30b@2026-05-22-audit Confidence: low |
— |
| Refactor | Low |
Updated docs/architecture/packages.md namespace section and migration checklist Updated docs/architecture/packages.md namespace section and migration checklist Source: granite4.1:30b@2026-05-22-audit Confidence: low |
— |
Full changelog
This release collapses the monorepo's two package scopes into one. @usertour-packages/* is gone — every workspace package now lives under @usertour/*, matching the four packages that were already there. No user-visible behaviour change; this is a
one-shot mechanical refactor that closes a long-running source of decision friction and rename churn whenever a package's runtime shape changed.
What's Changed
📦 Unified package namespace
- All 60 packages previously under @usertour-packages/* move to @usertour/: every packages/components/ and packages/radix/* leaf, plus business-components / builder / contexts / editor / finder / gql / hooks / i18n / icons / dom / tailwind / widget /
ui. Apps and the four pre-unified packages (types, helpers, constants, license) keep their existing names. - Roughly 791 import sites, every workspace package.json's name and dependencies entries, the root build:deps script, the four dev* filter lists, turbo.json's dev.dependsOn, and the SDK Vite bundler's manual-chunk regex all switch over in one mechanical
pass. - docs/architecture/packages.md updates: the Namespace section now reads "every workspace package lives under @usertour/*", and the P1 → P2 migration checklist drops the namespace-rewrite step that's no longer needed. The types-vs-constants boundary
still applies.
🔢 SDK 0.7.0
- @usertour/sdk bumps to 0.7.0 to signal the namespace rename, since every transitive @usertour-packages/* import path that SDK consumers reached through has shifted.
🧹 Why now
The split between @usertour/* and @usertour-packages/* had drifted into a marker of "this package has been promoted to a Node-consumable shape yet" — a moving target that forced a rename every time a P1 package was promoted to P2. The v0.7.4 work to
promote @usertour-packages/constants triggered one such rename; codifying the unification now avoids the next one. With one scope, the package shape (P1 / P2) lives entirely in package.json fields and the build pipeline, which is where it belongs.
Full Changelog: https://github.com/usertour/usertour/compare/v0.7.4...v0.7.5
Breaking Changes
- Removed package scope @usertour-packages/*; all packages now live under @usertour/*.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About usertour
Usertour is an open-source user onboarding platform. It allows you to create in-app product tours, checklists, and surveys in minutes—effortlessly and with full control.The open-source alternative to Userflow and Appcues
Related context
Related tools
Earlier breaking changes
- v0.8.3 Removes the insecure 'development-key-not-secure' fallback for ENCRYPTION_KEY; operators must set the env var explicitly.
Beta — feedback welcome: [email protected]