Skip to content

Conversation

@raufbyrmv8
Copy link
Contributor

Description

This pull request improves the installation wizard header progress bar so that it reflects the current step of the wizard.

Changes made:

  • Updated header.vm to show a modern header with a shared progress bar.
  • Passed a progressPercent value from the initialization flow into the header template.
  • Mapped each wizard page to a percentage (language → install type → DB config → review → installing → complete).
  • Cleaned up the old JavaScript-only logic and now rely on server-side step information.

The header progress now feels consistent with the card content and gives the user a clear sense of where they are in the installation.

Issue I worked on

TRUNK-2853: Improve installation wizard progress bar

How to test

  1. Build the project:

    mvn clean install

2.Run the webapp with Jetty:

3.Open http://localhost:8080/openmrs/initialsetup and go through the Simple installation flow:

Step 1: “Which language do you prefer?”

Step 2: “Which type of installation do you want?”

Step 3: “Simple Installation” (database settings)

Step 4: “Review”

Step 5: “Tasks to execute” / Installing…

Step 6: Wizard complete

4.Verify that the header progress bar updates roughly as:

~20% on language selection

~40% on install type

~60% on simple installation database configuration

~80% on review page

100% while tasks are executing and on completion screen.

Checklist

I have read the pull request guidelines.

I ran mvn clean install at the root of the project.

I manually tested the Simple installation flow with MySQL and verified the header progress bar behaves as expected.

mvn jetty:run

@suubi-joshua
Copy link
Contributor

suubi-joshua commented Dec 9, 2025

It would be nice if you could attach an image or video to show the improvements. Also could you put the JIRA link to ticket.

@raufbyrmv8
Copy link
Contributor Author

Hi @suubi-joshua,

Thanks for the feedback!
I’ve attached a few screenshots showing the updated installation wizard progress bar during the test installation (while it is running and after it completes).

Please let me know if you’d like me to capture anything else or make further changes.

Screenshot 2025-12-09 212540 Screenshot 2025-12-09 212619 Screenshot 2025-12-09 212638 Screenshot 2025-12-09 212700 Screenshot 2025-12-09 212719

@suubi-joshua
Copy link
Contributor

I think its not requirement to shift the status bar to up there for this ticket

@suubi-joshua
Copy link
Contributor

I think the progress bars that are being talked about are for the import test data and updates just skipping to the completion state during test installation.
NOt the main progress bar
https://openmrs.atlassian.net/browse/TRUNK-2853

@raufbyrmv8
Copy link
Contributor Author

Thanks for the clarification, Joshua!

I will revert the changes I made to the main progress bar and restore the code to its original state. After that, I will start working on the correct fix for the progress bars used during test data import and updates as you pointed out.

@raufbyrmv8 raufbyrmv8 closed this Dec 11, 2025
@raufbyrmv8 raufbyrmv8 force-pushed the TRUNK-2853-progress-bar-fix branch from d73a16d to 4488cc9 Compare December 11, 2025 12:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants