opf / opf/openproject-docker-compose

Onboarding tour URL parameter start_onboarding_tour=true leads to 404 / page not found in OpenProject 17.0.2

Open
#141 1 comment 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Shell
Stars
342
Forks
315
PR merge metrics
No merged PRs in 30d

Description

Description
When a new user is created in OpenProject 17, the application offers an onboarding tour.
However, when the tour is triggered via the URL parameter start_onboarding_tour=true, the target page results in a 404 – Page not found error.

Example URL:
/projects//work_packages?start_onboarding_tour=true

Instead of starting the onboarding tour, the application reports that the page cannot be found.

Expected behavior

  • The onboarding tour should start automatically when start_onboarding_tour=true is present in the URL
  • Alternatively, the parameter should be ignored gracefully without breaking page routing

Actual behavior

  • The work packages page is not found
  • The user is blocked from accessing the project context
  • Onboarding cannot be completed

Environment

  • OpenProject version: 17.0.2
  • Deployment type: self-hosted
  • Browser: Chrome on MacOS
  • User type: newly created user (first login)

Additional context

  • The codebase contains onboarding-related routes and components, but the query parameter start_onboarding_tour does not seem to be handled correctly at routing or controller level
  • It is unclear whether this parameter was deprecated, renamed, or never fully implemented in the current UI architecture

Questions for maintainers

  • Is start_onboarding_tour=true still a supported mechanism in OpenProject 17?
  • Has the onboarding tour entry point been moved or refactored?
  • Should this parameter be removed, redirected, or fixed?

Impact
This issue affects first-time user experience and may cause confusion during onboarding, especially in enterprise or customer-facing deployments.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reproducing the reported /projects//work_packages?start_onboarding_tour=true URL in OpenProject 17.0.2, then inspect the onboarding-related routes, controllers, and components mentioned in the issue. Done means the work packages page loads and the onboarding tour starts, or the parameter is ignored without causing a 404.

Written by the indexing model from the issue text.

Assessment

Domain
web-dev
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.