Feature/recommendation wizard

[Programer-Ed]

Description

This PR introduces an interactive, multi-step Recommendation Wizard to the app.

Features

• One-question-per-screen flow

• Beginner-friendly, focused UX

• Emits selected answers via @Recommend event

• Fully dark/light mode compatible using --color-* theme variables

• Includes restart functionality

This sets up the foundation for filtering self-hosted app recommendations based on user preferences.

Related issue

• Hook answers into existing filter logic
• Display recommendations below the wizard

Changes made

• Feature added: recommendation wizard UI & logic

• Bugfix

• Refactoring

• Docs update

• Other (please describe):

Closes #68

How to test it

1. Go to the wizard page/component

2. Walk through each step and select answers

3. Observe the @Recommend event with selected options

4. Toggle theme — wizard should respect light/dark styling

Checklist

• My code follows the style of this project
• I’ve tested it or verified it works as expected
• I’ve added comments or documentation where needed

---

Contributor Statement

By submitting this pull request, I confirm that:

• I am voluntarily contributing this code under the project's license
• I have the legal right to do so
• I understand this contribution may be modified or redistributed under that license

[vinybk]

Hi @Programer-Ed
Thank you for your contribution, it is highly appreciated.

Unfortunately I've had to shift my focus to handle some personal life stuff. One down-side of having only one active maintainer is that the project freezes when they aren't available.

Thinking about how to solve this long term, I'll be taking a break until September 1st and then launch a maintainer training program. The goal will be to train new maintainers not only for Sovereinia but to open source projects in general. PRs will be reviewed from that date onwards.

I understand it is not ideal to make contributors wait, but it's a though choice I had to make. I hope you understand.

We will create an issue sharing more details when the program launches.