Two things currently fire right after email verification, and both land before the user has anything to look at.
The Shepherd welcome tour gets flagged from UnverifiedEmail.vue on successful verification, then picked up in pages/team/index.vue once resources have loaded. It walks abstract concepts: what a hosted instance is, what a remote instance is, where the audit log lives.
The education modal fires as the tour's completion callback from the same place. It's "Where would you like to get started?" with a list of external doc links that open in new tabs.
Neither makes sense on the onboarding path. The Expert is having a conversation with the user, and a tour talking over it about concepts they haven't met yet is actively in the way.
Both stay exactly as they are for classic signups.
Done when
- Neither the tour nor the education modal fires when the onboarding flag is on.
- Both behave exactly as they do today when it's off.
- Both remain reachable from the user menu, which is where
PageHeader.vue already offers them.
Worth knowing
The tour flag persists to localStorage via the ux-tours store, so suppressing it needs care about whether the flag is set and ignored, or never set in the first place. Never setting it is cleaner, since a flag that's set and ignored will fire later when the user hits a page that checks it.
Not replacing them with anything. Explaining the platform is out of scope for this epic, and the Expert covering platform concepts in context is a separate idea for another time. What the Expert does explain is how to use the thing it just built, which is a different task.
Worth checking whether anything else keys off tour completion. pages/team/index.vue runs the education modal from the tour's close hook, and there's also a branch that wakes the Expert instead, so the interaction between tour, modal and assistant wake-up on arrival needs untangling rather than just switching one off.
Two things currently fire right after email verification, and both land before the user has anything to look at.
The Shepherd welcome tour gets flagged from
UnverifiedEmail.vueon successful verification, then picked up inpages/team/index.vueonce resources have loaded. It walks abstract concepts: what a hosted instance is, what a remote instance is, where the audit log lives.The education modal fires as the tour's completion callback from the same place. It's "Where would you like to get started?" with a list of external doc links that open in new tabs.
Neither makes sense on the onboarding path. The Expert is having a conversation with the user, and a tour talking over it about concepts they haven't met yet is actively in the way.
Both stay exactly as they are for classic signups.
Done when
PageHeader.vuealready offers them.Worth knowing
The tour flag persists to localStorage via the
ux-toursstore, so suppressing it needs care about whether the flag is set and ignored, or never set in the first place. Never setting it is cleaner, since a flag that's set and ignored will fire later when the user hits a page that checks it.Not replacing them with anything. Explaining the platform is out of scope for this epic, and the Expert covering platform concepts in context is a separate idea for another time. What the Expert does explain is how to use the thing it just built, which is a different task.
Worth checking whether anything else keys off tour completion.
pages/team/index.vueruns the education modal from the tour's close hook, and there's also a branch that wakes the Expert instead, so the interaction between tour, modal and assistant wake-up on arrival needs untangling rather than just switching one off.