Turn first-run setup into a guided wizard #274

Merged

erik merged 1 commit from feat/task-caa1c834-setup-wizard into main

2026-07-25 16:17:43 -05:00

erik commented

2026-07-25 16:12:00 -05:00

Owner

Summary

Replace the first-run setup checklist with a focused four-step wizard that validates each section before publication.

Task

Task: task-caa1c834

Changes

remove settings navigation and unrelated links from setup
split readiness, site identity, actor identity, and publication into separate steps
preserve values across Back and Next navigation with client- and server-side validation
mark required fields, provide examples, and show field-specific errors
publish from the final review step and redirect to the homepage
add setup wizard route coverage and regenerate Tailwind CSS

Testing

Unit tests added/updated
Manual testing performed in Chromium through login, all wizard steps, publication, and homepage redirect

Checklist

./scripts/pre-pr.sh passes
Documentation updated (not needed)
No unrelated changes included

## Summary Replace the first-run setup checklist with a focused four-step wizard that validates each section before publication. ## Task Task: task-caa1c834 ## Changes - remove settings navigation and unrelated links from setup - split readiness, site identity, actor identity, and publication into separate steps - preserve values across Back and Next navigation with client- and server-side validation - mark required fields, provide examples, and show field-specific errors - publish from the final review step and redirect to the homepage - add setup wizard route coverage and regenerate Tailwind CSS ## Testing - [x] Unit tests added/updated - [x] Manual testing performed in Chromium through login, all wizard steps, publication, and homepage redirect ## Checklist - [x] `./scripts/pre-pr.sh` passes - [x] Documentation updated (not needed) - [x] No unrelated changes included

erik added 1 commit

2026-07-25 16:12:00 -05:00

feat: guide owners through first-run setup

CI / build-lint-test (pull_request) Successful in 2m13s

Details

6f01bf4198

Task: #task-caa1c834

erik commented

2026-07-25 16:16:16 -05:00

Author

Owner

Review update

PR: #274 is open; Forgejo CI run #445 is green.
Result: approved
Summary: The focused four-step setup wizard removes settings navigation, validates each section, preserves values between steps, and publishes with a redirect to the public homepage. The route and template changes are covered by setup wizard tests.

Acceptance criteria

Met: The setup flow displays no sidebar navigation or unrelated settings links.
Met: Each setup section appears on a separate wizard step.
Met: Forward navigation requires valid required fields on the current form step, with server-side validation as enforcement.
Met: Required fields are visually marked and expose native required semantics.
Met: Every field includes example helper text and an example placeholder.
Met: Entered values persist through hidden form values and are restored when navigating back.
Met: Validation errors identify the affected field and provide corrective guidance.
Met: The final step clearly explains that completion publishes the site.
Met: Publishing completes setup and redirects to /.
Met: Automated tests cover focused wizard rendering, navigation, validation, value persistence, publication, and redirect behavior.

Blocking issues

None.

Warnings

None.

Final verdict

Approved.

Follow-up: Await explicit human merge approval; this review does not merge the PR.

### Review update - **PR:** #274 is open; Forgejo CI run #445 is green. - **Result:** approved - **Summary:** The focused four-step setup wizard removes settings navigation, validates each section, preserves values between steps, and publishes with a redirect to the public homepage. The route and template changes are covered by setup wizard tests. #### Acceptance criteria - **Met:** The setup flow displays no sidebar navigation or unrelated settings links. - **Met:** Each setup section appears on a separate wizard step. - **Met:** Forward navigation requires valid required fields on the current form step, with server-side validation as enforcement. - **Met:** Required fields are visually marked and expose native required semantics. - **Met:** Every field includes example helper text and an example placeholder. - **Met:** Entered values persist through hidden form values and are restored when navigating back. - **Met:** Validation errors identify the affected field and provide corrective guidance. - **Met:** The final step clearly explains that completion publishes the site. - **Met:** Publishing completes setup and redirects to `/`. - **Met:** Automated tests cover focused wizard rendering, navigation, validation, value persistence, publication, and redirect behavior. #### Blocking issues - None. #### Warnings - None. #### Final verdict **Approved.** - **Follow-up:** Await explicit human merge approval; this review does not merge the PR.

erik merged commit 3fe446a732 into main

2026-07-25 16:17:43 -05:00

erik deleted branch feat/task-caa1c834-setup-wizard

2026-07-25 16:17:43 -05:00

erik referenced this pull request from a commit

2026-07-25 16:17:43 -05:00

Merge pull request 'Turn first-run setup into a guided wizard' (#274) from feat/task-caa1c834-setup-wizard into main