Setup Wizard #13

New issue

Open

opened 2026-01-04 03:30:24 +01:00 by myrmidex · 0 comments

myrmidex commented

2026-01-04 03:30:24 +01:00

(Migrated from codeberg.org)

Modal wizard guiding new users through initial setup of household members and dishes.

Trigger:

Show wizard when planner.show_wizard == true AND users.count == 0 AND dishes.count == 0

Skip entirely for demo imports (they already have data).

Model change:

Add show_wizard boolean to Planner, default true.

Welcome screen

Wizard hat icon
"Welcome to DishPlanner! Let's get you started."
[Start Setup] button

Add household members

"Who's eating?"
Name input + [Add another]
[Next] / [Skip]

Add dishes

"What do you like to cook?"
Dish name input + [Add another]
[Finish] / [Skip]

Complete

"You're ready to start planning!"
If skipped users: "Don't forget to add household members on the Users page"
If skipped dishes: "Don't forget to add dishes on the Dishes page"
[Go to Calendar]

Actions:

Dismiss (X) or complete → set show_wizard = false
Add user → create via existing endpoint
Add dish → create via existing endpoint (name only)

Components:

SetupWizardModal - container, step state
WizardStep - reusable step wrapper
Step components for users/dishes/complete

Modal wizard guiding new users through initial setup of household members and dishes. #### Trigger: Show wizard when planner.show_wizard == true AND users.count == 0 AND dishes.count == 0 Skip entirely for demo imports (they already have data). #### Model change: Add show_wizard boolean to Planner, default true. #### Modal flow: 1. Welcome screen - Wizard hat icon - "Welcome to DishPlanner! Let's get you started." - [Start Setup] button 2. Add household members - "Who's eating?" - Name input + [Add another] - [Next] / [Skip] 3. Add dishes - "What do you like to cook?" - Dish name input + [Add another] - [Finish] / [Skip] 4. Complete - "You're ready to start planning!" - If skipped users: "Don't forget to add household members on the Users page" - If skipped dishes: "Don't forget to add dishes on the Dishes page" - [Go to Calendar] #### Actions: - Dismiss (X) or complete → set show_wizard = false - Add user → create via existing endpoint - Add dish → create via existing endpoint (name only) #### Components: - SetupWizardModal - container, step state - WizardStep - reusable step wrapper - Step components for users/dishes/complete