Skip to content

feat(onboarding): add new onboarding flows for Unraid OS #1746

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
elibosley wants to merge 75 commits into
base: main
Choose a base branch
from
Open

feat(onboarding): add new onboarding flows for Unraid OS #1746

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
75 commits
Select commit Hold shift + click to select a range
932d2cf
feat(system-time): add SystemTime type and update resolvers for syste…
elibosley Oct 9, 2025
3a21b62
feat(activation): enhance activation modal with timezone selection an…
elibosley Oct 9, 2025
ed8c5a9
test(activation): update tests for activation modal and steps
elibosley Oct 9, 2025
803824c
feat(activation): add Plugins Step to activation process
elibosley Oct 10, 2025
58f4c17
fix(emcmd): improve error logging for CSRF token retrieval
elibosley Oct 10, 2025
d2ce627
feat(upgrade): implement upgrade onboarding system for Unraid OS
elibosley Oct 10, 2025
c25eca8
feat(activation): enhance ActivationPluginsStep and update tests
elibosley Oct 10, 2025
7834c49
feat(api-config): enhance ApiConfigPersistence with shutdown handling
elibosley Oct 10, 2025
68cd5e4
feat(api-config): integrate OS version tracking with new OsVersionTra…
elibosley Oct 13, 2025
f5564a4
feat(onboarding): implement upgrade step completion tracking
elibosley Oct 13, 2025
b1337fd
refactor(api-schema): reorganize RClone types in generated schema
elibosley Oct 13, 2025
dea4b89
feat(onboarding): update OnboardingTracker to support dynamic OS vers…
elibosley Oct 13, 2025
cb06648
feat: onboarding flows simplified
elibosley Oct 13, 2025
9a06af2
refactor(activation): update activation components for improved local…
elibosley Oct 14, 2025
0b3e78e
test(activation): enhance ActivationCodeModal tests with Vue app inte…
elibosley Oct 14, 2025
99bb59d
fix: pnpm lock
elibosley Oct 14, 2025
e7828c3
refactor(onboarding): remove unnecessary fields from UpgradeStep type
elibosley Oct 14, 2025
ff6c4af
refactor(system-time): integrate ConfigService for state management
elibosley Oct 14, 2025
e0f6ee5
feat(onboarding): add permissions for completing upgrade steps
elibosley Oct 14, 2025
7d95884
test(customization): add test for omitting upgrade metadata with inco…
elibosley Oct 14, 2025
0d9b4c3
refactor(activation): remove unused i18n import from WelcomeModal com…
elibosley Oct 14, 2025
b521514
feat(config): enhance config parsing and state management
elibosley Oct 14, 2025
1abaf2c
feat(onboarding): implement upgrade marker for version tracking
elibosley Oct 15, 2025
cae5111
feat(onboarding): enhance version tracking and upgrade marker handling
elibosley Oct 15, 2025
e0a442a
feat(onboarding): implement first boot completion tracking in Onboard…
elibosley Oct 15, 2025
b2d89b2
fix(log): update time format in logging configuration
elibosley Oct 15, 2025
f612aaa
refactor(activation): clean up ActivationModal component and remove u…
elibosley Oct 15, 2025
3f4ac7a
feat(activation): enhance upgrade step handling in ActivationModal
elibosley Oct 15, 2025
d4e93f1
feat(activation): add titles, descriptions, and icons to upgrade step…
elibosley Oct 15, 2025
da381b5
feat(plugin): implement plugin installation tracking and management
elibosley Oct 15, 2025
2decc23
feat(activation): enhance plugin installation flow and UI feedback
elibosley Oct 15, 2025
3f41cf1
fix(plugins): refine error and success handling during plugin install…
elibosley Oct 16, 2025
b40e733
feat(activation): improve plugin installation status handling and UI …
elibosley Nov 10, 2025
77d001c
fix(imports): standardize import statements and correct module order
elibosley Dec 22, 2025
f959f95
refactor(theme): standardize theme loading method across components
elibosley Dec 22, 2025
0df7926
refactor(theme): update theme store methods in tests to use fetchTheme
elibosley Dec 22, 2025
31c3383
feat(onboarding): implement onboarding reset functionality and new ad…
elibosley Dec 23, 2025
ae8c8a4
feat(onboarding): introduce onboarding state management and enhancements
elibosley Dec 23, 2025
fa2ee15
refactor(onboarding): replace UButton with Button component for consi…
elibosley Dec 25, 2025
3451f52
feat(activation): enhance onboarding step management and feedback
elibosley Dec 25, 2025
581fa96
fix(onboarding): ensure safe handling of activation onboarding state
elibosley Dec 27, 2025
e742aba
feat(tests): enhance ActivationModal and activationCodeData tests wit…
elibosley Dec 27, 2025
8840dac
feat(tests): add tests for fresh install state in activationCodeData
elibosley Dec 27, 2025
91a9946
feat(tests): enhance OnboardingService tests with new mocks and state…
elibosley Dec 27, 2025
fe2888b
refactor(onboarding): update Onboarding page menu and title for clarity
elibosley Dec 27, 2025
16b922c
feat(onboarding): add test harness for onboarding overrides
elibosley Dec 27, 2025
9a89122
feat(activation): update activation hints and improve component cleanup
elibosley Dec 27, 2025
9564532
feat(timezones): add timezone options to system time configuration
elibosley Dec 27, 2025
a963f41
feat(system-time): implement default NTP server configuration
elibosley Dec 29, 2025
92bc432
feat(unraid-plugins): add query for installed Unraid OS plugins and e…
elibosley Dec 30, 2025
fcf3000
refactor(tests): improve test setup for ActivationPluginsStep component
elibosley Dec 30, 2025
93dfbbf
chore(gitignore): add .dev-scripts to gitignore for local dev scripts
Ajit-Mehrotra Dec 9, 2025
ab010f4
enhance: add ssh retry logic and SSH options in deploy script
Ajit-Mehrotra Nov 21, 2025
fd3994a
build(scripts): enhance local docker plugin development workflow
Ajit-Mehrotra Jan 2, 2026
f5b4a7b
chore: update package.json test script
Ajit-Mehrotra Jan 15, 2026
c2b768a
fix(onboarding): move stepper UI to the top and remove unecessary pa…
Ajit-Mehrotra Jan 21, 2026
8013769
feat(onboarding): implement cleaner UI for steppers
Ajit-Mehrotra Jan 22, 2026
b107bc0
feat: redesign summary step
Ajit-Mehrotra Jan 22, 2026
22d2676
feat(onboarding): enhance ActivationPluginsStep UI with decorative ca…
Ajit-Mehrotra Jan 22, 2026
ce0fb15
feat(onboarding): add decorative background to welcome step
Ajit-Mehrotra Jan 22, 2026
328c92e
fixup! feat(onboarding): add decorative background to welcome step
Ajit-Mehrotra Jan 22, 2026
6c51225
fixup! feat(onboarding): add decorative background to welcome step
Ajit-Mehrotra Jan 22, 2026
0057ed6
feat(onboarding): add decorative background to the settings step
Ajit-Mehrotra Jan 23, 2026
f17d2a6
git commit -m "feat(api): add server-name and comment to api"
Ajit-Mehrotra Jan 23, 2026
6c8d463
feat(api): add ability to change languages via the api
Ajit-Mehrotra Jan 23, 2026
b2bf601
fixup! feat(api): add ability to change languages via the api
Ajit-Mehrotra Jan 26, 2026
d41cb06
fix: allow dialog to pass class prop
Ajit-Mehrotra Jan 26, 2026
b8f1518
feat(api): add ssh functionality to the api
Ajit-Mehrotra Jan 26, 2026
37a2187
feat(onboarding): update settings page layout and add theme preview
Ajit-Mehrotra Jan 26, 2026
91f738d
feat(onboarding): add text validation to server description in settin…
Ajit-Mehrotra Jan 27, 2026
b8aeac9
feat(onboarding): refactor execution flow and enhance test harness
Ajit-Mehrotra Jan 28, 2026
9086284
refactor(onboarding): reorganize onboarding files
Ajit-Mehrotra Jan 28, 2026
4be7652
refactor(onboarding): rename onboarding files from "activation" to "o…
Ajit-Mehrotra Jan 28, 2026
b1abbd8
refactor(onboarding): rename scenario to status and simplify API schema
Ajit-Mehrotra Jan 30, 2026
a723607
refactor(onboarding): change data structure for .activationcode file
Ajit-Mehrotra Jan 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -122,7 +122,10 @@ api/dev/Unraid.net/myservers.cfg

# local Mise settings
.mise.toml
mise.toml

# Compiled test pages (generated from Nunjucks templates)
web/public/test-pages/*.html

# local scripts for testing and development
.dev-scripts/
2 changes: 1 addition & 1 deletion @tailwind-shared/css-variables.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@
--ui-text-toned: var(--ui-color-neutral-300);
--ui-text: var(--ui-color-neutral-200);
--ui-text-highlighted: white;
--ui-text-inverted: var(--ui-color-neutral-900);
--ui-text-inverted: var(--ui-color-neutral-300);

Comment on lines 96 to 98
Copy link
Contributor

@coderabbitai coderabbitai bot Oct 13, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Restore contrast for inverted text in dark mode.

Switching --ui-text-inverted to var(--ui-color-neutral-300) makes inverted text nearly indistinguishable on its paired --ui-bg-inverted (still white), breaking readability and failing WCAG contrast. Keep a dark value (e.g., var(--ui-color-neutral-900)) for inverted text.

🤖 Prompt for AI Agents 
In @tailwind-shared/css-variables.css around lines 96 to 98, the variable
--ui-text-inverted was changed to var(--ui-color-neutral-300) which reduces
contrast against the inverted background (still white); revert or set
--ui-text-inverted to a dark neutral (for example var(--ui-color-neutral-900))
so inverted text remains dark and meets WCAG contrast requirements. Ensure the
selected value provides sufficient contrast with --ui-bg-inverted (white) and
update the variable accordingly.

/* Nuxt UI Design Tokens - Background (Dark) */
--ui-bg: var(--ui-color-neutral-900);
Expand Down
39 changes: 29 additions & 10 deletions api/dev/activation/activation_code_12345.activationcode
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,13 +1,32 @@
{
"code": "EXAMPLE_CODE_123",
"partnerName": "MyPartner Inc.",
"partnerUrl": "https://partner.example.com",
"serverName": "MyAwesomeServer",
"sysModel": "CustomBuild v1.0",
"comment": "This is a test activation code for development.",
"header": "#336699",
"headermetacolor": "#FFFFFF",
"background": "#F0F0F0",
"showBannerGradient": "yes",
"theme": "black"
"partner": {
"name": "MyPartner Inc.",
"url": "https://partner.example.com",
"hardwareSpecsUrl": "https://partner.example.com/specs/customBuild-v1",
"manualUrl": "https://partner.example.com/docs/customBuild-manual",
"supportUrl": "https://partner.example.com/support",
"extraLinks": [
{
"title": "Community Forums",
"url": "https://partner.example.com/forums"
},
{
"title": "Video Tutorials",
"url": "https://partner.example.com/tutorials"
}
]
},
"branding": {
"theme": "black",
"header": "#336699",
"headermetacolor": "#FFFFFF",
"background": "#F0F0F0",
"showBannerGradient": true
},
"system": {
"serverName": "MyAwesomeServer",
"model": "CustomBuild v1.0",
"comment": "This is a test activation code for development."
}
}
Loading
Loading