[GH-ISSUE #1846] PoC "Wizard" portal flow #1549

New issue

Open

opened 2026-02-28 01:30:30 +03:00 by kerem · 2 comments

kerem commented

2026-02-28 01:30:30 +03:00

Owner

Originally created by @eimermusic on GitHub (Jan 26, 2026).
Original GitHub issue: https://github.com/tzapu/WiFiManager/issues/1846

I have a fork where I added a "Wizard-like" (step-by-step or linear) flow for the WiFiManager portal.

I wanted to post here to gauge if there is any broader interest.
I have implemented it to be compatible alongside existing functionality but nothing has been tesed for regressions yet.

This simple implementation works like this:

WiFI setup screen
Wifi verification
Custom parameter setup screen
Custom parameter verification using a callback
Confirmation screen.

If Wifi is connected, it jumps straight to custom parameter setup.
There is a simple "progress" dialog while verifications are happening.

This functionality works well for me and is great for setting up wifi + API credentials and having all of it verified before closing the config portal.

No support for any of the other features (erase, info...) simply because I have no need for them myself.

https://github.com/eimermusic/WiFiManager

Originally created by @eimermusic on GitHub (Jan 26, 2026). Original GitHub issue: https://github.com/tzapu/WiFiManager/issues/1846 I have a fork where I added a "Wizard-like" (step-by-step or linear) flow for the WiFiManager portal. I wanted to post here to gauge if there is any broader interest. I have implemented it to be compatible alongside existing functionality but nothing has been tesed for regressions yet. This simple implementation works like this: 1. WiFI setup screen 2. Wifi verification 3. Custom parameter setup screen 4. Custom parameter verification using a callback 5. Confirmation screen. If Wifi is connected, it jumps straight to custom parameter setup. There is a simple "progress" dialog while verifications are happening. This functionality works well for me and is great for setting up wifi + API credentials and having all of it verified before closing the config portal. No support for any of the other features (erase, info...) simply because I have no need for them myself. https://github.com/eimermusic/WiFiManager

kerem commented

2026-02-28 01:30:30 +03:00

Author

Owner

@tablatronix commented on GitHub (Jan 26, 2026):

nice I always thought it would be nice like that, but wound up just maintaining the project instead of making UI changes.
Got any screenshots

@tablatronix commented on GitHub (Jan 26, 2026): nice I always thought it would be nice like that, but wound up just maintaining the project instead of making UI changes. Got any screenshots

kerem commented

2026-02-28 01:30:30 +03:00

Author

Owner

@eimermusic commented on GitHub (Feb 2, 2026):

Sorry for the delay. Here are some screenshots from my phone connecting to the portal. The custom parameter verification has a similar spinner and success / fail screen as the wifi step.

And after filling in those parameters there is spinner and success screen.
The parameter verification has active wifi available to verify the API credentials for real.

Skip and Back are the questionably named buttons to go back and forth in the "wizard".

@eimermusic commented on GitHub (Feb 2, 2026): Sorry for the delay. Here are some screenshots from my phone connecting to the portal. The custom parameter verification has a similar spinner and success / fail screen as the wifi step. <img width="301" height="655" alt="wifi network list" src="https://github.com/user-attachments/assets/12a73aad-a9c2-4bc3-a8db-1a96bd6f3605" /> ### <img width="301" height="655" alt="wifi form" src="https://github.com/user-attachments/assets/cc81ab7f-eb0c-4e4d-bfdd-fb01e65addb2" /> ### <img width="301" height="655" alt="wifi verifying" src="https://github.com/user-attachments/assets/44f67f5b-2e54-40ca-96cc-25745292f820" /> ### <img width="301" height="655" alt="wifi confirm" src="https://github.com/user-attachments/assets/9a368ba9-12df-446c-a591-6b3b60c62908" /> ### <img width="301" height="655" alt="custom params" src="https://github.com/user-attachments/assets/e817ed9b-59c0-41e2-a361-95ca18af67f1" /> And after filling in those parameters there is spinner and success screen. The parameter verification has active wifi available to verify the API credentials for real. Skip and Back are the questionably named buttons to go back and forth in the "wizard".