test: remove obsolete advanced interactions e2e

This reverts commit a1d80515b0e00240bb662180626a44bfb205656e.

.agents/skills/homarr-custom-widget/SKILL.md

@@ -7,15 +7,11 @@ description: Author safe Homarr Custom JSX v2 widgets from API documentation.
 
 Author one widget at a time. When connected to Homarr, retrieve `homarr://custom-widgets/schema` and only the component resources needed for the design. The live resources are authoritative for the installed release.
 
-Keep documentation retrieval targeted: fetch at most eight named component documents before the first validation, or at most four after loading a complete example. Fetch another component only when a validation issue or a concrete missing interaction requires it; never load the catalog component-by-component.
-
 1. Read the API documentation.
 2. Create one credential-free widget with keyed `sources`, keyed `requests`, optional keyed `options`, and safe JSX `template`.
 3. Validate, preview, test queries and simulated actions, visually inspect, and iterate.
 4. Configure deployment-specific source URLs and request credentials through Homarr; never repeat plaintext.
-5. Save only after narrow/wide, light/dark, loading, empty, error, and success states work. When connected through MCP, persist the exact final tested preview with `customWidget_createFromPreview`; do not resend a large template through `customWidget_create` unless no preview session is available.
-
-Treat a supplied sample or successful preview response as the binding contract. Render every core requested field, guard optional arrays and nested values before indexing, and do not silently drop returned items. Show concise freshness context when the API supplies a timestamp. Give recoverable load errors and empty states a clear refresh or retry path.
+5. Save only after narrow/wide, light/dark, loading, empty, error, and success states work.
 
 Use `{option:name}` or `$option` for saved options. Use `{param:name}` or `$param` for values supplied by `SubFetch`, `ActionButton`, or `ToggleSwitch`. Load queries cannot use invocation parameters. Templates read `data`, `status`, `options`, and temporary `inputs`.
 
@@ -23,10 +19,6 @@ Use `{option:name}` or `$option` for saved options. Use `{param:name}` or `$para
 
 Use standard Mantine compound names and deliberate visual hierarchy, spacing, restrained semantic color, and responsive layouts. Avoid excessive nested cards.
 
-Aim for distinctive polish without decorative gradients or fragile custom styling: use one semantic accent, clear surface contrast, purposeful typography, and compact rows that remain scannable in narrow tiles. Give standalone icons an accessible label or pair them with visible text.
-
-Make initial states actionable with an example, useful hint, or clear next step. Use wrapping groups for variable-length labels and values on narrow tiles. Do not use an unlabeled decorative icon as an empty state.
-
 Do not use imports, hooks, refs, raw HTML, raw event callbacks, browser requests, arbitrary functions, eval, bigint, npm packages, authored statement blocks, IIFEs, or recursion. Do not pretend MCP tools exist in an offline chat session.
 
 To install an existing widget, use `customWidget_workshopSearch`, inspect it with `customWidget_workshopGet`, then use `customWidget_workshopInstall`. Configure each self-hosted source afterward with `customWidget_sourceConfigure`, or call `customWidget_configurationRequestUser` so the user can enter the server URL and credentials directly in Homarr.

.cursor/rules/codebase-context.mdc

@@ -66,6 +66,8 @@ homarr/
 │   ├── analytics/       # Server-side analytics (Umami)
 │   ├── server-settings/ # Server setting keys/types
 │   ├── settings/        # User-facing settings UI context
+│   ├── old-import/      # Legacy Homarr import
+│   ├── old-schema/      # Legacy Homarr zod schemas
 │   └── cli/             # Node CLI for ops (brocli)
 ├── tooling/
 │   ├── typescript/      # Base tsconfig

.cursor/rules/mantine-datatable-migration.mdc

@@ -263,6 +263,15 @@ Even hidden options need translation keys or the translation test fails:
 "widget.mywidget.option.columnWidths.label": "Column widths"
 ```
 
+### Old-import mappings
+
+Add to `packages/old-import/src/widgets/options.ts`:
+
+```typescript
+columnOrder: () => undefined,
+columnWidths: () => undefined,
+```
+
 ### Dynamic storeKey
 
 Use a key that includes `itemId` and sorted column names. This prevents cross-widget localStorage bleeding:
@@ -601,12 +610,13 @@ if (isEditMode) rowContextMenuHandler = undefined;
 4. Add CSS file for transparent backgrounds (if widget context)
 5. Add responsive column visibility (if widget context)
 6. Add hidden options + hydration logic (if column persistence needed)
-7. Add translation keys (including hidden option labels)
-8. Add context menu if row actions exist
-9. Add row expansion if detail view exists
-10. Add error handling on all mutations
-11. Add accessibility attributes
-12. Test at multiple widget widths
-13. Update docs in `apps/docs/docs/widgets/` if applicable
-14. Run `pnpm turbo typecheck`
-15. Run translation spec — catches missing keys
+7. Add old-import mappings for new options
+8. Add translation keys (including hidden option labels)
+9. Add context menu if row actions exist
+10. Add row expansion if detail view exists
+11. Add error handling on all mutations
+12. Add accessibility attributes
+13. Test at multiple widget widths
+14. Update docs in `apps/docs/docs/widgets/` if applicable
+15. Run `pnpm turbo typecheck` — catches old-import mismatches
+16. Run translation spec — catches missing keys

.github/workflows/ci.yml

@@ -95,12 +95,6 @@ jobs:
       - name: Validate checked-in OpenAPI schema
         run: pnpm check:openapi
 
-      - name: Validate feature contracts
-        run: pnpm check:feature-contracts
-
-      - name: Test feature platform
-        run: pnpm test:feature-platform
-
       - name: Validate Custom Widget bundle budget
         run: |
           pnpm --filter nextjs build

.gitignore

@@ -84,11 +84,3 @@ apps/docs/.docusaurus
 apps/docs/build
 .pnpm-store
 benchmark-results
-
-# local performance investigation (never ship benchmark data or restored backups)
-.widget-performance/
-.bench/
-homarr-backup*.zip
-*.sqlite-wal
-*.sqlite-shm
-/scripts/benchmarks/

AGENTS.md

@@ -40,6 +40,8 @@ homarr/
 │   ├── analytics/       # Server-side analytics (Umami)
 │   ├── server-settings/ # Server setting keys/types
 │   ├── settings/        # User-facing settings UI context
+│   ├── old-import/      # Legacy Homarr import
+│   ├── old-schema/      # Legacy Homarr zod schemas
 │   └── cli/             # Node CLI for ops (brocli)
 ├── tooling/
 │   ├── typescript/      # Base tsconfig

MANTINE.md

@@ -54,7 +54,7 @@ For a single consolidated file with all content, use:
 - [How to integrate custom input with use-form hook?](https://mantine.dev/llms/q-custom-input-use-form.md): Learn how to add use-form support for custom inputs
 - [How to prevent Modal from closing?](https://mantine.dev/llms/q-how-to-prevent-modal-from-closing.md): Learn how to prevent Modal from closing when the user clicks outside of it or presses the Escape key
 - [How to scroll to the top of the form if the form is submitted with errors?](https://mantine.dev/llms/q-scroll-to-the-top-of-the-form.md): Learn how to call a function when the form is submitted with errors
-- [How to update Mantine dependencies?](https://mantine.dev/llms/q-how-to-update-dependencies.md): Learn how to update `@mantine/*`, `@mantinex/*` and `postcss-preset-mantine` dependencies manually or with ncu script
+- [How to update Mantine dependencies?](https://mantine.dev/llms/q-how-to-update-dependencies.md): Learn how to update @mantine/_, @mantinex/_ and postcss-preset-mantine dependencies manually or with ncu script
 - [How to use Dropzone with @mantine/form?](https://mantine.dev/llms/q-how-to-use-dropzone-with-form.md): Learn how to use Dropzone with @mantine/form to handle file selection state
 - [How to use Mantine template on GitHub?](https://mantine.dev/llms/q-templates-usage.md): Learn how to create a new repository based on Mantine template
 - [I get hydration warning about data-mantine-color-scheme attribute, what does it mean?](https://mantine.dev/llms/q-color-scheme-hydration-warning.md): Learn how hydration works and how to fix warnings

apps/docs/blog/2024/09-23-version-1.0/index.mdx

@@ -13,6 +13,8 @@ This will be a one time occurrence and version > ``1.0`` will have less breaking
 This time more important than every; **read the breaking changes** list and **create a backup** before updating.
 Some third party installation methods may take multiple days or weeks to update to the new version.
 
+See [this guide on how to import your previous Homarr dashboard](/docs/getting-started/after-the-installation#importing-a-zip-from-version-before-100)
+
 ## Changes at a glance
 - **Asynchronous integrations system**: In versions prior to ``1.0``, we fetched data upon each request synchronously.
 This means that the user had to wait for the requests to finish so any data would appear.

apps/docs/blog/2025/01-19-migration-guide-1.0/index.mdx

@@ -10,11 +10,12 @@ If you are still on a version before 0.15.10, please update to 0.15.10 where we
 
 <!-- truncate -->
 
-## Preserve your old installation
+## Export your data
 
-Homarr 1.0 is a complete rewrite and cannot reuse the old Docker mounts. Keep the 0.15 installation and its data intact while you build the replacement. The historical `Management` > `Tools` > `Migrate to 1.0` export can still be kept as a record, but current Homarr releases cannot import that ZIP or its secret key.
-
-Plan to recreate your apps, integrations, and boards manually in the new installation. A SQLite database backup can be restored from the onboarding welcome screen only when it was created by a compatible current Homarr release; it is not a conversion path for a 0.15 database.
+As 1.0 is a complete rewrite of Homarr and therefor not compatible with the old docker mounts, we need to export your data first.
+For this you can navigate to the `Migrate to 1.0` page which you can find under `Management` > `Tools` > `Migrate to 1.0`.
+Here you can select which things you want to export and download the zip file.
+It will also show you a secret key which you will need to import the secret data like user password hashes, salts and integration secrets.
 
 ![Export page](./img/old-homarr-export-data.png)
 
@@ -27,15 +28,28 @@ Please note that if you are using docker you need to specify a diffrent external
 So in your compose file the ports would be `7576:7575` instead of `7575:7575`.
 
 ## Import your data
+Once the installation is completed you can access the new installation. During the onboarding you'll need to select `Import from Homarr before 1.0`.
 
-:::warning Legacy guide
+![Onboarding initial step](./img/onboarding-step-1.png)
 
-The pre-1.0 ZIP importer is no longer included in current Homarr releases. Keep the old installation available until you have manually verified the replacement. Compatible SQLite backups from current releases can still be restored from the onboarding welcome screen.
+After that you can upload the zip file you downloaded in the first step.
 
-:::
+![Onboarding import dropzone](./img/old-homarr-import-dropzone.png)
+
+After that you'll get a list with all your boards that can be imported. You can configure how it should be imported and can select which screensizes it should import.
+
+![Onboarding import list](./img/old-homarr-import-choose-imported-data.png)
+
+Once you have selected everything you can click on `Confirm import and continue` which will open the encryption key input dialog where you can input the secret key you got during the export.
+
+![Onboarding import key input](./img/old-homarr-import-decryption-token.png)
+
+After that you can continue the onboarding and you should see all your boards and data in the new installation.
+
+See [After the installation](https://homarr.dev/docs/getting-started/after-the-installation) for more information.
 
 ## Remove the old installation
 
 After you are happy with the new installation and everything is working as expected you can remove the old installation.
 Please make sure to backup the data before you remove the old installation.
-Also once the port 7575 is free again you can change the port mapping of the new installation to `7575:7575` if you want to.
+Also once the port 7575 is free again you can change the port mapping of the new installation to `7575:7575` if you want to.

apps/docs/docs/advanced/_category_.json

@@ -1,7 +1,7 @@
 {
   "label": "Advanced",
   "collapsed": true,
-  "position": 5,
+  "position": 4,
   "link": {
     "type": "generated-index",
     "title": "Advanced Concepts or features"

apps/docs/docs/advanced/development/getting-started.mdx

@@ -57,73 +57,51 @@ Homarr becomes the instance administrator.
 Use `pnpm docker:dev:up` instead when you only need Redis in the background. Running the migration also seeds the
 default data; use `pnpm db:seed` to seed it explicitly later.
 
-Workshop contributors can set up PocketBase and Docusaurus with the dedicated
-[Workshop development guide](../../workshop/development).
+### Run PocketBase and documentation
 
-### Scaffold a native feature
-
-Run `pnpm generate:feature` and choose `native-integration`, `widget`, or `integration-widget`. The generator creates
-implementation, focused test, documentation, and English translation skeletons and updates the current explicit
-registries. It stops before writing if a target exists, a registry anchor is ambiguous, or a supported integration is
-unknown.
-
-The generated code is a starting contract, not a finished feature. Replace the placeholder request, UI, tests, secrets,
-categories, configuration, error states, and documentation with behavior specific to the service. Then run:
+Start PocketBase in another terminal:
 
 ```sh
-pnpm check:feature-contracts
-pnpm test:feature-platform
+cp apps/workshop/.env.example apps/workshop/.env
+docker compose --env-file apps/workshop/.env -f apps/workshop/docker-compose.yml up --build workshop
 ```
 
-The contract check reports the exact registry, docs path, translation, support mapping, or package export that needs
-repair. It intentionally follows today's explicit registries; a future canonical feature descriptor can replace those
-patches without changing the contributor-facing generator names.
-
-Integration-capable widgets declare their server-safe relationship in `nativeFeatureCapabilities`. Homarr derives the
-widget-to-integration map, reverse integration-to-widget map, optional-connection set, and server selection limits from
-that descriptor. Widget definitions still mirror the supported list for client-side type inference; the focused widget
-manifest test and `check:feature-contracts` prevent drift until those definition types can consume the descriptor
-directly.
-
-New integration skeletons also include response fixtures using `simulateResponseContractAsync`. Replace the generated
-minimal schema and fixtures with representative upstream payloads: at least one successful response, important optional
-or version-specific shapes, and a malformed response that must be rejected. The simulator uses the real parser without
-network access and reports every fixture mismatch, so parser contracts can be reviewed before credentials are available.
-
-### Review native feature states
-
-In a development server, administrators can open `/manage/tools/feature-workbench` to inspect the shared `CatalogItem`
-and integration response-contract fixtures. The workbench uses the application Mantine theme and the same segmented
-fixture controls as the custom-widget preview. It covers ready, setup-required, standalone, connection-error, selected,
-loading, disabled, parser-success, and parser-failure states without requiring a live service.
-
-Use the workbench after changing shared catalog presentation or generated parser contracts, then run the focused test:
+Then start Docusaurus in a third terminal:
 
 ```sh
-pnpm exec vitest run "apps/nextjs/src/app/[locale]/manage/tools/feature-workbench/_feature-state-workbench.spec.tsx"
+WORKSHOP_API_URL=http://127.0.0.1:8090 pnpm dev:docs
 ```
 
-The workbench is deliberately development-only and is not linked from management navigation. It does not yet exercise
-real integration branding, long translated labels, right-to-left text, high-contrast screenshots, touch interaction,
-small viewport clipping, live network latency, retry transitions, or service-specific response schemas. Those remain
-manual review items until screenshot and browser-automation coverage is added.
+PocketBase runs on port 8090 and Docusaurus on port 3003. Stopping the services preserves the PocketBase volume.
 
-### Check one native feature
+Open `http://127.0.0.1:8090/_/` and create the first PocketBase superuser. The Workshop UI is available at
+`http://127.0.0.1:3003/workshop`.
 
-Run `pnpm check:feature <kind>` before submitting an integration or widget change. The command resolves the kind through
-`integrationDefs`, `widgetKinds`, the widget manifest, creator registry, documentation slug maps, and capability
-descriptor. When an integration and widget share a kind, such as `wud`, both sides are checked together.
+Point Homarr at the local services with:
+
+```dotenv
+HOMARR_WEBSITE_URL=http://127.0.0.1:3003
+WORKSHOP_API_URL=http://127.0.0.1:8090
+WORKSHOP_WEB_URL=http://127.0.0.1:3003/workshop
+```
+
+Restart `pnpm dev` after changing `.env`. GitHub OAuth is optional locally. See
+[`apps/workshop/README.md`](https://github.com/homarr-labs/homarr/blob/HEAD/apps/workshop/README.md) for OAuth,
+Workshop moderator promotion, logs, tests, backup, restore, stopping, and intentional volume reset.
+
+### URL testing
+
+Docusaurus reads `HOMARR_WEBSITE_URL` and `WORKSHOP_API_URL` when it starts or builds. Homarr also reads
+`WORKSHOP_WEB_URL` when its server starts, so these values do not rely on `NEXT_PUBLIC_*` build variables. Test a
+separate API origin before release:
 
 ```sh
-pnpm check:feature wud --plan
-pnpm check:feature wud
+HOMARR_WEBSITE_URL=http://127.0.0.1:3003 \
+WORKSHOP_API_URL=http://127.0.0.1:8090 \
+WORKSHOP_WEB_URL=http://127.0.0.1:3003/workshop \
+pnpm dev:docs
 ```
 
-`--plan` (or `--dry-run`) prints the deterministic affected files and commands without executing them. The normal mode
-runs feature contracts, nearby fixture and unit tests, affected package typechecks, and lint and formatting for only the
-resolved files. Unknown kinds fail before any command runs. Live-service, container, and visual checks are printed as
-optional and are never executed implicitly because they may require credentials, images, or a running development app.
-
 ### Useful commands
 
 - `pnpm dev` — Next.js on port 3000.
@@ -134,17 +112,17 @@ optional and are never executed implicitly because they may require credentials,
 - `pnpm dev:cli -- rebuild <name>` — rebuild an image from its recorded checkout or pull request.
 - `pnpm dev:cli:install` — optionally install the developer CLI as a `homarr` binary.
 - `pnpm dev:docs` — Docusaurus only on port 3003.
+- `pnpm docker:workshop` — local PocketBase through Docker Compose.
 - `pnpm docker:dev:up` — Redis development service in the background.
 - `pnpm cli` — Homarr operations CLI.
 - `pnpm db:migration:sqlite:run` — create or update a SQLite database.
 - `pnpm db:seed` — seed the default database data explicitly.
 - `pnpm db:studio` — inspect the database.
 - `pnpm format` / `pnpm format:fix` — check or apply oxfmt.
-- `pnpm generate:feature` — scaffold a native integration, widget, or paired feature.
-- `pnpm check:feature-contracts` — validate native feature registries, docs, translations, support maps, and exports.
 - `pnpm lint` / `pnpm lint:fix` — check or apply oxlint.
 - `pnpm typecheck` — typecheck all workspaces.
 - `pnpm test` — unit and contract suites.
+- `pnpm test:workshop` — disposable Workshop integration suite.
 - `pnpm build` — production monorepo build.
 - `docker build -t homarr .` — build a production Docker image.
 - `docker run -p 7575:7575 -e SECRET_ENCRYPTION_KEY='your_64_character_hex_string' homarr:<name>` — run it.

apps/docs/docs/advanced/environment-variables/index.mdx

@@ -37,9 +37,6 @@ Using the `PUID` and `PGID` will require you to set the correct permissions on t
 | `WORKSHOP_API_URL`       | PocketBase API used by Homarr and standalone documentation.                                                                                                                                                                            | HTTP(S) URL                         | `HOMARR_WEBSITE_URL`          |
 | `WORKSHOP_WEB_URL`       | Public Workshop page opened from Homarr.                                                                                                                                                                                               | HTTP(S) URL                         | `HOMARR_WEBSITE_URL/workshop` |
 
-Workshop service operators can find its server-only configuration in the
-[Workshop operator guide](../../workshop/operator#environment-variables).
-
 ## Authentication
 
 See [Single Sign-On](/docs/advanced/single-sign-on) for more informations.
@@ -58,12 +55,11 @@ A random secret can be generated by using the following command: `openssl rand -
 
 ## Docker
 
-| Environment Variable  | Description                                                                                                                                                                                               | Possible values                                         | Default |
-| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------- |
-| `DOCKER_ENDPOINTS`    | JSON array of named, capability-scoped Docker or Podman endpoints. Supports socket, explicitly insecure TCP, and TLS transports. See the [Docker and Podman integration guide](/docs/integrations/docker) | A JSON array of endpoint descriptors                    | -       |
-| `DOCKER_HOSTNAMES`    | Legacy comma-separated list of plaintext TCP hostnames. Ignored when `DOCKER_ENDPOINTS` is set                                                                                                            | For example `localhost,docker.example.com`              | -       |
-| `DOCKER_PORTS`        | Legacy comma-separated list of plaintext TCP ports. Ignored when `DOCKER_ENDPOINTS` is set                                                                                                                | For example `2375,2376`                                 | -       |
-| `DOCKER_SOCKET_PATHS` | Legacy comma-separated list of mounted Docker-compatible socket paths. Ignored when `DOCKER_ENDPOINTS` is set                                                                                             | For example `/var/run/docker.sock,/var/run/podman.sock` | -       |
+| Environment Variable  | Description                                                                                                                              | Possible values                                         | Default |
+| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------- |
+| `DOCKER_HOSTNAMES`    | Comma-separated list of hostnames to connect to                                                                                          | For example `localhost,docker.example.com`              | -       |
+| `DOCKER_PORTS`        | Comma-separated list of ports to connect to                                                                                              | For example `2375,2376`                                 | -       |
+| `DOCKER_SOCKET_PATHS` | Comma-separated list of mounted Docker-compatible socket paths. See the [Docker and Podman integration guide](/docs/integrations/docker) | For example `/var/run/docker.sock,/var/run/podman.sock` | -       |
 
 ## Database
 
@@ -113,9 +109,12 @@ External redis is currently not supported with Proxmox Community Scripts
 The advanced deployments environment variables should only be used if you know what you are doing.
 :::
 
-| Environment Variable     | Description                                         |
-| ------------------------ | --------------------------------------------------- |
-| `DB_MIGRATIONS_DISABLED` | Disable db migrations. For example for helm charts. |
+| Environment Variable     | Description                                                                                                                                                                                                       |
+| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `DB_MIGRATIONS_DISABLED` | Disable db migrations. For example for helm charts.                                                                                                                                                               |
+| `WORKSHOP_PUBLIC_ORIGIN` | Origin used in PocketBase-generated links and email. It must be set explicitly in production and must match the externally reachable Workshop origin.                                                             |
+| `PB_ALLOWED_ORIGINS`     | Browser origins accepted by PocketBase. Use `*` for the central public community so arbitrary self-hosted Homarr instances can use the API and OAuth; private staging may use a comma-separated origin allowlist. |
 
 All public URL variables reject non-HTTP protocols, embedded credentials, query strings, and fragments, and normalize
-trailing slashes when Homarr or Docusaurus starts.
+trailing slashes when Homarr or Docusaurus starts. The Docusaurus-only `WORKSHOP_URL` name is accepted as a deprecated alias for
+`WORKSHOP_API_URL` for one release. `WORKSHOP_API_URL` takes precedence.

apps/docs/docs/advanced/keyboard-shortcuts/index.mdx

@@ -15,6 +15,20 @@ Homarr has the following keyboard shortcuts:
 | `Shift` + `Enter` on a supported widget         | Opens its advanced view until it is closed |
 | `Esc`                                           | Closes an open advanced view or board menu |
 
+## Board editing
+
+When a tile is focused in edit mode:
+
+| Shortcut             | Description                                                                 |
+| -------------------- | --------------------------------------------------------------------------- |
+| `Enter` or `Space`   | Starts or stops keyboard editing                                            |
+| Arrow keys           | Moves the focused tile within its current canvas, rail, or Container        |
+| `Shift` + Arrow keys | Resizes from the tile's lower-right corner: Left/Up shrink; Right/Down grow |
+| `Esc`                | Stops keyboard editing without undoing its changes                          |
+
+Keyboard moves and resizes apply immediately. To move an item between a canvas, rail, or Container, drag it there or use **Move / resize item** for precise numeric placement.
+Commands at a grid boundary or at the tile's minimum size are ignored and announced instead of moving or shrinking the tile.
+
 :::tip
 
 Here `MOD` refers to the modifier key, which is `Ctrl` on Windows and `Cmd` on macOS.

apps/docs/docs/community/_category_.json

@@ -1,6 +1,6 @@
 {
   "label": "Community",
-  "position": 6,
+  "position": 5,
   "collapsed": true,
   "link": {
     "type": "generated-index"

apps/docs/docs/getting-started/after-the-installation.mdx

@@ -6,10 +6,18 @@ tags:
   - Configuration
 ---
 
+import imageStartFromScratchStepServerSettings from "./img/onboarding-from-scratch-step-server-settings.png";
+import imageStartFromScratchStepAdminUser from "./img/onboarding-from-scratch-step-admin-user.png";
+import imageStartFromScratchStepExternalAdminGroup from "./img/onboarding-from-scratch-step-external-admin-group.png";
+import imageStartFromScratchStepFinish from "./img/onboarding-from-scratch-step-finish.png";
 import manageBoardHeaderEditMode from "./img/manage-board-header-edit-mode.png";
 import manageBoardHeaderAddItem from "./img/manage-board-header-add-item-menu.png";
 import manageBoardHeaderChooseItem from "./img/manage-board-header-choose-item.png";
 import manageBoardNoApp from "./img/manage-board-no-app.png";
+import manageExportOldHomarr from "./img/old-homarr-export-data.png";
+import manageImportOldHomarrDropzone from "./img/old-homarr-import-dropzone.png";
+import manageImportOldHomarrChooseData from "./img/old-homarr-import-choose-imported-data.png";
+import manageImportDecryptionToken from "./img/old-homarr-import-decryption-token.png";
 
 :::tip
 
@@ -21,50 +29,117 @@ Congratulations on installing Homarr. Now it's time to get yourself familiar wit
 
 ## Onboarding
 
-Onboarding appears the first time Homarr starts. Its goal is to create a useful responsive board, not merely an
-administrator account. The setup uses one guided studio, so you can keep the safe defaults and finish quickly or review
-every detected service before anything is added to the board.
+The onboard will show the first time you start Homarr.
+This process will help you with your first steps and adding some initial data, such as the administrator account.
 
 :::note
 
-If you see this screen repeatedly after restarting the Homarr container, your Docker mounting paths may be missing,
+If you see this screen repeatitly after you restarted the Homarr container, your Docker mounting paths may be missing,
 incorrect or read-only. Read [our installation instructions](/docs/getting-started/installation/docker) again to fix this issue.
 
 :::
 
-### Restore or start fresh
+You can either import a previous dashboard using the ZIP archive or start from scratch:
 
-SQLite installations can restore a complete Homarr database backup from the welcome screen. This restores current
-boards, people, apps, integrations, and settings. The pre-1.0 ZIP importer is no longer included.
+![Screenshot of Step 1 onboarding](./img/onboarding-step-1.png)
 
-For a new installation, Homarr first creates either a credentials administrator or an administrator group matching your
-LDAP/OIDC provider. The browser that starts setup claims the first-run session; refreshes are safe, while another browser
-cannot change credentials or integrations during that setup.
+You may refresh anytime and continue from a different device - the onboarding is saved immediately on the server for your convenience.
 
-### Setup studio
+### Starting from scratch
 
-The studio keeps related choices together:
+Depending on your auth provider configuration you will either first see the admin user creation form or the external group creation form.
+If the credentials provider was selected, you'll be prompted to create an admin user for Homarr.
+This user cannot be deleted and has full control over Homarr and all of its boards.
+You must choose a username and password (both can later be changed).
+We enforce strict password requirements when you enter your password to protect your instance if you accidentally
+expose it to the internet.
 
-1. **Essentials** sets the default language, color scheme, analytics preference, and the usual host, IP address, domain, or reverse-proxy path used by your services. URL suggestions can use separate ports, subdomains, or one path per service.
-2. **Discover** checks the actual database, Docker-compatible sockets, Kubernetes configuration, Workshop, and Assistant capabilities. Unavailable sources never block manual setup.
-3. **Connect** shows detected integrations and apps first, identifying whether each app came from an explicit [`homarr.*` or Homepage Docker label](/docs/integrations/docker-labels) or image matching. Select several integrations and apps at once, review every URL, and use the service-specific link to open its API-key settings when one is available. If a container has no published port or URL label, add its HTTP or HTTPS address before importing it.
-4. **Board** previews the Base layout, colors, widget radius, sidebars, selected apps, and widgets inferred from integrations or Docker labels. Choose 8 columns for a focused board, 10 for a balanced board, 12 for a wide board, or use the slider for a custom width up to 24 columns. Homarr still creates and reflows the protected Mobile layout automatically. A fast setup adds the integration-free Clock, Weather, and Bookmarks starter widgets.
-5. **Extend** explains and optionally configures Homarr Assistant, the community Workshop, and the separate Homarr MCP endpoint.
-6. **Review** tests the selected connections, then saves integrations, apps, widgets, settings, and the exact first board together. If any part fails, the database changes are rolled back and your form stays available to correct.
+<img src={imageStartFromScratchStepAdminUser} alt={"Screenshot form to create admin user"} width={300} />
 
-Docker discovery reports each configured host separately. Results from reachable hosts remain selectable if another socket
-is unavailable, which is useful for remote Docker, rootless Docker, Synology, and mixed deployments. On Kubernetes or
-bare-metal installations without a Docker socket, enter services manually and use the same integration catalog.
+If you selected external providers (such as LDAP or OIDC), you'll be prompted to create an admin group.
+This group will be used to synchronize users from your provider to Homarr.
+When a user logs in through the provider, any of their groups that match groups in Homarr will be assigned to the user.
+The name of the group must match exactly the name of the group in the provider.
 
-After setup, **Open my board** takes you directly to the configured board. The in-product tour then introduces edit mode,
-responsive layouts, widgets, and search without delaying completion.
+<img
+  src={imageStartFromScratchStepExternalAdminGroup}
+  alt={"Screenshot form to create external admin group"}
+  width={300}
+/>
 
-## Creating another board
+Next, you can configure some basic settings for Homarr. We recommend to leave all settings at default for most users.
+Here you can also disable analytics. Please note that our analytics are completly anonymous and is fully compliant with GDPR and PECR.
+
+<img
+  src={imageStartFromScratchStepServerSettings}
+  alt={"Screenshot of analytics and indexing settings in the onboarding"}
+  width={300}
+/>
+
+### Setting up integrations
+
+After configuring server settings, the onboarding guides you through setting up your integrations.
+
+#### Docker service discovery
+
+If Docker is available (socket mounted), Homarr automatically detects running containers and matches them to known integration types.
+Matching integrations are pre-selected in the integration list, saving you from manually picking each one.
+
+#### URL templating
+
+You can define a base URL template to auto-fill integration URLs in bulk.
+Two modes are supported:
+
+- **Subdomain mode** - e.g. `{app}.example.com` where `{app}` is replaced with the integration name
+- **Port mode** - e.g. `192.168.1.1:{port}` where `{port}` is replaced with the integration's default port
+
+#### API key helper links
+
+For integrations that require API keys (such as Sonarr, Radarr, SABnzbd, or Seerr), a helper link opens the relevant settings page in the target application so you can quickly copy your key.
+
+#### Creating apps from Docker containers
+
+You can optionally auto-create bookmark apps for all discovered Docker containers, making them immediately available on your board.
+
+:::note
+
+Release providers and Search.ch are configured directly in their widgets instead of the integrations page.
+
+:::
+
+After this step, you finished the onboarding.
+The onboarding can no longer be started again.
+From here you can click on one of the provided links to continue your journey.
+We recommend you to continue with the section [creating your first board on this page](#creating-your-first-board).
+
+<img src={imageStartFromScratchStepFinish} alt={"Screenshot of the finish onboarding process with links"} width={300} />
+
+### Importing a ZIP from version before 1.0.0
+
+This is recommended when you used Homarr before and want to re-import your data.
+It is important that you first migrate correctly using [the list of breaking changes for 1.0](/blog/2024/09/23/version-1.0).
+
+<img src={manageExportOldHomarr} alt="Export from old Homarr" style={{ maxWidth: 500 }} />
+
+**How to export and import data**
+
+1. Navigate to your old Homarr, open your management pages, open the tools submenu and open `Migrate to 1.0`.
+2. Check the contents that you want to export. We recommend you to export all data.
+3. Click on the export data button
+4. Save the ZIP file, that is being downloaded, on your device. If you selected "integrations" or "users", you also get an encryption / decryption key.
+   Copy it and do not loose it!
+5. Go to your new >1.0.0 Homarr instance and start the onboarding. Choose `Import from Homarr before 1.0`
+6. Drag and drop your previously downloaded ZIP archive into the file upload: <br/><img src={manageImportOldHomarrDropzone} style={{ maxWidth: 500 }} />
+7. Next, choose the data that you want to import and how to import it. Since screen sizes were removed in 1.0, we create a new board for every screen size by default. We recommend you to only keep the best layout and adjust it later in 1.0.0 - but you can also import all of them and pick later.<br/><img src={manageImportOldHomarrChooseData} style={{ maxWidth: 500 }} />
+8. If you previously exported integrations or users, you will be asked to decrypt the data safely using your obtained encryption token. Paste into the modal and confirm your action.<br/><img src={manageImportDecryptionToken} style={{ maxWidth: 500 }} />
+9. Next, you can [follow the same setup as when starting from scratch](#starting-from-scratch). After you completed the onboarding, all of your data will be migrated and available.
+
+## Creating your first board
 
 In Homarr, you organize your apps and widgets on boards.
 Boards use fixed-size tiles so the same widget keeps the same proportions on every screen.
 Drag, resize, and section controls are available in edit mode.
-Onboarding already created the first board. To create another one, navigate to `Manage` > `Boards` > `New board`:
+Let's create your first board by navigating here: `Manage` > `Boards` > `New board`:
 ![](./img/manage-create-board-button.png)
 
 A board must always have a name and can either be public or private.
@@ -158,7 +233,8 @@ The tile snaps to the grid. Equally-sized tiles swap when one is dropped into th
 Every `1 × 1` tile has a logical content size of `200 × 200` pixels.
 Larger tiles use multiples of that fixed unit, with a consistent gap between cells.
 Homarr scales the complete board uniformly, like zooming a page.
-It stops shrinking at 75% and lets you scroll horizontally instead of making text and controls too small.
+The complete canvas always fits the available width without horizontal board scrolling.
+Below 100%, Homarr preserves the widget's readable typography and control density instead of shrinking each widget independently.
 It does not squeeze or reflow the content of individual widgets, so a widget keeps the same design and proportions across screen sizes.
 
 :::note

apps/docs/docs/integrations/docker-labels/index.mdx

@@ -1,95 +0,0 @@
----
-title: "Docker labels"
-description: "Discover apps, integrations, and widgets from container labels during Homarr onboarding."
----
-
-# Docker label discovery
-
-During onboarding, Homarr scans running containers on every reachable
-[Docker-compatible host](/docs/integrations/docker). Labels let you provide exact app metadata instead of relying on
-image-name matching. You can review and deselect every result before Homarr creates anything.
-
-A container with valid Homarr labels takes priority over image-based discovery. Containers without valid labels can
-still be suggested from their image and published ports.
-
-## Homarr labels
-
-`homarr.name` and `homarr.href` are required for label discovery. All other labels are optional.
-
-| Label                | Purpose                                                                    |
-| -------------------- | -------------------------------------------------------------------------- |
-| `homarr.name`        | App or integration display name                                            |
-| `homarr.href`        | Address opened by the app and used as the suggested integration address    |
-| `homarr.group`       | Container section that receives the selected app and compatible widget     |
-| `homarr.icon`        | App icon URL                                                               |
-| `homarr.description` | App description                                                            |
-| `homarr.ping`        | Address used for app status checks                                         |
-| `homarr.id`          | Stable source identifier; defaults to the Docker container ID              |
-| `homarr.board`       | Intended board name; see [Board targeting](#board-targeting)               |
-| `homarr.integration` | Homarr integration kind, for example `sonarr`                              |
-| `homarr.widget`      | Homarr widget kind to add when it supports the selected integration        |
-| `homarr.hide`        | Excludes the container when this label is present, regardless of its value |
-
-Unknown integration and widget kinds are ignored. Do not put API keys, passwords, or other secrets in labels. Enter
-credentials in onboarding, where Homarr stores them using its normal encrypted integration-secret flow.
-
-## Compose example
-
-```yaml
-services:
-  sonarr:
-    image: lscr.io/linuxserver/sonarr:latest
-    labels:
-      homarr.name: "Sonarr"
-      homarr.href: "http://server.local:8989"
-      homarr.group: "Media"
-      homarr.icon: "https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/sonarr.svg"
-      homarr.description: "TV library"
-      homarr.ping: "http://server.local:8989"
-      homarr.integration: "sonarr"
-      homarr.widget: "calendar"
-```
-
-Use an address that is reachable where it is needed. A Docker service name can work for server-side integration
-requests, while an app link opened in a browser usually needs a LAN hostname, IP address, or reverse-proxy address.
-Onboarding accepts these self-hosted address formats directly and only requires the field to be non-empty.
-
-## Homepage label fallback
-
-When `homarr.name` is absent, onboarding also understands these Homepage labels:
-
-- `homepage.name`
-- `homepage.href`
-- `homepage.group`
-- `homepage.icon`
-- `homepage.description`
-
-`homepage.name` and `homepage.href` are required for the fallback. Homarr does not combine partial Homarr metadata with
-Homepage metadata: once `homarr.name` is present, use `homarr.*` labels for the remaining fields too.
-
-## What onboarding creates
-
-In **Connect**, label-discovered apps and integrations appear before image-based suggestions. You can import multiple
-services in one pass and edit every suggested address. For image-matched apps, Homarr uses the detected service type
-when building host, subdomain, or reverse-proxy path suggestions.
-
-When setup completes, Homarr rechecks the selected container sources and then:
-
-- creates an app with its name, address, icon, description, and ping address;
-- creates the requested integration and links its app after you provide required credentials;
-- places grouped apps in a board container named by `homarr.group`;
-- places ungrouped apps in the main board area;
-- adds `homarr.widget` only when the widget kind is valid and compatible with the selected integration;
-- keeps image-based discovery available for unlabeled containers.
-
-If a selected container disappears, targets another board, or requests an incompatible widget, setup finishes with a
-warning instead of creating an invalid board item.
-
-## Board targeting
-
-On a fresh installation with one seeded `dashboard` board, one unique selected `homarr.board` value can name that first
-board. Otherwise, the label must match the board selected in onboarding. Services labeled for another board are skipped
-and reported in the completion warning.
-
-Onboarding configures one board at a time. Run normal board management after setup if you want to distribute services
-across several boards.

apps/docs/docs/integrations/docker/index.mdx

@@ -122,77 +122,9 @@ services:
       DOCKER_SOCKET_PATHS: /var/run/docker.sock,/var/run/podman.sock
 ```
 
-For named endpoints, transport security, or least-privilege actions, prefer `DOCKER_ENDPOINTS`. It is a JSON array where every endpoint declares its identity, transport, and capabilities:
-
-```yaml
-services:
-  homarr:
-    volumes:
-      - /var/run/docker.sock:/var/run/docker.sock
-      - ./docker-ca.pem:/run/secrets/docker-ca.pem:ro
-    environment:
-      DOCKER_ENDPOINTS: >-
-        [
-          {
-            "id": "local",
-            "name": "Local Docker",
-            "kind": "docker",
-            "transport": { "type": "socket", "path": "/var/run/docker.sock" },
-            "capabilities": ["inventory", "logs", "lifecycle", "remove"]
-          },
-          {
-            "id": "remote-read-only",
-            "name": "Production inventory",
-            "kind": "docker",
-            "transport": {
-              "type": "tls",
-              "host": "docker.example.com",
-              "port": 2376,
-              "caPath": "/run/secrets/docker-ca.pem"
-            },
-            "capabilities": ["inventory", "logs"]
-          }
-        ]
-```
-
-The stable `id` keeps containers from different endpoints distinct. `name` is shown in the interface, and `kind` can be `docker` or `podman`. Every endpoint must include the `inventory` capability; optionally add `logs`, `lifecycle`, and `remove`. Homarr hides or disables actions the endpoint does not allow and also enforces the same capabilities on the server.
-
-Supported transports are:
-
-- `socket`: an absolute in-container `path`
-- `tls`: `host`, `port`, and an absolute `caPath`; add both `certPath` and `keyPath` for mutual TLS
-- `tcp`: `host`, `port`, and the explicit acknowledgement `allowInsecure: true`
-
-:::warning[Plaintext TCP]
-Plaintext Docker TCP can grant unauthenticated control of the Docker host. Prefer a local socket, a least-privilege socket proxy, or TLS. The structured configuration refuses TCP unless `allowInsecure` is explicitly set to `true`.
-:::
-
-When `DOCKER_ENDPOINTS` is set, it takes precedence over the legacy `DOCKER_SOCKET_PATHS`, `DOCKER_HOSTNAMES`, and `DOCKER_PORTS` variables.
-
 ### Managing your Docker containers within Homarr
 
 Homarr allows you to interact with Docker containers running on your system.
-The **Service setup** section compares the visible containers with your existing Homarr apps and integrations. It keeps every service distinct by Docker endpoint and container ID, including multiple containers that use the same integration type.
-
-Homarr can show a service as:
-
-- **Ready to connect** when its image or name matches a supported integration
-- **New service** when it can be added as an app but no integration is recognized
-- **Already represented** or **Linked** when an app or integration already matches
-- **Address changed** when a service appears to match an integration but its reachable address has changed
-
-Suggested addresses are ranked and explain where they came from. A published address or Docker endpoint host is normally usable from a browser; a container-name address is server-only and requires Homarr to share the container network. Wildcard addresses such as `0.0.0.0` are never offered as browser destinations. You can edit every suggestion before continuing.
-
-:::info[Review before changing]
-Service discovery is read-only. Homarr never creates or changes an app or integration automatically; use the action on an individual suggestion to review and confirm its setup.
-:::
-
-Use the inbox filters to focus on services that need attention or those already represented in Homarr. Refresh runs discovery again. Dismissed suggestions are stored in the current browser using their endpoint-qualified service identity and can be restored from the same panel. If multiple existing items could match, Homarr marks the result as ambiguous and does not choose one automatically.
-
-The health badges are an evidence-based projection across Docker, integration configuration, app representation, and persisted widget links. Authentication, API request success, and widget query execution are labeled **Not observed** because Homarr does not currently retain trustworthy last-run results for these layers. Use the suggested integration test or board action to diagnose them live; **Not observed** is never presented as healthy.
-
-If one Docker endpoint is unavailable, Homarr reports that endpoint while continuing to show services from healthy endpoints. An unavailable endpoint is not treated as an empty Docker installation.
-
 Each container row has an action menu with the following options:
 
 - **View logs** - opens a dedicated logs page with a live terminal
@@ -228,13 +160,11 @@ They are then available in the app list and can be used as normally added apps.
 
 ![Apps added from containers](img/add-to-homarr-apps.png)
 
-### Container labels
+### Configuration
 
-`homarr.hide` excludes a container from the Docker Containers widget, tools page, and onboarding discovery whenever the
-label is present.
+Currently Homarr supports one label for configuration of the containers:
 
-During first-run onboarding, Homarr can also discover apps, integrations, groups, and compatible widgets from
-`homarr.*` labels, with Homepage labels as a fallback. See the complete [Docker label reference](/docs/integrations/docker-labels).
+- **homarr.hide:** If set to any value, the container will be hidden from the Docker Containers widget and tools page.
 
 ### Security
 

apps/docs/docs/integrations/kubernetes/index.mdx

@@ -14,8 +14,6 @@ import { kubernetesIntegration } from ".";
 
 Homarr provides a user-friendly Kubernetes dashboard that offers an overview of your cluster’s resources in a clear and structured interface. It allows users to view key Kubernetes objects, including `Pods`, `Services`, `Ingresses`, `Nodes`, `ConfigMaps`, `Secrets`, `Namespaces`, and `Volumes`, as well as basic metrics when the Kubernetes Metrics Server is enabled.
 
-Docker service discovery does not convert Kubernetes resources into Homarr apps or integrations. Kubernetes remains a separate, read-only operational view, so a cluster resource is never changed or linked automatically.
-
 :::warning[Read only]
 This integration is read-only, meaning Homarr does not modify or manage cluster resources but serves as an informational tool to enhance visibility into your Kubernetes environment.
 :::
@@ -27,7 +25,7 @@ This integration is read-only, meaning Homarr does not modify or manage cluster
 Before deploying Homarr in Kubernetes, ensure the following prerequisites are met:
 
 - Kubernetes (Version >= 1.24.0)
-- Metrics Server ([install from here](https://github.com/kubernetes-sigs/metrics-server)) is optional. Without it, Homarr still shows cluster inventory, node status, and reserved capacity, and identifies live CPU and memory usage as unavailable.
+- Metrics Server ([Install from here](https://github.com/kubernetes-sigs/metrics-server))
 - RBAC Enabled (Required for Homarr Helm chart)
 
 ### Configuring RBAC in Helm Chart
@@ -47,25 +45,6 @@ Enabling RBAC in the Helm chart creates the necessary Kubernetes Role-Based Acce
 - ClusterRole & ClusterRoleBinding: Extends the same permissions cluster-wide for additional flexibility.
   :::
 
-### Multiple Kubernetes contexts
-
-When Homarr runs outside a cluster, set `KUBECONFIG` explicitly so Homarr loads the contexts from the referenced kubeconfig file or files. Mount the kubeconfig read-only and set the standard `KUBECONFIG` environment variable to its path inside the Homarr container:
-
-```yaml
-services:
-  homarr:
-    volumes:
-      - ./kubeconfig:/app/config/kubeconfig:ro
-    environment:
-      KUBECONFIG: /app/config/kubeconfig
-```
-
-The Kubernetes management pages include a context selector. The selected context is stored in the page URL, so each React Query cache entry and every API request remains context-specific. Resources with the same namespace and name in two contexts therefore remain separate.
-
-Context status is checked independently. If one context is unavailable, the selector still lists healthy contexts. A context is shown as **Metrics unavailable** when its Kubernetes API is reachable but Metrics Server is not; inventory remains available without live CPU and memory usage.
-
-When Homarr runs inside Kubernetes without `KUBECONFIG`, it keeps using the in-cluster service account as the single default context.
-
 ### Homarr Dashboard Overview
 
 Once deployed, Homarr provides a dashboard displaying Kubernetes metrics and resource information. The main page includes:

apps/docs/docs/management/api/index.mdx

@@ -82,34 +82,8 @@ The OpenAPI and MCP APIs include board management endpoints for common automatio
 - Set desktop and mobile home boards for the current user
 - Configure global board defaults such as public home boards and status behavior
 
-Board layout responses identify each layout with a `mobile`, `base`, or `custom` role. Mobile and Base are protected. Layout-saving clients must preserve existing roles, keep Mobile at breakpoint `0`, keep Base as the highest breakpoint, and use unique custom breakpoints between them. The layout save operation returns the canonical saved layouts, including server-generated IDs for new custom layouts. A non-Base layout can be regenerated from Base with the protected reset operation.
-
 Use the interactive API reference to inspect the exact request body for each endpoint under the `boards` and `settings` tags.
 
-## Docker action payload migration
-
-Docker lifecycle and removal actions now identify each container with both its Docker endpoint and container ID. This is a
-breaking change for tRPC and MCP clients that previously sent an `ids` array to the start, stop, restart, or remove action.
-
-Replace the old payload:
-
-```json
-{ "ids": ["container-id"] }
-```
-
-with endpoint-qualified targets:
-
-```json
-{
-  "targets": [{ "endpointId": "local", "id": "container-id" }]
-}
-```
-
-Read `endpointId` and `id` from `docker.getContainers` (MCP tool `docker_getContainers`) immediately before the action.
-Pass those pairs unchanged to `docker.startAll`, `docker.stopAll`, `docker.restartAll`, or `docker.removeAll`; their MCP tool
-names use underscores, such as `docker_restartAll`. Endpoint qualification prevents identical container IDs on different
-Docker or Podman endpoints from targeting the wrong service.
-
 ## Partial integration failures
 
 Multi-integration widget queries keep data from integrations that remain available. Calendar and media-server results include

apps/docs/docs/management/apps/index.mdx

@@ -51,6 +51,6 @@ Note that the ping URL only accepts `http://` and `https://` URLs — custom URI
 
 ## List of apps
 
-On the apps management page you find all apps that exist in your Homarr instance. Search by name or URL, open an app directly, or use its row actions to edit and delete it. A filtered search can be cleared without leaving the page.
+On the apps management page you find all apps that exist in your Homarr instance. You can edit and delete them.
 
-Any signed-in user can view this list. Creating, editing, and deleting apps requires the corresponding app permission; board permissions are not required.
+![Apps list](./img/app-list.png)

apps/docs/docs/management/assistant.mdx

@@ -1,68 +0,0 @@
----
-description: Configure and use Homarr Assistant.
-tags:
-  - Assistant
-  - AI
-  - Administration
----
-
-# Assistant
-
-Homarr Assistant can answer questions and manage Homarr for you. It uses the signed-in user's permissions and asks for
-approval before making changes.
-
-![Homarr Assistant conversation with suggested prompts](/img/assistant/conversation.png)
-
-## Set it up
-
-Open **Management → Assistant**.
-
-![Assistant provider, credentials, and model configuration](/img/assistant/configuration.png)
-
-1. Select a provider and check its API URL.
-2. Enter an API key when required, then save the connection.
-3. Refresh the model list and select a model.
-4. Enable the assistant and save.
-
-Choose a provider preset or use **Custom endpoint** with an OpenAI-compatible Chat Completions API. The
-[Homarr provider](../workshop/homarr-provider) is the default and needs no administrator API key. The Homarr team pays
-for a limited number of Assistant uses for each user every day; users sign in to the Community Workshop to use them.
-
-:::info Local model servers
-
-Inside a container, `localhost` means the Homarr container. Use the model server's container name, local DNS name, or
-host gateway address.
-
-:::
-
-## Use it
-
-- Select **Assistant** in the user menu or press `Shift + A`.
-- Ask from `Cmd/Ctrl + K`.
-- Add the [Assistant widget](../widgets/assistant) to a board.
-
-The assistant can work with boards, apps, integrations, widgets, Custom Widgets, and connected services. Use `@` to
-add Homarr items as context, `/` for shortcuts, and the paperclip for supported files.
-
-Each request includes the user's name, current page and board, home board, server time, browser time zone, and a small
-summary of accessible Homarr resources. Live status is fetched only when needed.
-
-## Permissions and privacy
-
-- Read-only actions can run automatically. Changes require approval.
-- Homarr permissions apply to every tool call and mentioned item.
-- API keys and custom headers are encrypted and never returned to the browser.
-- Conversations are stored per user and can be exported or deleted.
-
-Prompts, attachments, tool definitions, and tool results are sent to the selected model provider. Review that
-provider's privacy policy before enabling the assistant.
-
-## Troubleshooting
-
-- **No models found:** check the base URL, model discovery path, and API key. You can enter a model ID manually.
-- **Assistant is unavailable:** enable it and save the configuration.
-- **Tool calls stop:** select a model that supports streaming and tool calls.
-- **Local endpoint is unreachable:** check container networking and the server's listen address.
-
-See [MCP](./mcp) for external AI clients and [Custom Widget agent authoring](./custom-widgets/agent-authoring) for the
-widget authoring workflow.

apps/docs/docs/management/backup.mdx

@@ -22,8 +22,6 @@ Navigate to `Management` → `Tools` → `Backup`. You must have **admin** permi
 
 ## Exporting a Backup
 
-![Export database card with the Download Backup action](/img/backup/export-database.png)
-
 Click the **Export** button in the export card. You'll be prompted to type `I understand` to confirm. Once confirmed, a ZIP file downloads containing:
 
 | File            | Description                                                         |
@@ -35,8 +33,6 @@ The backup contains the complete database. It includes Custom Widgets and all ot
 
 ## Restoring a Backup
 
-![Restore database card with the backup ZIP drop zone](/img/backup/restore-database.png)
-
 ### 1. Upload
 
 Drag and drop or select a `.zip` backup file. The import card validates that the file contains a valid `db.sqlite` and metadata.
@@ -53,9 +49,6 @@ Before restoring, Homarr uses **sql.js WASM** to analyze the backup directly in
 
 Type `I understand` to acknowledge that restoring will replace your current database. This cannot be undone.
 
-During first-run onboarding, the database is still empty, so the restore preview goes directly to **Restore Database**
-without the extra typed confirmation. After Homarr restarts, onboarding opens the restored default home board.
-
 ### 4. Restore
 
 The backup ZIP is sent to the server, validated, and applied. After a successful restore:

apps/docs/docs/management/boards/index.mdx

@@ -20,8 +20,6 @@ You can create as many boards as you want.
 Boards can be restricted to user groups.
 A user may also have a "home board" which they will see at the root path (e.g. my-homarr.com or my-homarr.com/board).
 Other boards can be viewed by direct links (e.g. my-homarr.com/board/smart-home) or via the management pages.
-The management page includes a compact structural preview of each board's Base layout so you can recognize it before
-opening it. Containers include their visible widgets and app icons instead of appearing empty.
 
 Names of boards must be unique because this will be used in the URL to load the desired board.
 
@@ -92,12 +90,11 @@ Homarr will fall back to the Homarr logo if nothing is set.
 
 ### Layout
 
-In this section you can configure the different responsive layouts. Homarr selects the layout with the highest breakpoint that is not wider than the current screen, then scales its complete fixed-size canvas uniformly.
+In this section you can configure the different responsive layouts.
+Homarr selects a layout from the screen width, then scales its complete fixed-size canvas uniformly.
 
 ![](./img/layout-settings.png)
 
-Every board has two protected layouts:
-
 Every `1 × 1` tile has a `200 × 200` logical-pixel content area.
 The `24` logical-pixel gap between tiles is separate from that size.
 A `2 × 1` tile therefore contains two fixed cell widths plus the gap between them.
@@ -106,31 +103,28 @@ When fitting below 100%, Homarr keeps widget typography and control density at t
 On larger canvases, the complete board grows together like browser zoom.
 The complete canvas always fits the available width and never adds horizontal board scrolling.
 
-- **Mobile** starts at `0px` and uses three columns on new boards.
-- **Base** is the widest layout and starts at `768px` on new boards.
-
-Mobile and Base can be renamed and their column counts can be changed, but they cannot be removed. Mobile has no fixed rails; rail configuration is available only on Base and custom layouts. You can add removable custom layouts between their breakpoints.
-
-Each layout stores independent positions and sizes. Moving or resizing a widget while editing Mobile does not move it in Base or any custom layout. New custom layouts are generated from Base and scaled to their selected column count.
-
-Use **Reset from Base** on Mobile or a custom layout to replace all of its positions and sizes with a newly generated version of Base. The layout's name, breakpoint, and column count are kept.
+The position and size of every item are independent in each responsive layout.
+Moving or resizing an item in one layout does not change any other layout.
+When adding a new layout, its initial positions and sizes are generated from the column count.
+New items use their widget's default grid size, while a new Container starts at a useful `4 × 3` size when the layout has enough columns.
+Both are placed in the first available position.
 
 The canvas is at least one window tall, even when it is empty.
 Its left and right edges are hard drag boundaries, while its bottom edge extends automatically as a tile is dragged or resized downward.
 Nested Containers keep their own resizable bounds.
-New items use their widget's default size and new Containers use a useful `4 × 3` size when space allows.
 
 #### Name
 
-The name of the layout can be chosen freely. It is only used for management and is not displayed on the board.
+The name of the layout can be chosen freely. It is only used for management and will not be visible on the board.
 
 #### Column count
 
-The total number of columns in the layout. Changing it projects the saved positions and sizes into the new grid width without overlap.
+Total number of columns for this layout.
+When changed, Homarr moves items into the next available positions without overlap.
 
 #### Fixed rails
 
-Base and custom responsive layouts can enable a fixed left rail, a fixed right rail, or both. Mobile has no fixed rails.
+Each responsive layout can enable a fixed left rail, a fixed right rail, or both.
 Set a rail width to zero to disable it for that layout.
 Choose a width from one to three columns with the three-step slider.
 The preview shows how much space remains for the main canvas.
@@ -145,7 +139,8 @@ Apps, widgets, and Containers inside them still use the same fixed `200 × 200`
 
 #### Breakpoint
 
-The minimum screen width where the layout is used. Mobile is fixed at `0px`. Custom breakpoints must be unique and sit between Mobile and Base. Base must remain the highest breakpoint.
+Minimum width of the screen where the layout will be used.
+Once the minimum of the next layout is reached, the layout will change.
 
 #### View and edit modes
 
@@ -159,15 +154,6 @@ The visible corner controls provide a 44-pixel resize target, and edge controls
 Resize handles stop at the tile's minimum allowed size while the pointer is still moving.
 Exit edit mode to save the resulting positions.
 
-While edit mode is active, **Add board content** opens the same Universal Create surface as the global header action and
-Spotlight. It can add a widget, app, integration, Container, board, Workshop item, or Custom Widget when the
-current user and context allow it. Widget setup offers the main canvas, enabled rails, and existing Containers as
-destinations before the widget is created, so the common flow does not require a second move step.
-
-The widget editor also lists its selected integrations. Users with full access can choose **Edit connection** to test,
-diagnose, and repair an integration without leaving the board. A successful repair refreshes the affected widget; the
-saved integration changes apply everywhere that connection is used.
-
 Pointer users can drag anywhere on a widget tile. Containers use the grab button at their top-left corner.
 Resize tiles from any edge or corner handle.
 On a touch screen, press and hold the tile before moving it; resize handles support direct touch input.
@@ -179,10 +165,6 @@ The **Move / resize item** action in the edit menu remains available for precise
 
 #### Preview
 
-Layout Settings shows a lightweight structural preview for every layout, including saved spans, Containers, widget labels, and app icons. The canvas width represents the screen range where that layout is active.
-
-Choose **Edit layout** to open the real board editor at that representative width on desktop. Save returns to Layout Settings. Cancel discards the local changes. On phones and tablets, the normal board editor continues to use the layout selected by the device width.
-
 <img src={layoutSmallImage} height={256} />
 <img src={layoutMediumImage} height={256} />
 <img src={layoutLargeImage} height={256} />
@@ -258,10 +240,6 @@ Change the radius of your items and Containers.
 This is the field where you can enter custom CSS.
 The styling will only be applied on the respective board page.
 
-When Homarr Assistant is enabled, users with modify permission can also ask it to edit the board's Custom
-CSS and other visual or behavior settings. The assistant reads the current stylesheet first and presents an
-editable review form before requesting approval to save the change.
-
 [See this guide on how to work with custom CSS](/docs/advanced/styling/).
 
 ### Behaviour

apps/docs/docs/management/custom-widgets/agent-authoring.mdx

@@ -17,9 +17,7 @@ Install the Agent Skill from the verified Homarr repository:
 npx skills add https://github.com/homarr-labs/homarr --skill homarr-custom-widget
 ```
 
-The portable skill gives concise authoring guidance. For connected agents, Homarr returns the complete `SKILL.md` and
-all bundled skill references once in one lazy tool response. The Homarr MCP prompt then gives the agent a
-retrieval workflow: read the live schema and fetch only the component documentation needed for the widget.
+The portable skill gives concise authoring guidance. The Homarr MCP prompt gives connected agents a retrieval workflow: read the live schema, then fetch only the component documentation needed for the widget.
 
 The workbench's **Copy AI prompt** action is separate. It creates a self-contained prompt below 12,000 characters for an ordinary ChatGPT or Claude conversation. It includes the lean contract, bindings, recommended components, and two polished examples. It never tells an offline model to call MCP tools.
 
@@ -39,55 +37,38 @@ Repository code cannot give this attribution.
 
 The authoring-prompt tool description contains one sentence. The prompt contains the workflow instructions and resource links.
 
-`GET /api/custom-widgets/skill` and `customWidget_getSkill` return a self-contained structured skill payload:
+`GET /api/custom-widgets/skill` and the MCP tool return the concise skill discovery payload:
 
 ```ts
 {
   name: "homarr-custom-widget";
   version: string;
-  skillMd: string; // Complete SKILL.md
-  references: Record<string, string>;
+  skillMd: string;
   skillsShUrl: string;
   sourceUrl: string;
   installCommand: string;
 }
 ```
 
-The `homarr://custom-widgets/skill` MCP resource returns the same `SKILL.md` and references once as bundled Markdown.
-
-The component catalog is a compact index of names, categories, safety levels, shared prop names, policies, and example
-IDs. Per-component results contain only component-specific props and a reference to shared prop documentation. Use
-`customWidget_getSharedProps` once with only the shared prop names needed across the selected components. This avoids
-repeating hundreds of global props in every tool result. The catalog is deliberately not embedded in the skill or
-clipboard prompt; the skill response still contains the complete authoring, schema, runtime, and security references.
+The full installed component catalog stays available through `homarr://custom-widgets/components` and per-component resources. It is deliberately not embedded in the skill or clipboard prompt.
 
 These interfaces do not return an archive URL or archive hash.
 
 ## Create a Custom Widget with MCP
 
-1. Load `customWidget_getSkill`, then get the prompt and live schema.
-2. Call `customWidget_getComponentCatalog`, followed by `customWidget_getComponent` for only the relevant installed
-   components and `customWidget_getExample` when one catalog example matches the interaction pattern. If shared props
-   are needed, collect their catalog names and call `customWidget_getSharedProps` once for that set.
-3. Read the external API documentation.
-4. Build one definition, using `templateLines` for multiline JSX tool input.
-5. Validate the definition without saving it and repair every reported issue.
-6. Create a preview session.
-7. Run `customWidget_previewQuery` for every query returned by the preview and inspect its actual status and data shape.
-8. Test relevant actions in simulation mode.
-9. Open the returned preview path with browser tools.
-10. Inspect the redacted journal and revise the local candidate until validation, data, and rendering all work.
-11. Create the widget, including any source URLs and credentials the user already supplied.
-12. Open its returned management path, and use a structured question when the user must choose whether to place it on a board.
-13. Otherwise, ask the user to configure the saved definition with the ten-minute Homarr source-setup URL.
-14. Create a final preview with the saved definition ID so Homarr loads its stored credentials, then test it again.
-15. Update the saved definition if the final verification finds a problem. `customWidget_update` also accepts
-    `templateLines` for multiline JSX without resetting omitted options.
-16. Repeat the procedure for the next widget.
-
-Successful validation returns a compact summary instead of echoing the full widget and template. Preview creation
-returns its session, links, and query checklist without repeating the submitted definition. Keep the candidate locally
-and reuse it for the next lifecycle step.
+1. Get the prompt, live schema, and component catalog.
+2. Read the external API documentation.
+3. Build one definition.
+4. Validate the definition without saving it.
+5. Create a preview session.
+6. Test the queries and actions.
+7. Open the preview URL with browser tools.
+8. Inspect the redacted journal and revise the local candidate until it is valid.
+9. Create the widget, including any source URLs and credentials the user already supplied.
+10. Otherwise, ask the user to configure the saved definition with the ten-minute Homarr source-setup URL.
+11. Create a final preview with the saved definition ID so Homarr loads its stored credentials, then test it again.
+12. Update the saved definition if the final verification finds a problem.
+13. Repeat the procedure for the next widget.
 
 Each source-configuration URL applies to one definition or preview and one source. It is short-lived, single-use, and
 can only be opened and completed by an authenticated Homarr administrator. The administrator confirms the server URL,
@@ -113,51 +94,11 @@ Homarr maintainers can run the same self-contained prompt that the workbench cop
 OPENROUTER_API_KEY=... pnpm --filter @homarr/custom-widgets test:ai
 ```
 
-The manifest suite covers nine complex and public-API prompts. Its deterministic fixture-backed cases include a fake
-homelab health API, CoinMarketCap's keyless public API, Bored, Agify, and a multi-request Pokédex. Before the configured
-model judges a result, the candidate must pass Homarr's real clipboard parser, canonical schema, and deterministic
-checks for documented endpoints, authentication, request triggers, query bindings, response fields, and essential
-runtime components.
+The suite uses DeepSeek V4 Pro to author Pokédex, Portainer, football, Jellyfin, and Home Assistant widgets. Before DeepSeek V4 Flash judges a result, it must pass Homarr's real clipboard parser, canonical schema, and deterministic scenario checks for the documented API routes, authentication, bindings, actions, and essential runtime components. It saves every response, validated widget manifest, and detailed category scores under `packages/custom-widgets/.ai-evaluations/`.
 
-To exercise the real Homarr Assistant lifecycle instead of accepting a returned JSON block, run:
-
-```sh
-OPENROUTER_API_KEY=... pnpm --filter @homarr/custom-widgets test:assistant-ai
-```
-
-The same suites can target the Homarr provider with a Workshop PocketBase token instead of an OpenRouter key:
-
-```sh
-AI_PROVIDER_BASE_URL=https://homarr.dev/api/ai/v1 \
-AI_PROVIDER_API_KEY=<workshop-token> \
-AI_PROVIDER_MODEL=homarr/model \
-pnpm --filter @homarr/custom-widgets test:assistant-ai
-```
-
-`AI_PROVIDER_JUDGE_MODEL` can select a separate judge when the configured endpoint offers one. The Homarr provider
-offers exactly one model, so generation and review both use `homarr/model`.
-
-The assistant test exposes the same lazy skill, live schema, component catalog, targeted component references,
-validation, preview-query, and create-from-preview tools as the product. It refuses to save a definition that was not
-validated exactly or whose preview queries were not all tested. Multi-request fixtures return a different payload for
-each documented path and require manual-query parameters. Use `--case=pokedex`, `--case=coinmarketcap-keyless`,
-`--case=bored-activity`, or `--case=agify-name` for a focused run.
-
-Both suites use the configured provider models for generation and harsh review. They save tool traces, validated
-manifests, raw reviews, and detailed category scores under
-`packages/custom-widgets/.ai-evaluations/`. These live tests are maintainer-invoked rather than CI-required because
-they consume a configured provider account and exercise a nondeterministic model. The repository's ordinary tests
-cover the lifecycle enforcement, fixture routing, score calculation, and failure behavior without network access.
-
-Each scenario stops as soon as it passes and has a hard limit of ten generation attempts. Override the endpoint,
-models, or per-scenario limit with `AI_PROVIDER_BASE_URL`, `AI_PROVIDER_API_KEY`, `AI_PROVIDER_MODEL`,
-`AI_PROVIDER_JUDGE_MODEL`, and
+Each scenario stops as soon as it passes and has a hard limit of ten generation attempts. Override the models or
+per-scenario limit with `OPENROUTER_GENERATOR_MODEL`, `OPENROUTER_JUDGE_MODEL`, and
 `CUSTOM_WIDGET_AI_MAX_LOOPS`. Generated artifacts are local and ignored by Git; promote a reviewed, validated result
 into the bundled-widget source deliberately.
 
 The reference API check uses a real PokeAPI list/detail request and a read-only Portainer container query when `PORTAINER_BASE_URL` and `PORTAINER_API_KEY` are set. Use `pnpm --filter @homarr/custom-widgets test:reference-apis -- --pokeapi-only` for the public PokeAPI check alone. To exercise start, restart, and stop against a disposable container, also set `PORTAINER_TEST_CONTAINER_ID` and the explicit safeguard `PORTAINER_ALLOW_MUTATIONS=1`; the script restores the container's original running state.
-
-Use `pnpm --filter @homarr/custom-widgets test:reference-apis -- --public-ai-apis-only` to verify the live Bored and
-CoinMarketCap response shapes used by the assistant fixtures. The same command also verifies Agify when
-`AGIFY_API_KEY` is configured; otherwise it reports the authenticated check as skipped without weakening the
-deterministic Agify fixture tests.

apps/docs/docs/management/custom-widgets/index.mdx

@@ -40,12 +40,6 @@ interface HomarrCustomWidgetV2 {
 }
 ```
 
-### Design with AI
-
-The **Design with AI** action is available while creating or editing a custom widget. Describe what the widget should show and, when [Homarr Assistant](../assistant) is enabled, send the request directly from the form. The assistant receives the widget schema, current non-secret configuration, and latest test response, then proposes the matching create or update tool for your approval.
-
-Run **Test** first when possible so the prompt includes the endpoint's real response shape. Saved secrets are never added to the prompt. **Copy to clipboard** remains available when the Assistant is disabled or when you prefer another AI service.
-
 <CustomWidgetCodeExample
   id="complete-widget-manifest"
   label="Complete manifest"

apps/docs/docs/management/integrations/index.mdx

@@ -13,9 +13,9 @@ Check [the available integrations](/docs/category/integrations) for further info
 
 ## Create an integration
 
-To create an integration, choose **New integration** and select the supported application from the searchable grid. The grid groups related services visually and shows which widgets each integration supports.
+To create an integration, you can choose the supported application from the dropdown at the top right:
 
-The integrations management page uses a searchable list. Each row shows the integration type and URL, with the actions you have permission to use.
+![](./img/create-integration-dropdown.png)
 
 Next, you'll need to fill out the required fields to configure the integration:
 
@@ -59,22 +59,6 @@ It is not allowed to create an integration without passing the test.
 This is to ensure that you minimize the amount of broken applications on your Homarr instance.
 The test and create button will perform a network request to the application and authenticate if required.
 
-When you connect a service from a board, Homarr keeps you in the same setup flow. After the connection succeeds, it
-confirms whether an application shortcut was linked and offers the widgets that support the new integration. Selecting a
-widget returns to its settings with the new integration already selected.
-
-Users with full access can also test and update a selected integration from **Edit widget → Edit integration** on a
-board. Failed tests keep the editor open and show the same connection diagnostics as the management page. Successful
-changes apply to every app and widget that uses the integration.
-
-When app creation is not permitted, the setup form offers linking an existing accessible app instead of attempting to
-create one.
-
-When the connection unlocks useful widgets that are not on the current board yet, the confirmation also shows up to
-three explainable recommendations. A recommendation is based only on the services you can use and the widget kinds
-already present on that board. You can open the existing widget picker prefiltered to the recommendation, or dismiss
-recommendations for that service on that board.
-
 ## Managing permissions
 
 On the edit page of an integration, you can manage which users / groups can

apps/docs/docs/management/mcp.mdx

@@ -8,19 +8,10 @@ tags:
 
 # Model Context Protocol (MCP)
 
-Homarr exposes a [Model Context Protocol](https://modelcontextprotocol.io) server at `/api/mcp`, enabling AI assistants like Claude, Cursor, VS Code Copilot, and Claude Code to interact with your Homarr instance using natural language.
-
-The endpoint implements the stateless MCP 2026-07-28 protocol and accepts 2025 Streamable HTTP clients through a
-stateless compatibility path. It does not create protocol sessions or require sticky sessions. Homarr creates the
-server and extracts its tools only after an authenticated request reaches the route. The previous `/api/mcp/mcp` URL
-remains available as a compatibility alias, but new clients should always use `/api/mcp`.
+Homarr exposes a [Model Context Protocol](https://modelcontextprotocol.io) server at `/api/mcp/mcp`, enabling AI assistants like Claude, Cursor, VS Code Copilot, and Claude Code to interact with your Homarr instance using natural language.
 
 With MCP, you can ask your AI assistant to manage apps, integrations, users, boards, Docker containers, media servers, DNS settings, and more - all through Homarr's existing tRPC API, now exposed as 50+ AI-callable tools.
 
-The optional [Homarr Assistant](./assistant) uses these same tool definitions internally.
-Unlike external MCP clients, it uses the current Homarr session directly and asks for in-conversation
-approval before running mutating procedures.
-
 ## Getting Started
 
 The MCP endpoint lives under the **API** page at `Management` → `Tools` → `API` → **MCP** tab.
@@ -51,7 +42,7 @@ Add the following to your client's MCP configuration file:
 {
   "mcpServers": {
     "homarr": {
-      "url": "https://your-homarr-instance.com/api/mcp",
+      "url": "https://your-homarr-instance.com/api/mcp/mcp",
       "headers": {
         "ApiKey": "<your-api-key>"
       }
@@ -82,7 +73,7 @@ Replace `<your-api-key>` with your actual API key. Never commit API keys to vers
   "mcpServers": {
     "homarr": {
       "command": "npx",
-      "args": ["-y", "mcp-remote", "https://your-homarr-instance.com/api/mcp", "--header", "ApiKey:<your-api-key>"]
+      "args": ["-y", "mcp-remote", "https://your-homarr-instance.com/api/mcp/mcp", "--header", "ApiKey:<your-api-key>"]
     }
   }
 }
@@ -105,10 +96,6 @@ Custom Widget and Workshop authoring are different: their tools, prompts, and re
 key owner is a Homarr administrator. Non-administrator keys cannot discover or invoke those capabilities. Creating an
 API key never elevates the owner.
 
-OAuth authorization and token requests bind issued credentials to the canonical `/api/mcp` resource. Dynamic client
-registration remains available for compatibility with current MCP clients while the ecosystem transitions toward
-pre-registered clients and Client ID Metadata Documents.
-
 ## Testing the Connection
 
 Verify your MCP endpoint is working:
@@ -116,17 +103,13 @@ Verify your MCP endpoint is working:
 ```bash
 curl -s -X POST \
   -H "Content-Type: application/json" \
-  -H "Accept: application/json" \
+  -H "Accept: application/json, text/event-stream" \
   -H "ApiKey: <your-api-key>" \
-  -H "Mcp-Method: server/discover" \
-  -H "Mcp-Name: homarr" \
-  -d '{"jsonrpc":"2.0","method":"server/discover","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"test","version":"1.0"},"io.modelcontextprotocol/clientCapabilities":{}}},"id":1}' \
-  https://your-homarr-instance.com/api/mcp
+  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}},"id":1}' \
+  https://your-homarr-instance.com/api/mcp/mcp
 ```
 
-A successful response includes the supported protocol versions and server capabilities. Use `tools/list` to see all
-available tools. MCP v2 clients add the per-request metadata and `Mcp-Method` / `Mcp-Name` headers automatically; the
-abbreviated request below uses the stateless 2025 compatibility path for readability:
+A successful response includes the server capabilities and available tools. Use `tools/list` to see all available tools:
 
 ```bash
 curl -s -X POST \
@@ -134,36 +117,33 @@ curl -s -X POST \
   -H "Accept: application/json, text/event-stream" \
   -H "ApiKey: <your-api-key>" \
   -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' \
-  https://your-homarr-instance.com/api/mcp
+  https://your-homarr-instance.com/api/mcp/mcp
 ```
 
-Tool catalogs are returned in deterministic order and may be cached privately by the client for five minutes. The
-removed HTTP+SSE `/sse` and `/message` transports return `410 Gone`; use the single Streamable HTTP endpoint instead.
-
 ## Available Tools
 
 Homarr exposes 50+ tools organized by namespace. Each tool is either a **query** (GET, read-only) or **mutation** (POST, write action).
 
-| Namespace          | Example Tools                                              | Type       |
-| ------------------ | ---------------------------------------------------------- | ---------- |
-| `app`              | List all apps, get app by ID, create/update/delete app     | GET + POST |
-| `apiKeys`          | List API keys                                              | GET        |
-| `beszel`           | Systems status, alerts, historical system metrics          | GET        |
-| `board`            | List boards, read settings/CSS, create/update/delete board | GET + POST |
-| `docker`           | List containers, inspect container, start/stop/restart     | GET + POST |
-| `icon`             | Search icons                                               | GET        |
-| `info`             | Server health, version info                                | GET        |
-| `integration`      | List integrations, test connection, delete integration     | GET + POST |
-| `invite`           | List invitations, delete invite                            | GET + POST |
-| `calendar`         | Calendar events from media servers                         | GET        |
-| `customWidget`     | Validate, preview, create, and iteratively update widgets  | GET + POST |
-| `dnsHole`          | DNS hole summary, toggle blocking                          | GET + POST |
-| `downloads`        | Active downloads, pause/resume/delete                      | GET + POST |
-| `healthMonitoring` | Resource usage stats                                       | GET        |
-| `patchmon`         | Host patch and security update statistics                  | GET        |
-| `mediaRequests`    | Approve/decline media requests                             | GET + POST |
-| `mediaServer`      | Media server sessions and stats                            | GET        |
-| `smartHome`        | Execute automations, device states                         | GET + POST |
+| Namespace          | Example Tools                                             | Type       |
+| ------------------ | --------------------------------------------------------- | ---------- |
+| `app`              | List all apps, get app by ID, create/update/delete app    | GET + POST |
+| `apiKeys`          | List API keys                                             | GET        |
+| `beszel`           | Systems status, alerts, historical system metrics         | GET        |
+| `board`            | List boards, get board by ID, create/update/delete board  | GET + POST |
+| `docker`           | List containers, inspect container, start/stop/restart    | GET + POST |
+| `icon`             | Search icons                                              | GET        |
+| `info`             | Server health, version info                               | GET        |
+| `integration`      | List integrations, test connection, delete integration    | GET + POST |
+| `invite`           | List invitations, delete invite                           | GET + POST |
+| `calendar`         | Calendar events from media servers                        | GET        |
+| `customWidget`     | Validate, preview, create, and iteratively update widgets | GET + POST |
+| `dnsHole`          | DNS hole summary, toggle blocking                         | GET + POST |
+| `downloads`        | Active downloads, pause/resume/delete                     | GET + POST |
+| `healthMonitoring` | Resource usage stats                                      | GET        |
+| `patchmon`         | Host patch and security update statistics                 | GET        |
+| `mediaRequests`    | Approve/decline media requests                            | GET + POST |
+| `mediaServer`      | Media server sessions and stats                           | GET        |
+| `smartHome`        | Execute automations, device states                        | GET + POST |
 
 The tools table on the MCP tab is dynamically generated - it always reflects the latest available procedures from your Homarr instance.
 
@@ -195,36 +175,21 @@ An agent creates one `homarr-custom-widget-v2` definition at a time. Start with
 The API key owner must be a Homarr administrator. The same rule applies to management, import, migration, preview,
 secrets, publication, Workshop installation, and the HTTP authoring resources.
 
-Load the installed skill before authoring. `customWidget_getSkill` returns the complete `SKILL.md` entrypoint and every
-bundled reference in one response, so an MCP client does not need filesystem access or a second documentation fetch.
-Then read the live schema and only the component resources required by the design. These resources describe the
-installed Mantine components.
+Then, read the live schema and component resources. These resources describe the installed Mantine components.
 
-1. Call `customWidget_getSkill`, `customWidget_getAuthoringPrompt`, `customWidget_schema`, and
-   `customWidget_getComponentCatalog`.
-2. Fetch only the relevant installed component documentation with `customWidget_getComponent` and, when useful,
-   one interaction example with `customWidget_getExample`. Component results contain component-specific props; collect
-   any needed shared prop names from the compact catalog and fetch them together once with `customWidget_getSharedProps`.
-3. Build one Custom Widget definition. Use `templateLines` for generated multiline JSX to avoid a fragile JSON-escaped
-   template string.
-4. Call `customWidget_validate` without saving the definition and repair every returned issue path.
-5. Call `customWidget_previewCreate`.
-6. Call `customWidget_previewQuery` for every entry in the returned `queries` list. Supply the listed invocation
-   parameters for manual queries and inspect the real HTTP status and response shape before binding template fields.
-7. Test relevant actions with `customWidget_previewAction` in simulation mode.
-8. Open the returned `previewPath` or `previewUrl`.
-9. Examine `customWidget_previewJournal`.
-10. Revise the local candidate and create another preview session until validation, query data, actions, and rendering
-    are ready.
-11. Call `customWidget_create`, supplying any credentials and deployment-specific source URLs the user already provided.
-12. Open the returned `managementPath` to review the exact saved definition.
-13. If the user must enter the source URL or credentials, call `customWidget_configurationRequestUser` with the new definition ID and wait for completion.
-14. Create a final preview with that definition ID so Homarr loads its stored credentials, then test it again.
-15. Use `customWidget_update` or `customWidget_templatePatch` for any final saved-definition corrections.
-16. Repeat this procedure for the next Custom Widget.
-
-Validation and preview creation return compact lifecycle metadata. They do not echo the submitted widget or duplicate
-its template as both a string and line array; the agent should retain and reuse its local candidate.
+1. Call `customWidget_getAuthoringPrompt` and `customWidget_schema`.
+2. Build one Custom Widget definition.
+3. Call `customWidget_validate` without saving the definition.
+4. Call `customWidget_previewCreate`.
+5. Test named requests with `customWidget_previewQuery` and `customWidget_previewAction`.
+6. Open the returned preview URL.
+7. Examine `customWidget_previewJournal`.
+8. Revise the local candidate and create another preview session until it is ready.
+9. Call `customWidget_create`, supplying any credentials and deployment-specific source URLs the user already provided.
+10. If the user must enter the source URL or credentials, call `customWidget_configurationRequestUser` with the new definition ID and wait for completion.
+11. Create a final preview with that definition ID so Homarr loads its stored credentials, then test it again.
+12. Use `customWidget_update` or `customWidget_templatePatch` for any final saved-definition corrections.
+13. Repeat this procedure for the next Custom Widget.
 
 The agent receives the configuration-request status. The agent does not receive plaintext credentials. A preview-scoped setup URL configures only that temporary preview; use a definition-scoped URL when the values must persist.
 
@@ -260,10 +225,6 @@ The Custom Widget tools are:
 - `customWidget_workshopGet`
 - `customWidget_workshopInstall`
 - `customWidget_getAuthoringPrompt`
-- `customWidget_getComponentCatalog`
-- `customWidget_getComponent`
-- `customWidget_getSharedProps`
-- `customWidget_getExample`
 - `customWidget_getSkill`
 
 Custom Widget permissions are not assignable group capabilities. Administrator status is required for the complete

apps/docs/docs/management/search-engines/index.mdx

@@ -8,7 +8,8 @@ tags:
 # Search Engines
 
 Using the search engines, terms can be quickly searched simply by opening the search bar at the top or using the keyboard shortcut `CTRL + K`.
-The management page provides a searchable list with the shortcut, URL template, source, and available row actions for each engine.
+
+![](./img/search-engines.png)
 
 You can add any search engine that has a search URL that accepts a search term as a parameter.
 

apps/docs/docs/management/workshop/index.mdx

@@ -0,0 +1,169 @@
+---
+tags:
+  - Workshop
+  - Custom Widgets
+  - Custom CSS
+---
+
+# Community Workshop
+
+:::warning Experimental feature
+
+This feature is experimental and will probably change. If you encounter bugs, need more capabilities, or find something confusing, tell us in the [official discussion thread](https://github.com/homarr-labs/homarr/discussions/categories/custom-widgets). Your feedback directly shapes what comes next. Happy hacking!
+
+:::
+
+The [Community Workshop](pathname:///workshop) is where Homarr users share and discover
+**custom CSS themes** and **custom widgets**. You can browse submissions, upvote the ones
+you like, report abuse, and install entries directly into your own Homarr instance.
+
+The central `homarr.dev` Workshop is a public community. Browsing it on the website is public. Browsing, installing,
+publishing, or importing Workshop content **inside a Homarr instance is restricted to Homarr administrators**.
+
+:::warning
+
+The Workshop contains community-made content. Moderation is not a security boundary, and PocketBase does not interpret
+or validate submission content. Always review widget capabilities, network origins, actions, and CSS before installing.
+Homarr's installation-time validator is definitive and can reject content that the public service accepted earlier.
+Back up your instance before installing untrusted content.
+
+:::
+
+## Browsing and voting
+
+- Filter by **Widgets** or **CSS**, show or hide outdated entries, and sort by popularity, creation date, recent updates, or discussion activity.
+- Sign in with **GitHub** to upvote/downvote, submit your own creations, or report a submission.
+- Each submission shows its title, description, linked GitHub author, revision, optional screenshots, comments, and full content. Widget pages also summarize API sources, actions, options, network access, and required credentials before installation.
+- A new submission receives one real upvote owned by its author. Votes remain unique per user and submission.
+- Open report counts are public on submission cards so visitors can make an informed installation decision. The submission author and Workshop moderators can read each report category and explanation; reporter identities remain moderator-only.
+- Signed-in moderators see a **Moderation** button in the Workshop header. The moderation queue is sorted by open report count and lets moderators inspect every report, dismiss it, or delete the submission. Reports do not automatically remove a submission.
+- The manual **Outdated** badge warns visitors that a submission may need an update.
+
+## Comments
+
+Comments are publicly readable and appear in chronological conversation bubbles with the author's avatar and GitHub profile. Signed-in users can post; authors can edit or delete their own comments, and Workshop moderators can delete any comment. Failed posts keep the text you typed. When SMTP and `WORKSHOP_PUBLIC_ORIGIN` are configured, the submission author receives one email for a comment from another user. Self-comments, edits, and deletions do not send mail.
+
+## Submitting
+
+1. Sign in with GitHub.
+2. Click **Share yours** and choose the type:
+   - **Custom widget** — paste the JSON exported from **Manage → Custom Widgets → Export**.
+     It must match the `homarr-custom-widget-v2` schema (validated before submission).
+   - **Custom CSS** — paste your stylesheet (max 16384 characters).
+3. Review the widget JSON or CSS in the syntax-aware editor, then add a title, description, optional screenshots, and changelog.
+4. Submit the entry.
+
+Custom widget JSON is normalized to readable multi-line formatting when it is published, and the Workshop detail page
+also formats older compact submissions before displaying them.
+
+Community members can report submissions as outdated or no longer working, malicious, spam, copyright-infringing,
+inappropriate, or another concern. An outdated report does not automatically mark or remove the submission.
+
+Submissions are published immediately. Reported entries are reviewed and may be removed.
+Authors can edit a submission later to publish a new revision. The edit form can keep or remove existing screenshots and add new PNG, JPG, or WebP images without changing the Workshop URL.
+
+When SMTP and `WORKSHOP_PUBLIC_ORIGIN` are configured, every current Workshop moderator receives an email when a report is submitted. If a moderator deletes the reported submission, its author receives a separate removal email. Author self-deletion does not send a moderation email.
+
+:::info Separate roles
+
+A Workshop moderator is a user with PocketBase's internal `isAdmin` field. This role moderates the central community
+and is unrelated to a Homarr instance administrator.
+
+:::
+
+## Submission guidelines
+
+Submissions must be useful to Homarr users and safe to install. Do not submit content that is
+malicious, deceptive, illegal, hateful, sexually explicit, gore, gambling-focused, spam, or content
+that primarily promotes unrelated products or services.
+
+## Installing into Homarr
+
+You can install workshop entries without leaving Homarr:
+
+- **Custom widgets (Homarr administrators only)** — go to **Manage → Custom Widgets**, or use **Import from Workshop** in the
+  board widget picker. Choose **Install widget**, review the complete source and capabilities, then confirm API sources and any local secrets in the second modal step.
+- **Custom CSS from Workshop (Homarr administrators only)** — open a board's **Settings → Custom CSS**, click **Import from Workshop**, choose a theme, review its full CSS in the second same-size modal step, and click **Import CSS** once. The board setting is still saved separately.
+
+Alternatively, open a submission in the Workshop and use **Download widget JSON** or **Copy CSS**. The submission page shows the matching manual installation steps before the source code.
+
+Custom Widget imports detect required bearer, basic, header, or query credentials. You can enter them during import or explicitly defer them; secret values are never stored in Workshop content. Missing credentials remain visible on the local Custom Widget afterward.
+
+## Workshop deployment
+
+Workshop is powered by [PocketBase](https://pocketbase.io). The production image compiles the current Docusaurus site and serves it together with the API from one origin. The deployment lives in `apps/workshop/` with a Dockerfile, Compose configuration, version-controlled migrations, hooks, a smoke test, and ACT-local workflow instructions.
+
+Submission links include Open Graph and X/Twitter metadata for the submission title, description, and type. The first uploaded screenshot is used as the social preview image; submissions without screenshots use the Homarr logo.
+
+Run `pnpm docker:workshop` for PocketBase on port 8090, then run
+`WORKSHOP_API_URL=http://127.0.0.1:8090 pnpm dev:docs` for Docusaurus on port 3003. `pnpm docker:docs` builds the
+combined production layout. Normal start and stop commands retain data; `down --volumes` is an intentional,
+irreversible development reset.
+
+GitHub needs only the central callback `https://<workshop-host>/api/oauth2-redirect`. Keep PocketBase origins unrestricted
+unless every self-hosted Homarr caller is explicitly listed. Configure both `GITHUB_CLIENT_ID` and
+`GITHUB_CLIENT_SECRET`; supplying only one is a startup error. Set `WORKSHOP_PUBLIC_ORIGIN` in production so generated
+links and email use the public host. Workshop stores only the OAuth provider username in `users.name`, and
+users cannot rename it. Map **OAuth2 username** to `name`; leave OAuth2 id, full name, and avatar mappings
+empty. Profile and avatar URLs are derived from `https://github.com/<username>` and
+`https://github.com/<username>.png`, so PocketBase does not store duplicate profile metadata or avatar files. Configure
+SMTP for comment, report, and removal notices.
+
+The public URL contract is:
+
+| Variable                 | Purpose                                           | Default                       |
+| ------------------------ | ------------------------------------------------- | ----------------------------- |
+| `HOMARR_WEBSITE_URL`     | Documentation/site base used by Homarr links      | `https://homarr.dev`          |
+| `WORKSHOP_API_URL`       | PocketBase API used by Homarr and standalone docs | `HOMARR_WEBSITE_URL`          |
+| `WORKSHOP_WEB_URL`       | Public Workshop page linked from Homarr           | `HOMARR_WEBSITE_URL/workshop` |
+| `WORKSHOP_PUBLIC_ORIGIN` | PocketBase-generated links and email              | Required in production        |
+| `PB_ALLOWED_ORIGINS`     | PocketBase browser origins                        | `*` for the central community |
+
+The deprecated docs-only `WORKSHOP_URL` alias remains for one release; `WORKSHOP_API_URL` takes precedence. The
+combined Workshop image writes these public URLs into its browser runtime configuration whenever the container starts;
+the Docker build arguments remain fallbacks. Restart the container after changing these values, without rebuilding it.
+
+### Staging and demo deployment
+
+Use `apps/workshop/docker-compose.staging.yml` with the published `ghcr.io/homarr-labs/workshop:v2` image for a v2
+preview. Copy `apps/workshop/.env.staging.example` to `.env.staging`; its default public contract is:
+
+```dotenv
+HOMARR_WEBSITE_URL=https://v2.preview.homarr.dev
+WORKSHOP_API_URL=https://v2.preview.homarr.dev
+WORKSHOP_WEB_URL=https://v2.preview.homarr.dev/workshop
+WORKSHOP_PUBLIC_ORIGIN=https://v2.preview.homarr.dev
+PB_ALLOWED_ORIGINS=*
+```
+
+Start or update it from the repository root:
+
+```sh
+docker compose --env-file apps/workshop/.env.staging \
+  -f apps/workshop/docker-compose.staging.yml pull
+docker compose --env-file apps/workshop/.env.staging \
+  -f apps/workshop/docker-compose.staging.yml up --detach
+curl --fail http://127.0.0.1:8090/api/health
+```
+
+The service binds to `127.0.0.1:8090`. Terminate TLS at a reverse proxy and forward the **entire hostname**, including
+`/api`, `/_/`, and `/workshop-runtime-config.js`; forwarding only `/workshop` breaks PocketBase and runtime URL loading.
+This combined image serves both the documentation site and PocketBase, so use a dedicated Workshop hostname if the
+chosen hostname already serves Homarr itself. In that case, replace the hostname in all four URL values and keep
+`/workshop` only on `WORKSHOP_WEB_URL`.
+
+The Compose volume preserves PocketBase data across pulls and container recreation. The mutable `v2` tag is suitable
+for previews; use the `sha-<commit>` tag for promotion. For the public central Workshop, `PB_ALLOWED_ORIGINS=*` allows
+self-hosted Homarr origins to use the API and OAuth. A private demo may use a comma-separated origin allowlist instead.
+GitHub OAuth requires both credentials and the callback
+`https://v2.preview.homarr.dev/api/oauth2-redirect`. Restart after changing environment values, then verify the health
+endpoint, `/workshop`, a public listing request, GitHub sign-in, and an installation from the Homarr preview.
+
+Back up application and PocketBase data before deployment. Publish the combined image by immutable digest, test the
+exact digest in staging, rehearse application rollback and PocketBase restore, then promote that same digest.
+
+## Client architecture
+
+Workshop access is centralized in `@homarr/workshop/backend`. It exports the typed `WorkshopBackend`, its typed PocketBase instance, stable TanStack Query option factories, and the `useWorkshop…` query and mutation hooks used by Homarr. The documentation site uses the same backend rather than maintaining a second API contract.
+
+Listing fields derived by the `workshop_listings` view—such as submission type, score, and counts—are normalized by the shared client. Healthy deployments keep filtering, sorting, and pagination in PocketBase. If a persistent development volume still has an older view that rejects those fields, the client retries without them and applies the same operations locally; it can also fall back to the base submissions collection. Production deployments should nevertheless apply the current migration so the view exposes the complete metadata.

apps/docs/docs/widgets/assistant/index.mdx

@@ -1,59 +0,0 @@
----
-title: "Assistant"
-description: "Have a complete assistant conversation directly on a board."
-hide_title: true
----
-
-import { AddingWidget } from "@site/src/components/widgets/adding";
-import { WidgetConfig } from "@site/src/components/widgets/configuration";
-import { WidgetHeader } from "@site/src/components/widgets/header";
-import { assistantWidget } from ".";
-
-<WidgetHeader widget={assistantWidget} categories={["Productivity"]} />
-
-The Assistant widget brings the same conversation available from the user menu and command menu onto a
-board. Messages, conversations, tool calls, approvals, files, mentions, model controls, reasoning controls,
-usage details, and response actions remain synchronized with the app-wide assistant.
-
-The assistant must be enabled by an administrator in **Management → Assistant**. Signed-out users and users
-on an instance without an enabled model see an unavailable state instead of a broken composer.
-
-### Adding the widget
-
-<AddingWidget />
-
-The default widget size is ten columns by four rows and automatically fits boards with fewer columns. Controls
-and labels condense as the widget becomes narrower, while the conversation remains scrollable and usable on
-touch devices. When a board layout does not provide enough height for conversation controls, the widget shows
-a compact **Open assistant** action instead of squeezing an unusable composer into the card. Increase its height
-in that layout to keep the complete conversation inline.
-
-### Configuration
-
-<WidgetConfig configuration={assistantWidget.configuration} />
-
-**Current conversation** follows whichever conversation is active in the user-menu panel, `Shift + A`, or
-the command menu. This is the default and keeps every assistant entry point synchronized.
-
-**Pinned conversation** reveals a searchable conversation selector. A pinned widget never changes the
-active conversation silently: select **Open conversation** inside the widget before continuing that thread.
-
-### Conversation features
-
-- Create, switch, rename, and delete conversations.
-- Send text and supported file or image attachments by picker, drag and drop, or image paste.
-- Mention permitted apps, integrations, boards, widgets, and tools with `@`.
-- Use `/` shortcuts for common dashboard tasks.
-- Review tool calls, approve mutations, and answer structured assistant questions inline.
-- Answer pending structured questions from the dock above the composer without scrolling through the conversation.
-- Enable conversation-scoped automatic approvals from the shield control to approve protected mutations, use presented form details, and choose answers categorized as affirmative without individual clicks.
-- Edit user messages and copy, regenerate, branch, quote, export, or rate responses.
-- Inspect syntax-highlighted Markdown, sources, generated files, tool results, streaming chain-of-thought,
-  cumulative conversation usage, per-turn token and context use, timing, speed, provider routing, and cost.
-- Change the model and reasoning effort for the active conversation.
-- Refresh the current board from the conversation header. Approved mutations also refresh visible board data automatically.
-
-The expanded assistant and board widget use the same persisted thread runtime. A response continues in the
-background when the widget leaves the viewport or the expanded panel is minimized. Each visible surface keeps an
-independent draft, attachments, selection, and focus, so typing in a board widget cannot move or overwrite the
-floating panel composer.

apps/docs/docs/widgets/assistant/index.ts

@@ -1,25 +0,0 @@
-import type { WidgetDefinition } from "@site/src/types";
-import { IconRobot } from "@tabler/icons-react";
-
-export const assistantWidget: WidgetDefinition = {
-  icon: IconRobot,
-  name: "Assistant",
-  description: "Have a complete assistant conversation directly on a board.",
-  path: "../../widgets/assistant",
-  configuration: {
-    items: [
-      {
-        name: "Conversation",
-        description: "Follow the active conversation or attach the widget to one persisted conversation.",
-        values: { type: "select", options: ["Current conversation", "Pinned conversation"] },
-        defaultValue: "Current conversation",
-      },
-      {
-        name: "Pinned conversation",
-        description: "Search for a conversation. This field is hidden when Current conversation is selected.",
-        values: { type: "string" },
-        defaultValue: "",
-      },
-    ],
-  },
-};

apps/docs/docs/widgets/calendar/index.mdx

@@ -26,8 +26,6 @@ import { icalIntegration } from "@site/docs/integrations/ical";
 
 The calendar widget shows a month view of events from different integrations.
 It allows you to view calendar events or upcoming releases from your media managers.
-Calendar requests use normal human month numbers (`1` for January through `12` for December), including when
-the same data is requested through Homarr's MCP or Assistant tools.
 
 ### Screenshots
 

apps/docs/docs/widgets/downloads/index.mdx

@@ -43,12 +43,12 @@ import contextMenuImg from "./img/context-menu.png";
 - **Responsive table** — columns automatically adapt to widget width, hiding less important columns at smaller sizes
 - **Sortable columns** — click any column header to sort ascending/descending
 - **Column customization** — choose which columns to display, then hover a header to reveal its grab handle for reordering or drag its edge to resize it; layouts save automatically per widget
-- **Right-click context menu** — pause, resume, delete downloads, or copy download names directly from the context menu
+- **Right-click context menu** — copy download names, or pause, resume, and delete when your account has Interact access and the client supports those actions
 - **Row expansion** — click any row to see full details inline without opening a separate modal
 - **Hover tooltips** — hover a download name to see size, speeds, ETA, ratio, and category; open tooltips close when switching between compact and advanced mode
 - **Global stats bar** — toggle a summary bar showing queue progress, total size, speeds, ratio, and per-state counts
 - **Client filtering** — filter downloads by integration or status using the footer filter panel
-- **Global controls** — pause/resume all downloads across all clients from the footer bar
+- **Global controls** — pause/resume downloads from supported clients when your account has Interact access; read-only clients such as slskd do not expose these controls
 - **Status indicators** — color-coded badges show download state at a glance
 - **Speed overview** — total download and upload speeds displayed in the footer
 
@@ -89,13 +89,13 @@ import contextMenuImg from "./img/context-menu.png";
 
 ### Interactions
 
-- **Right-click** any download to open a context menu with pause/resume, delete, and copy actions
+- **Right-click** any download to copy its name; pause/resume and delete require Interact access and client support
 - **Click** any row to expand it and see full download details inline
 - **Hover** a download name for a quick stats tooltip
 - **Stats toggle** — show or hide the global stats bar from the footer
-- **Pause / Resume** all downloads using the footer controls
+- **Pause / Resume** downloads from supported clients using the footer controls when you have Interact access; slskd remains read-only
 - **Filter** by integration or status using the filter button in the footer
-- **Sort** by clicking column headers (with persistent sort direction)
+- **Sort** the current view by clicking column headers to switch direction
 
 <WidgetInteractionGuide />
 

apps/docs/docs/widgets/downloads/index.ts

@@ -67,7 +67,7 @@ export const downloadsWidget: WidgetDefinition = {
       {
         name: "Hide completed torrent under this threshold (in kiB/s)",
         description:
-          "This will hide completed torrent entries that have a download speed below the specified threshold.",
+          "This will hide completed torrent entries that have an upload speed below the specified threshold.",
         values: "Any number above 0, 0 to disable",
         defaultValue: "0",
       },

apps/docs/docs/workshop/_category_.json

@@ -1,9 +0,0 @@
-{
-  "label": "Workshop",
-  "collapsed": true,
-  "position": 4,
-  "link": {
-    "type": "doc",
-    "id": "workshop/index"
-  }
-}

apps/docs/docs/workshop/development.mdx

@@ -1,62 +0,0 @@
----
-title: Workshop development
-sidebar_position: 4
-tags:
-  - Workshop
-  - Developer
-  - Docusaurus
-  - PocketBase
----
-
-# Workshop development
-
-Install the repository dependencies and make sure Docker is available before starting the Workshop services. See the
-[main development guide](../advanced/development/getting-started) for the repository prerequisites.
-
-## Run PocketBase and documentation
-
-Start PocketBase in one terminal:
-
-```sh
-cp apps/workshop/.env.example apps/workshop/.env
-docker compose --env-file apps/workshop/.env -f apps/workshop/docker-compose.yml up --build workshop
-```
-
-Then start Docusaurus in another terminal:
-
-```sh
-WORKSHOP_API_URL=http://127.0.0.1:8090 pnpm dev:docs
-```
-
-PocketBase runs on port 8090 and Docusaurus on port 3003. Stopping the services preserves the PocketBase volume.
-
-Open `http://127.0.0.1:8090/_/` and create the first PocketBase superuser. The Workshop UI is available at
-`http://127.0.0.1:3003/workshop`.
-
-Point Homarr at the local services with:
-
-```dotenv
-HOMARR_WEBSITE_URL=http://127.0.0.1:3003
-WORKSHOP_API_URL=http://127.0.0.1:8090
-WORKSHOP_WEB_URL=http://127.0.0.1:3003/workshop
-```
-
-Restart `pnpm dev:docs` after changing the Docusaurus URL variables. If Homarr is also running, restart its `pnpm dev`
-process after changing the Workshop URLs. GitHub OAuth is optional locally. See
-[`apps/workshop/README.md`](https://github.com/homarr-labs/homarr/blob/HEAD/apps/workshop/README.md) for OAuth,
-Workshop moderator promotion, logs, tests, backup, restore, stopping, and intentional volume reset.
-
-## URL testing
-
-Docusaurus reads `HOMARR_WEBSITE_URL` and `WORKSHOP_API_URL` when it starts or builds. Homarr also reads
-`WORKSHOP_WEB_URL` when its server starts, so these values do not rely on `NEXT_PUBLIC_*` build variables. Test a
-separate API origin before release:
-
-```sh
-HOMARR_WEBSITE_URL=http://127.0.0.1:3003 \
-WORKSHOP_API_URL=http://127.0.0.1:8090 \
-WORKSHOP_WEB_URL=http://127.0.0.1:3003/workshop \
-pnpm dev:docs
-```
-
-The [Workshop operator guide](./operator) covers production environment variables, staging, and service validation.

apps/docs/docs/workshop/homarr-provider.mdx

@@ -1,51 +0,0 @@
----
-title: Homarr provider
-sidebar_position: 2
-tags:
-  - Assistant
-  - AI
-  - Privacy
-  - Community
----
-
-import { OpenCollectiveLink } from "@site/src/components/assistant-provider/open-collective-link";
-
-# Homarr provider
-
-The Homarr provider gives Community Workshop users access to the **Homarr model** without an administrator API key.
-The Homarr team chooses the upstream model based on quality, reliability, and cost.
-
-## Set it up
-
-1. Open **Management → Assistant**.
-2. Select **Homarr** as the provider.
-3. Save the provider connection.
-4. Select the available model, enable the assistant, and save.
-5. Open the assistant and sign in to the Workshop when asked.
-
-## Daily allowance
-
-- Each user gets **50 request units per UTC day**.
-- Each model request uses one unit. A tool loop can use several units.
-- Forwarded requests count even if the model later fails.
-- Allowances reset at 00:00 UTC. A shared daily limit also applies.
-
-The battery beside the model selector shows the remaining allowance and reset time. Workshop enforces all limits on
-its server; changing the browser clock cannot bypass them.
-
-## Privacy
-
-Workshop keeps the OpenRouter API key on its server. Homarr and the browser never receive it.
-
-Prompts, attachments, tools, and tool results pass through Workshop and OpenRouter. Workshop does not retain this
-content or the responses. It stores only the user, UTC day, and counters needed to enforce allowances. OpenRouter is
-configured for zero data retention with data collection disabled. Homarr does not use this content to train models.
-
-We would rather become millionaires in a more ethical manner.
-
-The community pays for these requests. Donations help cover the cost.
-
-<OpenCollectiveLink />
-
-Workshop operators can change the upstream model, per-user allowance, global allowance, and security limits in the
-[Workshop operator guide](./operator#homarr-provider-proxy).

apps/docs/docs/workshop/index.mdx

@@ -1,53 +0,0 @@
----
-title: Community Workshop
-sidebar_label: Overview
-tags:
-  - Workshop
-  - Custom Widgets
-  - Custom CSS
----
-
-# Community Workshop
-
-The [Community Workshop](pathname:///workshop) is where Homarr users share Custom Widgets and dashboard CSS.
-
-:::warning Experimental
-
-Workshop content is made by the community. Review it before installation and back up your Homarr instance.
-
-:::
-
-## Find and install content
-
-Browse the Workshop by type, date, popularity, or recent activity. Each submission includes its source, screenshots,
-author, revision, comments, and reports.
-
-Administrators can install content without leaving Homarr:
-
-- **Custom Widgets:** open **Management → Custom Widgets**, then select **Import from Workshop**.
-- **Custom CSS:** open a board's **Settings → Custom CSS**, then select **Import from Workshop**.
-
-Homarr shows the complete source and required permissions before installation. Widget credentials are entered in your
-Homarr instance and are never included in a Workshop submission.
-
-## Share your work
-
-1. Sign in to the Workshop with GitHub.
-2. Select **Share yours**.
-3. Choose **Custom Widget** or **Custom CSS**.
-4. Add the source, a short description, screenshots, and a changelog.
-5. Review and publish the submission.
-
-Export Custom Widget JSON from **Management → Custom Widgets → Export**. You can edit a submission later without
-changing its Workshop URL.
-
-## Voting, comments, and reports
-
-Signed-in users can vote, comment, and report submissions. Authors can edit their own comments and submissions.
-Workshop moderators can review reports, remove comments, and delete unsafe content. Reports do not remove a submission
-automatically.
-
-A Workshop moderator manages the public community. This is separate from the administrator role on a Homarr instance.
-
-Deployment and server configuration are in the [Workshop operator guide](./operator). Local setup is in
-[Workshop development](./development).

apps/docs/docs/workshop/operator.mdx

@@ -1,144 +0,0 @@
----
-title: Workshop operator guide
-sidebar_label: Operator guide
-sidebar_position: 3
-tags:
-  - Workshop
-  - Deployment
-  - Environment variables
-  - PocketBase
----
-
-# Workshop operator guide
-
-Workshop is powered by [PocketBase](https://pocketbase.io). The production image compiles the current Docusaurus site
-and serves it together with the API from one origin. The deployment lives in `apps/workshop/` with a Dockerfile,
-Compose configuration, version-controlled migrations, hooks, a smoke test, and ACT-local workflow instructions.
-
-Submission links include Open Graph and X/Twitter metadata for the submission title, description, and type. The first
-uploaded screenshot is used as the social preview image; submissions without screenshots use the Homarr logo.
-
-Run `pnpm docker:workshop` for PocketBase on port 8090, then run
-`WORKSHOP_API_URL=http://127.0.0.1:8090 pnpm dev:docs` for Docusaurus on port 3003. `pnpm docker:docs` builds the
-combined production layout. Normal start and stop commands retain data; `down --volumes` is an intentional,
-irreversible development reset. See [Workshop development](./development) for the complete local setup.
-
-## Authentication and notifications
-
-GitHub needs only the central callback `https://<workshop-host>/api/oauth2-redirect`. Keep PocketBase origins
-unrestricted unless every self-hosted Homarr caller is explicitly listed. Configure both `GITHUB_CLIENT_ID` and
-`GITHUB_CLIENT_SECRET`; supplying only one is a startup error. Set `WORKSHOP_PUBLIC_ORIGIN` in production so generated
-links and email use the public host. Workshop stores only the OAuth provider username in `users.name`, and users cannot
-rename it. Map **OAuth2 username** to `name`; leave OAuth2 id, full name, and avatar mappings empty. Profile and avatar
-URLs are derived from `https://github.com/<username>` and `https://github.com/<username>.png`, so PocketBase does not
-store duplicate profile metadata or avatar files. Configure SMTP for comment, report, and removal notices.
-
-## Environment variables
-
-The public URL contract and Workshop-only server configuration are:
-
-| Variable                               | Purpose                                           | Default                        |
-| -------------------------------------- | ------------------------------------------------- | ------------------------------ |
-| `HOMARR_WEBSITE_URL`                   | Documentation/site base used by Homarr links      | `https://homarr.dev`           |
-| `WORKSHOP_API_URL`                     | PocketBase API used by Homarr and standalone docs | `HOMARR_WEBSITE_URL`           |
-| `WORKSHOP_WEB_URL`                     | Public Workshop page linked from Homarr           | `HOMARR_WEBSITE_URL/workshop`  |
-| `WORKSHOP_PUBLIC_ORIGIN`               | PocketBase-generated links and email              | Required in production         |
-| `PB_ALLOWED_ORIGINS`                   | PocketBase browser origins                        | `*` for the central community  |
-| `OPENROUTER_API_KEY`                   | Server-only key for the Homarr provider proxy     | Provider disabled when empty   |
-| `HOMARR_AI_DAILY_REQUEST_LIMIT`        | Per-user daily provider allowance                 | `50`                           |
-| `HOMARR_AI_GLOBAL_DAILY_REQUEST_LIMIT` | Shared daily ceiling across all users             | `10000`                        |
-| `HOMARR_AI_OPENROUTER_BASE_URL`        | OpenRouter-compatible proxy upstream              | `https://openrouter.ai/api/v1` |
-| `HOMARR_AI_OPENROUTER_MODEL`           | Server-selected upstream model                    | Selected by the Homarr team    |
-
-All public URL variables reject non-HTTP protocols, embedded credentials, query strings, and fragments, and normalize
-trailing slashes when Homarr or Docusaurus starts. The deprecated docs-only `WORKSHOP_URL` alias remains for one
-release; `WORKSHOP_API_URL` takes precedence. The combined Workshop image writes the public URLs into its browser
-runtime configuration whenever the container starts; the Docker build arguments remain fallbacks. Restart the
-container after changing these values, without rebuilding it.
-
-### Homarr provider proxy
-
-The [Homarr provider](./homarr-provider) proxy is part of the Workshop image. `OPENROUTER_API_KEY` enables the proxy,
-`HOMARR_AI_OPENROUTER_BASE_URL` selects its OpenRouter-compatible upstream, `HOMARR_AI_OPENROUTER_MODEL` selects the
-private upstream model behind the stable `homarr/model` alias, and the two allowance variables provide per-user and
-shared request ceilings. Lowering either allowance takes effect for existing users. The upstream URL cannot contain
-embedded credentials, a query, or a fragment and must use HTTPS. Tests can explicitly opt into an insecure local mock
-with `HOMARR_AI_ALLOW_INSECURE_UPSTREAM=true`; do not use that setting with a real API key.
-
-The proxy overwrites client routing and generation limits. It requires OpenRouter zero-data-retention routing, denies
-data-collecting providers, limits responses to 32,768 completion tokens, and does not retain prompts, responses, or
-per-request telemetry. It accepts only uploaded image data, conservatively bounds text to the advertised context, and
-allows at most two concurrent requests per user and 100 across the service. Keep an OpenRouter account-level credit
-limit as the final monetary backstop because request quotas are not dollar accounting.
-
-Run `pnpm test:workshop` to test authentication, streaming, UTC reset, atomic per-user and global quota enforcement,
-failed-request accounting, identity attribution, server-selected model routing, function tools, input and output
-controls, privacy routing, spoofing resistance, absence of request logs, and migration rollback.
-
-An operator can explicitly smoke-test a deployed Workshop against its real configured upstream with a dedicated,
-low-quota test user:
-
-```sh
-HOMARR_AI_LIVE_SMOKE=1 \
-WORKSHOP_LIVE_TEST_URL=https://workshop.example.com \
-WORKSHOP_LIVE_TEST_TOKEN=<temporary-pocketbase-user-token> \
-pnpm test:workshop-live-provider
-```
-
-This optional check consumes one provider request. The test client needs neither the OpenRouter key nor the private
-upstream model ID. Do not run it in CI or with a normal user's Workshop token.
-
-The Custom Widget AI tests can use this proxy. Set `AI_PROVIDER_BASE_URL` to the `/api/ai/v1` endpoint and
-`AI_PROVIDER_API_KEY` to a temporary Workshop user token. See
-[Agent authoring](../management/custom-widgets/agent-authoring#evaluate-the-copied-prompt) for the command.
-
-## Staging and demo deployment
-
-Use `apps/workshop/docker-compose.staging.yml` with the published `ghcr.io/homarr-labs/workshop:v2` image for a v2
-preview. Copy `apps/workshop/.env.staging.example` to `.env.staging`; its default public contract is:
-
-```dotenv
-HOMARR_WEBSITE_URL=https://v2.preview.homarr.dev
-WORKSHOP_API_URL=https://v2.preview.homarr.dev
-WORKSHOP_WEB_URL=https://v2.preview.homarr.dev/workshop
-WORKSHOP_PUBLIC_ORIGIN=https://v2.preview.homarr.dev
-PB_ALLOWED_ORIGINS=*
-```
-
-Start or update it from the repository root:
-
-```sh
-docker compose --env-file apps/workshop/.env.staging \
-  -f apps/workshop/docker-compose.staging.yml pull
-docker compose --env-file apps/workshop/.env.staging \
-  -f apps/workshop/docker-compose.staging.yml up --detach
-curl --fail http://127.0.0.1:8090/api/health
-```
-
-The service binds to `127.0.0.1:8090`. Terminate TLS at a reverse proxy and forward the **entire hostname**, including
-`/api`, `/_/`, and `/workshop-runtime-config.js`; forwarding only `/workshop` breaks PocketBase and runtime URL loading.
-This combined image serves both the documentation site and PocketBase, so use a dedicated Workshop hostname if the
-chosen hostname already serves Homarr itself. In that case, replace the hostname in all four URL values and keep
-`/workshop` only on `WORKSHOP_WEB_URL`.
-
-The Compose volume preserves PocketBase data across pulls and container recreation. The mutable `v2` tag is suitable
-for previews; use the `sha-<commit>` tag for promotion. For the public central Workshop, `PB_ALLOWED_ORIGINS=*` allows
-self-hosted Homarr origins to use the API and OAuth. A private demo may use a comma-separated origin allowlist instead.
-GitHub OAuth requires both credentials and the callback `https://v2.preview.homarr.dev/api/oauth2-redirect`. Restart
-after changing environment values, then verify the health endpoint, `/workshop`, a public listing request, GitHub
-sign-in, and an installation from the Homarr preview.
-
-Back up application and PocketBase data before deployment. Publish the combined image by immutable digest, test the
-exact digest in staging, rehearse application rollback and PocketBase restore, then promote that same digest.
-
-## Client architecture
-
-Workshop access is centralized in `@homarr/workshop/backend`. It exports the typed `WorkshopBackend`, its typed
-PocketBase instance, stable TanStack Query option factories, and the `useWorkshop…` query and mutation hooks used by
-Homarr. The documentation site uses the same backend rather than maintaining a second API contract.
-
-Listing fields derived by the `workshop_listings` view—such as submission type, score, and counts—are normalized by the
-shared client. Healthy deployments keep filtering, sorting, and pagination in PocketBase. If a persistent development
-volume still has an older view that rejects those fields, the client retries without them and applies the same
-operations locally; it can also fall back to the base submissions collection. Production deployments should
-nevertheless apply the current migration so the view exposes the complete metadata.

apps/docs/docusaurus.config.ts

@@ -362,7 +362,7 @@ html[data-workshop-detail-loading] #workshop-detail-route-fallback {
   box-sizing: border-box;
   color: #4b5563;
   display: flex;
-  font: 500 0.875rem/1.5 "Work Sans", system-ui, sans-serif;
+  font: 500 0.875rem/1.5 Inter, system-ui, sans-serif;
   justify-content: center;
   min-height: 100vh;
   padding: 2rem;

apps/docs/package.json

@@ -51,6 +51,7 @@
     "postcss": "^8.5.16",
     "posthog-docusaurus": "^2.0.5",
     "prism-react-renderer": "^2.4.1",
+    "random-word-slugs": "^0.1.7",
     "react": "catalog:",
     "react-day-picker": "catalog:",
     "react-dom": "catalog:",

apps/docs/src/components/assistant-provider/open-collective-link.module.css

@@ -1,41 +0,0 @@
-.link {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.5rem;
-  padding: 0.45rem 0.7rem;
-  border: 1px solid var(--ifm-color-emphasis-300);
-  border-radius: 0.5rem;
-  background: var(--ifm-background-surface-color);
-  color: var(--ifm-font-color-base);
-  font-size: 0.875rem;
-  font-weight: 600;
-  line-height: 1.25;
-  text-decoration: none;
-  transition:
-    background-color 150ms ease,
-    border-color 150ms ease;
-}
-
-.link:hover {
-  border-color: var(--ifm-color-emphasis-500);
-  background: var(--ifm-color-emphasis-100);
-  color: var(--ifm-font-color-base);
-  text-decoration: none;
-}
-
-.link:focus-visible {
-  outline: 2px solid var(--ifm-color-primary);
-  outline-offset: 2px;
-}
-
-.logo {
-  width: 1.1rem;
-  height: 1.1rem;
-  flex: 0 0 auto;
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .link {
-    transition: none;
-  }
-}

apps/docs/src/components/assistant-provider/open-collective-link.tsx

@@ -1,10 +0,0 @@
-import Translate from "@docusaurus/Translate";
-
-import styles from "./open-collective-link.module.css";
-
-export const OpenCollectiveLink = () => (
-  <a className={styles.link} href="https://opencollective.com/homarr">
-    <img className={styles.logo} src="/img/opencollective.svg" alt="" aria-hidden />
-    <Translate id="workshop.provider.donate">Donate to Homarr on OpenCollective</Translate>
-  </a>
-);

apps/docs/src/components/pages/home/hero/hero-cards.tsx

@@ -1,100 +1,22 @@
-import { translate } from "@docusaurus/Translate";
-import { IconBrandDocker, IconCpu, IconDeviceDesktopAnalytics } from "@tabler/icons-react";
-
-import styles from "../../../../pages/index.module.css";
 import { AppWidget } from "./widgets/app-widget";
 import { ClockWidget } from "./widgets/clock-widget";
 import { DownloadsWidget } from "./widgets/downloads-widget";
-import { EntityStateWidget } from "./widgets/entity-state-widget";
-import { StockWidget } from "./widgets/stock-widget";
 import { WeatherWidget } from "./widgets/weather-widget";
-import { WidgetCard } from "./widgets/card";
+import { StockWidget } from "./widgets/stock-widget";
+import { EntityStateWidget } from "./widgets/entity-state-widget";
 
 export const HeroCards = () => {
   return (
-    <div className={`argos-ignore hero-cards ${styles.heroCards}`}>
+    <div className="argos-ignore hero-cards flex flex-wrap max-w-[504px] gap-y-4 gap-x-3 text-gray-700 dark:text-gray-300">
       <StockWidget />
-      <AppWidget name="Plex" />
-      <AppWidget name="Jellyfin" />
-      <AppWidget name="Homeassistant" label="Home Assistant" />
-      <ClockWidget />
-      <SystemResourcesWidget />
+      <AppWidget />
+      <AppWidget className="hidden 3xl:block" />
       <WeatherWidget />
-      <EntityStateWidget />
-      <AppWidget name="PiHole" label="Pi-hole" />
-      <AppWidget name="qBittorrent" />
       <DownloadsWidget />
-      <DockerWidget />
-      <AppWidget name="Sonarr" />
-      <AppWidget name="Radarr" />
+      <EntityStateWidget />
+      <AppWidget />
+
+      <ClockWidget />
     </div>
   );
 };
-
-const heroLabels = {
-  systemResources: translate({ id: "homepage.preview.systemResources", message: "System resources" }),
-  online: translate({ id: "homepage.preview.online", message: "Online" }),
-  cpu: translate({ id: "homepage.preview.cpu", message: "CPU" }),
-  memory: translate({ id: "homepage.preview.memory", message: "Memory" }),
-  disk: translate({ id: "homepage.preview.disk", message: "Disk" }),
-  docker: translate({ id: "homepage.preview.docker", message: "Docker" }),
-  dockerSummary: translate({ id: "homepage.preview.dockerSummary", message: "2 running · 1 failed" }),
-  healthy: translate({ id: "homepage.preview.healthy", message: "Healthy" }),
-  running: translate({ id: "homepage.preview.running", message: "Running" }),
-  exited: translate({ id: "homepage.preview.exited", message: "Exited" }),
-};
-
-const SystemResourcesWidget = () => (
-  <WidgetCard width={2} className={styles.resourcesWidget}>
-    <div className={styles.widgetHeading}>
-      <span className={styles.widgetTitle}>
-        <IconDeviceDesktopAnalytics size={17} aria-hidden="true" />
-        {heroLabels.systemResources}
-      </span>
-      <span className={styles.onlineStatus}>{heroLabels.online}</span>
-    </div>
-    <ResourceMeter icon={<IconCpu size={15} aria-hidden="true" />} label={heroLabels.cpu} value={34} />
-    <ResourceMeter label={heroLabels.memory} value={62} />
-    <ResourceMeter label={heroLabels.disk} value={98} />
-  </WidgetCard>
-);
-
-const ResourceMeter = ({ icon, label, value }: { icon?: React.ReactNode; label: string; value: number }) => (
-  <div className={`${styles.resourceMeter} ${value >= 90 ? styles.resourceMeterCritical : ""}`}>
-    <div className={styles.resourceLabel}>
-      <span>
-        {icon}
-        {label}
-      </span>
-      <span>{value}%</span>
-    </div>
-    <progress className={styles.resourceTrack} aria-label={`${label} usage`} max={100} value={value} />
-  </div>
-);
-
-const DockerWidget = () => (
-  <WidgetCard width={2} className={styles.dockerWidget}>
-    <div className={styles.widgetHeading}>
-      <span className={styles.widgetTitle}>
-        <IconBrandDocker size={18} aria-hidden="true" />
-        {heroLabels.docker}
-      </span>
-      <span className={styles.dockerCount}>{heroLabels.dockerSummary}</span>
-    </div>
-    <div className={styles.containerList}>
-      {[
-        { name: "immich", status: heroLabels.healthy, failed: false },
-        { name: "jellyfin", status: heroLabels.running, failed: false },
-        { name: "paperless", status: heroLabels.exited, failed: true },
-      ].map(({ name, status, failed }) => (
-        <div className={`${styles.containerRow} ${failed ? styles.containerRowFailed : ""}`} key={name}>
-          <span className={styles.containerName}>{name}</span>
-          <span className={styles.containerStatus}>
-            <span className={`${styles.statusDot} ${failed ? styles.statusDotFailed : ""}`} aria-hidden="true" />
-            {status}
-          </span>
-        </div>
-      ))}
-    </div>
-  </WidgetCard>
-);

apps/docs/src/components/pages/home/hero/hero.tsx

@@ -1,5 +1,4 @@
 import Link from "@docusaurus/Link";
-import { translate } from "@docusaurus/Translate";
 import { IconDownload, IconExternalLink } from "@tabler/icons-react";
 import clsx from "clsx";
 import styles from "../../../../pages/index.module.css";
@@ -8,9 +7,9 @@ import { HeroCards } from "./hero-cards";
 export default function HomeHero() {
   return (
     <header className={clsx("hero hero--primary", styles.heroBanner, styles.hero)}>
-      <div className={styles.heroContent}>
-        <div className={styles.heroCopy}>
-          <h1 className={clsx("font-extrabold lg:text-7xl text-3xl", styles.heroTitle)}>
+      <div className="flex">
+        <div className="ps-0 lg:ps-52">
+          <h1 className="font-extrabold lg:text-7xl text-3xl">
             A simple, yet
             <br />
             powerful dashboard
@@ -23,7 +22,7 @@ export default function HomeHero() {
             information.
           </p>
 
-          <div className={styles.heroActions}>
+          <div className={"flex flex-nowrap gap-2"}>
             <Link
               data-attr="Install button"
               className={"button button--secondary button--lg rounded-3xl dark:border-zinc-600 dark:bg-zinc-800"}
@@ -58,12 +57,9 @@ export default function HomeHero() {
             </Link>
           </div>
         </div>
-        <section
-          className={clsx(styles.heroPreview, "hover-animation")}
-          aria-label={translate({ id: "homepage.preview.label", message: "Example Homarr dashboard" })}
-        >
+        <div className="flex-grow-1 w-full lg:block hidden hover-animation">
           <HeroCards />
-        </section>
+        </div>
       </div>
     </header>
   );

apps/docs/src/components/pages/home/hero/widgets/app-widget.tsx

@@ -1,21 +1,20 @@
 import { supportedIntegrations } from "@site/src/constants/supported-integrations";
 import { CommonWidgetProps, WidgetCard } from "./card";
+import { getRndInteger } from "@site/src/tools/math";
 import clsx from "clsx";
 
-interface AppWidgetProps extends CommonWidgetProps {
-  name: string;
-  label?: string;
-}
-
-export const AppWidget = ({ name, label, className }: AppWidgetProps) => {
-  const app = supportedIntegrations.find((integration) => integration.name === name);
-  if (!app) return null;
+export const AppWidget = ({ className }: CommonWidgetProps) => {
+  const randomApp = supportedIntegrations[getRndInteger(0, supportedIntegrations.length - 1)];
 
   return (
-    <WidgetCard width={1} className={clsx("app-card text-center", className)}>
-      <span className={"text-sm font-bold"}>{label ?? app.name}</span>
-      <img src={app.iconUrl} className="aspect-square scale-[0.6]" alt="" />
-      <div className="absolute bottom-3 right-3 rounded-full bg-green-500 w-2 h-2" aria-hidden="true" />
+    <WidgetCard width={1} className={clsx("text-center", className)}>
+      <span className={"text-sm font-bold"}>{randomApp.name}</span>
+      <img
+        src={randomApp.iconUrl}
+        className="aspect-square scale-[0.6] transition-transform"
+        alt={`${randomApp.name} Icon`}
+      />
+      <div className="absolute bottom-3 right-3 rounded-full bg-green-500 w-2 h-2"></div>
     </WidgetCard>
   );
 };

apps/docs/src/components/pages/home/hero/widgets/card.tsx

@@ -1,6 +1,5 @@
 import clsx from "clsx";
 import { ReactNode } from "react";
-import styles from "../../../../../pages/index.module.css";
 
 export interface CommonWidgetProps {
   className?: string;
@@ -17,13 +16,15 @@ export const WidgetCard = ({ width, children, className, onClick }: WidgetCardPr
   return (
     <Component
       className={clsx(
-        styles.widgetCard,
-        "flex flex-col justify-center items-center p-2 relative border-none bg-[var(--ifm-navbar-background-color)]",
+        "rounded-xl flex flex-col justify-center items-center p-2 relative border-none bg-[var(--ifm-navbar-background-color)]",
         className,
         onClick ? "cursor-pointer" : undefined,
       )}
-      style={{ width: (128 * width + (width === 2 ? 16 : 0)) * 0.9, height: 128 }}
-      type={onClick ? "button" : undefined}
+      style={{
+        width: (128 * width + (width === 2 ? 16 : 0)) * 0.9,
+        height: 128,
+        background: "rgb(from var(--ifm-navbar-background-color) r g b / 80%)",
+      }}
       onClick={onClick}
     >
       {children}

apps/docs/src/components/pages/home/hero/widgets/downloads-widget.tsx

@@ -1,40 +1,26 @@
-import { translate } from "@docusaurus/Translate";
+import { getRndInteger } from "@site/src/tools/math";
 import { useEffect, useState } from "react";
 import { CommonWidgetProps, WidgetCard } from "./card";
 import clsx from "clsx";
-import styles from "../../../../../pages/index.module.css";
-
-const downloadQueue = ["family-photos.zip", "linux-isos.mkv", "server-backup.zip", "holiday-video.mp4"];
-const downloadLabels = {
-  file: translate({ id: "homepage.preview.file", message: "File" }),
-  progress: translate({ id: "homepage.preview.progress", message: "Progress" }),
-};
+import { generateSlug } from "random-word-slugs";
 
 export const DownloadsWidget = ({ className }: CommonWidgetProps) => {
-  const [downloads, setDownloads] = useState<Download[]>([
-    { filename: "photos-backup.zip", progress: 72 },
-    { filename: "media-library.mkv", progress: 38 },
-  ]);
+  const [downloads, setDownloads] = useState<Download[]>([]);
 
   useEffect(() => {
     const intervalId = setInterval(() => {
       setDownloads((prev: Download[]) => {
         const filteredPrev = prev.filter((download) => download.progress !== 100);
 
-        const progressedDownloads = filteredPrev.map((download, index) => ({
-          ...download,
-          progress: Math.min(100, download.progress + (index < 2 ? 8 : 4)),
-        }));
+        filteredPrev.forEach((download, index) => {
+          download.progress = Math.min(100, download.progress + getRndInteger(0, index < 2 ? 16 : 8));
+        });
 
-        if (progressedDownloads.length < 3 && progressedDownloads.length === prev.length) {
-          const availableDownloads = downloadQueue.filter(
-            (filename) => !progressedDownloads.some((download) => download.filename === filename),
-          );
-          const filename = availableDownloads[0];
-          if (filename) progressedDownloads.push({ filename, progress: 0 });
+        if (filteredPrev.length < 3 && filteredPrev.length === prev.length) {
+          filteredPrev.push(generateRandomDownload());
         }
 
-        return progressedDownloads;
+        return [...filteredPrev];
       });
     }, 500);
 
@@ -48,31 +34,19 @@ export const DownloadsWidget = ({ className }: CommonWidgetProps) => {
       <table className="mb-0 w-full h-full text-xs">
         <thead className="inline-block w-full">
           <tr className="inline-block w-full">
-            <th className="border-none px-2 py-1 text-start inline-block w-1/2">{downloadLabels.file}</th>
-            <th className="border-none px-2 py-1 text-start inline-block w-1/2">{downloadLabels.progress}</th>
+            <th className="border-none px-2 py-1 text-start inline-block w-1/2">File</th>
+            <th className="border-none px-2 py-1 text-start inline-block w-1/2">Progress</th>
           </tr>
         </thead>
         <tbody>
-          {downloads.map((file: Download) => {
+          {downloads.map((file: Download, index: number) => {
             return (
-              <tr key={file.filename}>
+              <tr key={index}>
                 <td className="border-none text-nowrap p-2">{file.filename}</td>
-                <td
-                  className="border-none p-2 w-full"
-                  aria-label={translate(
-                    { id: "homepage.preview.downloadComplete", message: "{progress}% complete" },
-                    { progress: file.progress },
-                  )}
-                >
-                  <progress
-                    className={styles.downloadProgress}
-                    value={file.progress}
-                    max={100}
-                    aria-label={translate(
-                      { id: "homepage.preview.downloadProgress", message: "{filename} download progress" },
-                      { filename: file.filename },
-                    )}
-                  />
+                <td className="border-none p-2 w-full">
+                  <div className="overflow-hidden rounded-xl h-2 w-full bg-zinc-600">
+                    <div className="bg-green-600 h-full animated-width" style={{ width: `${file.progress}%` }}></div>
+                  </div>
                 </td>
               </tr>
             );
@@ -87,3 +61,15 @@ interface Download {
   filename: string;
   progress: number;
 }
+
+const formats = ["mkv", "mp4"];
+
+const generateRandomDownload = (): Download => {
+  const randomMovie = generateSlug(2);
+  const randomFormat = formats[getRndInteger(0, formats.length - 1)];
+
+  return {
+    filename: `${randomMovie}.${randomFormat}`,
+    progress: 0,
+  };
+};

apps/docs/src/components/pages/home/hero/widgets/stock-widget.tsx

@@ -27,7 +27,6 @@ export const StockWidget = ({ className }: CommonWidgetProps) => {
         HOMR
       </div>
       <Line
-        ariaLabel="Simulated HOMR stock price trend"
         height={128}
         width={244}
         colors={[upwardTrend ? "green" : "red"]}

apps/docs/src/components/workshop/DetailPage.tsx

@@ -758,7 +758,7 @@ const MarketplaceDetail = ({ workshopUrl }: { workshopUrl: string }) => {
               </div>
             </div>
             <Link
-              to="/docs/workshop/"
+              to="/docs/management/workshop/"
               className="mt-4 inline-flex items-center gap-1.5 text-sm font-medium text-primary hover:underline"
             >
               Installation guide <IconExternalLink size={13} />

apps/docs/src/css/custom.css

@@ -1,4 +1,4 @@
-@import "https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&family=Work+Sans:wght@400;500;600;700&display=swap";
+@import url("https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap");
 @import "tailwindcss/theme" layer(theme);
 @import "tailwindcss/utilities" layer(utilities);
 
@@ -10,7 +10,7 @@
   --breakpoint-3xl: 1697px;
 
   --font-heading: var(--font-sans);
-  --font-sans: "Work Sans", sans-serif;
+  --font-sans: "Inter", sans-serif;
 
   --color-background: var(--background);
   --color-foreground: var(--foreground);
@@ -137,7 +137,7 @@
   --sidebar-border: oklch(0.9276 0.0058 264.5313);
   --sidebar-ring: oklch(0.56 0.205 25.6509);
   --destructive-foreground: oklch(0.9851 0 0);
-  --font-sans: "Work Sans", sans-serif;
+  --font-sans: "Inter", sans-serif;
   --font-serif: Georgia, serif;
   --font-mono: "JetBrains Mono", monospace;
   --shadow-color: #000000;
@@ -491,10 +491,6 @@ html[data-theme="dark"] div#__docusaurus div[role="banner"] button svg {
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .hover-animation {
-    animation: none;
-  }
-
   .submit-step-enter {
     animation: none;
   }
@@ -545,7 +541,7 @@ html[data-theme="dark"] div#__docusaurus div[role="banner"] button svg {
   --sidebar-accent-foreground: oklch(0.6646 0.2222 25.6509);
   --sidebar-border: oklch(0.2739 0.0055 286.0326);
   --sidebar-ring: oklch(0.72 0.16 25.6509);
-  --font-sans: "Work Sans", sans-serif;
+  --font-sans: "Inter", sans-serif;
   --font-serif: Georgia, serif;
   --font-mono: "JetBrains Mono", monospace;
   --shadow-color: #000000;

apps/docs/src/pages/index.module.css

@@ -28,260 +28,13 @@ section {
 }
 
 .heroBanner {
-  padding: clamp(3rem, 6vw, 6rem) clamp(1.25rem, 4vw, 4rem);
+  padding: 4rem;
   position: relative;
   overflow: hidden;
 }
 
-.heroContent {
-  display: grid;
-  grid-template-columns: minmax(25rem, 1fr) minmax(44rem, 48rem);
-  align-items: center;
-  gap: clamp(1rem, 3vw, 3rem);
-  max-width: 108rem;
-  margin-inline: auto;
-}
-
-.heroCopy {
-  max-width: 52rem;
-}
-
-.heroTitle {
-  text-wrap: balance;
-}
-
-.heroActions {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.5rem;
-}
-
-.heroPreview {
-  min-width: 0;
-}
-
-.heroCards {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 1rem 0.75rem;
-  width: min(100%, 48rem);
-  margin-inline: auto;
-  color: #343a40;
-}
-
-:global([data-theme="dark"]) .heroCards {
-  color: #dee2e6;
-}
-
-.widgetCard {
-  flex: none;
-  min-width: 0;
-  border-radius: 0.75rem;
-  border: 1px solid color-mix(in srgb, currentcolor 12%, transparent) !important;
-  color: inherit;
-  font: inherit;
-  background: color-mix(in srgb, var(--ifm-navbar-background-color) 76%, transparent) !important;
-  backdrop-filter: blur(12px);
-  box-shadow: 0 12px 28px rgb(31 41 55 / 14%);
-}
-
-.resourcesWidget,
-.dockerWidget {
-  align-items: stretch !important;
-  justify-content: flex-start !important;
-  gap: 0.5rem;
-  padding: 0.75rem !important;
-}
-
-.widgetHeading,
-.resourceLabel,
-.containerRow {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 0.5rem;
-}
-
-.widgetTitle {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.375rem;
-  min-width: 0;
-  font-size: 0.8125rem;
-  font-weight: 700;
-}
-
-.onlineStatus,
-.dockerCount {
-  flex: none;
-  font-size: 0.6875rem;
-  font-weight: 600;
-}
-
-.onlineStatus {
-  color: #087f5b;
-}
-
-:global([data-theme="dark"]) .onlineStatus {
-  color: #69dbb1;
-}
-
-.resourceMeter {
-  display: grid;
-  gap: 0.25rem;
-}
-
-.resourceMeterCritical .resourceLabel {
-  color: #a51111;
-  font-weight: 700;
-}
-
-.resourceLabel {
-  font-size: 0.6875rem;
-}
-
-.resourceLabel > span:first-child {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.25rem;
-}
-
-.resourceTrack {
-  display: block;
-  appearance: none;
-  overflow: hidden;
-  width: 100%;
-  height: 0.375rem;
-  border: 0;
-  border-radius: 999px;
-  background: color-mix(in srgb, currentcolor 16%, transparent);
-}
-
-.resourceTrack::-webkit-progress-bar {
-  background: transparent;
-}
-
-.resourceTrack::-webkit-progress-value,
-.resourceTrack::-moz-progress-bar {
-  height: 100%;
-  border-radius: inherit;
-  background: var(--ifm-color-primary);
-}
-
-.resourceMeterCritical .resourceTrack::-webkit-progress-value,
-.resourceMeterCritical .resourceTrack::-moz-progress-bar {
-  background: #e03131;
-}
-
-.downloadProgress {
-  display: block;
-  appearance: none;
-  overflow: hidden;
-  width: 100%;
-  height: 0.5rem;
-  border: 0;
-  border-radius: 999px;
-  background: color-mix(in srgb, currentcolor 18%, transparent);
-}
-
-.downloadProgress::-webkit-progress-bar {
-  background: transparent;
-}
-
-.downloadProgress::-webkit-progress-value,
-.downloadProgress::-moz-progress-bar {
-  border-radius: inherit;
-  background: #2f9e44;
-}
-
-.containerList {
-  display: grid;
-  gap: 0.25rem;
-}
-
-.containerRow {
-  font-size: 0.6875rem;
-  line-height: 1.25;
-}
-
-.containerName {
-  overflow: hidden;
-  font-weight: 600;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.containerStatus {
-  display: inline-flex;
-  align-items: center;
-  gap: 0.25rem;
-  color: color-mix(in srgb, currentcolor 82%, transparent);
-}
-
-.statusDot {
-  width: 0.375rem;
-  height: 0.375rem;
-  border-radius: 999px;
-  background: #12b886;
-}
-
-.containerRowFailed {
-  color: #a51111;
-  font-weight: 700;
-}
-
-:global([data-theme="dark"]) .resourceMeterCritical .resourceLabel,
-:global([data-theme="dark"]) .containerRowFailed {
-  color: #ffe3e3;
-}
-
-.statusDotFailed {
-  background: #fa5252;
-  animation: failed-container-pulse 1.4s ease-in-out infinite;
-}
-
-@keyframes failed-container-pulse {
-  50% {
-    opacity: 0.35;
-    transform: scale(1.65);
-  }
-}
-
-@media screen and (max-width: 1280px) {
-  .heroBanner {
-    padding: 3rem 1.5rem;
-  }
-
-  .heroContent {
-    grid-template-columns: minmax(0, 1fr);
-    gap: 2.5rem;
-  }
-
-  .heroCopy {
-    max-width: 46rem;
-  }
-
-  .heroCards {
-    width: min(100%, 48rem);
-  }
-}
-
 @media screen and (max-width: 996px) {
   .heroBanner {
-    padding: 2.5rem 1rem;
-  }
-
-  .heroPreview {
-    display: none;
-  }
-
-  .heroActions > :global(*) {
-    flex: 1 1 auto;
-  }
-}
-
-@media (prefers-reduced-motion: reduce) {
-  .statusDotFailed {
-    animation: none;
+    padding: 2rem;
   }
 }

apps/docs/src/tools/math.ts

@@ -0,0 +1,3 @@
+export function getRndInteger(min: number, max: number) {
+  return Math.round(Math.random() * (max - min)) + min;
+}

apps/docs/static/api/open-api-schema.json

@@ -1266,15 +1266,9 @@
                   "properties": {
                     "boardId": {
                       "type": "string"
-                    },
-                    "name": {
-                      "type": "string"
-                    },
-                    "layoutId": {
-                      "type": "string"
                     }
                   },
-                  "required": ["boardId", "name", "layoutId"],
+                  "required": ["boardId"],
                   "additionalProperties": false
                 }
               }
@@ -2158,7 +2152,6 @@
                       "beszelSystemStats",
                       "traefik",
                       "customApi",
-                      "assistant",
                       "wud"
                     ]
                   },
@@ -2172,7 +2165,6 @@
                   },
                   "integrationIds": {
                     "default": [],
-                    "maxItems": 32,
                     "type": "array",
                     "items": {
                       "type": "string"

apps/docs/static/img/opencollective.svg

@@ -1,7 +0,0 @@
-<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg">
-  <title>OpenCollective</title>
-  <path
-    fill="#7FADF2"
-    d="M12 0C5.373 0 0 5.373 0 12s5.373 12 12 12c2.54 0 4.894-.79 6.834-2.135l-3.107-3.109a7.715 7.715 0 1 1 0-13.512l3.107-3.109A11.943 11.943 0 0 0 12 0zm9.865 5.166-3.109 3.107A7.67 7.67 0 0 1 19.715 12a7.682 7.682 0 0 1-.959 3.727l3.109 3.107A11.943 11.943 0 0 0 24 12c0-2.54-.79-4.894-2.135-6.834z"
-  />
-</svg>

apps/nextjs/next.config.ts

@@ -46,7 +46,6 @@ const nextConfig: NextConfig = {
   serverExternalPackages: ["dockerode", "isomorphic-dompurify", "jsdom", "better-sqlite3"],
   experimental: {
     optimizePackageImports: ["@mantine/core", "@mantine/hooks", "@tabler/icons-react"],
-    preloadEntriesOnStart: false,
     turbopackFileSystemCacheForBuild: true,
     useTypeScriptCli: true,
   },

apps/nextjs/package.json

@@ -14,12 +14,6 @@
     "with-env": "dotenv -e ../../.env --"
   },
   "dependencies": {
-    "@ai-sdk/openai-compatible": "catalog:",
-    "@ai-sdk/react": "catalog:",
-    "@assistant-ui/react": "catalog:",
-    "@assistant-ui/react-ai-sdk": "catalog:",
-    "@assistant-ui/react-lexical": "catalog:",
-    "@assistant-ui/react-markdown": "catalog:",
     "@dnd-kit/abstract": "catalog:",
     "@dnd-kit/collision": "catalog:",
     "@dnd-kit/core": "catalog:",
@@ -48,7 +42,8 @@
     "@homarr/modals": "workspace:^0.1.0",
     "@homarr/modals-collection": "workspace:^0.1.0",
     "@homarr/notifications": "workspace:^0.1.0",
-    "@homarr/onboarding": "workspace:^0.1.0",
+    "@homarr/old-import": "workspace:^0.1.0",
+    "@homarr/old-schema": "workspace:^0.1.0",
     "@homarr/redis": "workspace:^0.1.0",
     "@homarr/server-settings": "workspace:^0.1.0",
     "@homarr/settings": "workspace:^0.1.0",
@@ -67,8 +62,7 @@
     "@mantine/hooks": "catalog:",
     "@mantine/modals": "catalog:",
     "@mantine/tiptap": "catalog:",
-    "@modelcontextprotocol/server": "catalog:",
-    "@rexa-developer/tiks": "catalog:",
+    "@modelcontextprotocol/sdk": "catalog:",
     "@scalar/api-reference-react": "catalog:",
     "@tabler/icons-react": "catalog:",
     "@tanstack/react-devtools": "catalog:",
@@ -83,8 +77,6 @@
     "@xterm/addon-fit": "catalog:",
     "@xterm/xterm": "catalog:",
     "adm-zip": "catalog:",
-    "ai": "catalog:",
-    "assistant-stream": "catalog:",
     "babel-plugin-react-compiler": "catalog:",
     "better-sqlite3": "catalog:",
     "chroma-js": "catalog:",
@@ -97,9 +89,10 @@
     "isomorphic-dompurify": "catalog:",
     "jotai": "catalog:",
     "jszip": "catalog:",
+    "lucide-react": "catalog:",
     "mantine-datatable": "catalog:",
     "mantine-react-table": "catalog:",
-    "mermaid": "catalog:",
+    "mcp-handler": "catalog:",
     "next": "catalog:",
     "postcss-preset-mantine": "catalog:",
     "posthog-js": "catalog:",
@@ -107,14 +100,11 @@
     "react": "catalog:",
     "react-dom": "catalog:",
     "react-error-boundary": "catalog:",
-    "react-shiki": "catalog:",
     "react-simple-code-editor": "catalog:",
-    "remark-breaks": "catalog:",
-    "remark-directive": "catalog:",
-    "remark-gfm": "catalog:",
     "sass": "catalog:",
     "sql.js": "catalog:",
     "superjson": "catalog:",
+    "trpc-to-mcp": "catalog:",
     "use-deep-compare-effect": "catalog:",
     "yaml": "catalog:",
     "zod": "catalog:"

apps/nextjs/src/app/.well-known/oauth-authorization-server/route.ts

@@ -22,7 +22,6 @@ export async function GET() {
       code_challenge_methods_supported: ["S256"],
       token_endpoint_auth_methods_supported: ["none"],
       scopes_supported: ["mcp:tools"],
-      resource_indicators_supported: true,
     },
     { headers: corsHeaders },
   );

apps/nextjs/src/app/.well-known/oauth-protected-resource/route.ts

@@ -13,7 +13,7 @@ export async function GET() {
 
   return Response.json(
     {
-      resource: `${baseUrl}/api/mcp`,
+      resource: baseUrl,
       authorization_servers: [baseUrl],
     },
     { headers: corsHeaders },

apps/nextjs/src/app/[locale]/auth/login/_login-form.tsx

@@ -4,7 +4,7 @@ import type { PropsWithChildren } from "react";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { useRouter, useSearchParams } from "next/navigation";
 import { Anchor, Button, Card, Code, Collapse, Divider, PasswordInput, Stack, Text, TextInput } from "@mantine/core";
-import { useDisclosure, useMounted } from "@mantine/hooks";
+import { useDisclosure } from "@mantine/hooks";
 import { z } from "zod/v4";
 
 import { signIn } from "@homarr/auth/client";
@@ -32,7 +32,6 @@ export const LoginForm = ({ providers, oidcClientName, isOidcAutoLoginEnabled, c
   const searchParams = useSearchParams();
   const isError = searchParams.has("error");
   const router = useRouter();
-  const isMounted = useMounted();
   const [isPending, setIsPending] = useState(false);
   const form = useZodForm(extendedValidation, {
     initialValues: {
@@ -133,7 +132,7 @@ export const LoginForm = ({ providers, oidcClientName, isOidcAutoLoginEnabled, c
 
                 {providers.includes("credentials") && (
                   <Stack gap="sm">
-                    <SubmitButton isMounted={isMounted} isPending={isPending} form={form} provider="credentials">
+                    <SubmitButton isPending={isPending} form={form} provider="credentials">
                       {t("action.login.label")}
                     </SubmitButton>
                     <PasswordForgottenCollapse username={form.values.name} />
@@ -141,7 +140,7 @@ export const LoginForm = ({ providers, oidcClientName, isOidcAutoLoginEnabled, c
                 )}
 
                 {providers.includes("ldap") && (
-                  <SubmitButton isMounted={isMounted} isPending={isPending} form={form} provider="ldap">
+                  <SubmitButton isPending={isPending} form={form} provider="ldap">
                     {t("action.login.labelWith", { provider: "LDAP" })}
                   </SubmitButton>
                 )}
@@ -152,7 +151,7 @@ export const LoginForm = ({ providers, oidcClientName, isOidcAutoLoginEnabled, c
         )}
 
         {providers.includes("oidc") && (
-          <Button fullWidth variant="light" disabled={!isMounted} onClick={async () => await signInAsync("oidc")}>
+          <Button fullWidth variant="light" onClick={async () => await signInAsync("oidc")}>
             {t("action.login.labelWith", { provider: oidcClientName })}
           </Button>
         )}
@@ -162,13 +161,12 @@ export const LoginForm = ({ providers, oidcClientName, isOidcAutoLoginEnabled, c
 };
 
 interface SubmitButtonProps {
-  isMounted: boolean;
   isPending: boolean;
   form: UseFormReturnType<FormType>;
   provider: "credentials" | "ldap";
 }
 
-const SubmitButton = ({ isMounted, isPending, form, provider, children }: PropsWithChildren<SubmitButtonProps>) => {
+const SubmitButton = ({ isPending, form, provider, children }: PropsWithChildren<SubmitButtonProps>) => {
   const isCurrentProviderActive = form.getValues().provider === provider;
 
   return (
@@ -178,7 +176,7 @@ const SubmitButton = ({ isMounted, isPending, form, provider, children }: PropsW
       fullWidth
       onClick={() => form.setFieldValue("provider", provider)}
       loading={isPending && isCurrentProviderActive}
-      disabled={!isMounted || (isPending && !isCurrentProviderActive)}
+      disabled={isPending && !isCurrentProviderActive}
     >
       {children}
     </Button>

apps/nextjs/src/app/[locale]/boards/(content)/_client.tsx

@@ -1,15 +1,12 @@
 "use client";
 
-import { Box, Paper, Stack, Text } from "@mantine/core";
+import { Box } from "@mantine/core";
 
-import { useCurrentLayout, useInitialViewportWidth, useLayoutOverride, useRequiredBoard } from "@homarr/boards/context";
+import { useCurrentLayout, useInitialViewportWidth, useRequiredBoard } from "@homarr/boards/context";
 import { useEditMode } from "@homarr/boards/edit-mode";
-import { getRepresentativeLayoutWidth } from "@homarr/boards/layout-preview";
 import { useScopedI18n } from "@homarr/translation/client";
 
 import { BoardAdvancedFocusProvider } from "~/components/board/advanced-focus/context";
-import { BoardEmptyState } from "~/components/board/board-empty-state";
-import { BoardSetupChecklist } from "~/components/board/board-setup-checklist";
 import {
   getBoardLaneColumnCount,
   getInitialBoardLogicalHeight,
@@ -30,11 +27,9 @@ const APP_SHELL_INLINE_PADDING = 32;
 export const ClientBoard = () => {
   const board = useRequiredBoard();
   const t = useScopedI18n("board.landmark");
-  const tPreview = useScopedI18n("board.setting.section.layout.preview");
   const [isEditMode] = useEditMode();
   const currentLayoutId = useCurrentLayout();
   const initialViewportWidth = useInitialViewportWidth();
-  const layoutOverrideId = useLayoutOverride();
   const currentLayout = board.layouts.find((layout) => layout.id === currentLayoutId) ?? board.layouts.at(0);
   if (!currentLayout) throw new Error("Expected the board to contain a layout");
 
@@ -52,8 +47,7 @@ export const ClientBoard = () => {
   const logicalWidth =
     laneWidths.reduce((total, width) => total + width, 0) + (laneWidths.length - 1) * LOGICAL_GRID_GAP;
   const initialLogicalHeight = getInitialBoardLogicalHeight(board, currentLayoutId) + LOGICAL_GRID_GAP;
-  const representativeWidth = layoutOverrideId ? getRepresentativeLayoutWidth(currentLayout, board.layouts) : null;
-  const initialAvailableWidth = Math.max(1, (representativeWidth ?? initialViewportWidth) - APP_SHELL_INLINE_PADDING);
+  const initialAvailableWidth = Math.max(1, initialViewportWidth - APP_SHELL_INLINE_PADDING);
   const gridTemplateColumns = [
     leftColumnCount > 0 ? `${getLogicalTrackSize(leftColumnCount)}px` : null,
     `${getLogicalTrackSize(mainColumnCount)}px`,
@@ -62,12 +56,10 @@ export const ClientBoard = () => {
     .filter((value) => value !== null)
     .join(" ");
 
-  const content = (
+  return (
     <BoardAdvancedFocusProvider>
       <Box h="100%" pos="relative" data-homarr-dev-benchmark-board>
         <BoardBackgroundVideo />
-        <BoardEmptyState />
-        <BoardSetupChecklist />
         <BoardSectionCollapseProvider>
           <BoardGridPortalHost>
             <ScaledBoardCanvas
@@ -129,24 +121,4 @@ export const ClientBoard = () => {
       </Box>
     </BoardAdvancedFocusProvider>
   );
-
-  if (representativeWidth === null) return content;
-
-  return (
-    <Stack align="center" gap="xs" p="md" mih="100%">
-      <Text size="xs" c="dimmed" fw={500}>
-        {tPreview("editorWidthLabel", { layoutName: currentLayout.name, width: representativeWidth })}
-      </Text>
-      <Paper
-        withBorder
-        shadow="sm"
-        radius="md"
-        w={`min(${representativeWidth}px, calc(100vw - 2rem))`}
-        mih="calc(100dvh - 8rem)"
-        style={{ overflow: "hidden" }}
-      >
-        {content}
-      </Paper>
-    </Stack>
-  );
 };

apps/nextjs/src/app/[locale]/boards/(content)/_creator.tsx

@@ -1,6 +1,5 @@
 import type { Metadata } from "next";
 import { cache } from "react";
-import { notFound, redirect } from "next/navigation";
 import { TRPCError } from "@trpc/server";
 
 import { dehydrate, HydrationBoundary } from "@tanstack/react-query";
@@ -44,28 +43,8 @@ export const createBoardContentPage = <TParams extends Record<string, unknown>>(
     page: async ({ params }: { params: Promise<TParams> }) => {
       const resolvedParams = await params;
       const queryClient = getQueryClient();
-      const session = await auth();
 
-      const board = await getInitialBoard(resolvedParams).catch((error) => {
-        if (error instanceof TRPCError && error.code === "NOT_FOUND") {
-          if (!session) {
-            logger.debug("No home board found for anonymous user, redirecting to login");
-            const requestedBoardName =
-              typeof resolvedParams.name === "string" ? `/boards/${encodeURIComponent(resolvedParams.name)}` : null;
-            redirect(
-              requestedBoardName ? `/auth/login?callbackUrl=${encodeURIComponent(requestedBoardName)}` : "/auth/login",
-            );
-          }
-
-          notFound();
-        }
-
-        if (error instanceof TRPCError && error.code === "BAD_REQUEST") {
-          notFound();
-        }
-
-        throw error;
-      });
+      const [board, session] = await Promise.all([getInitialBoard(resolvedParams), auth()]);
 
       const itemsMap = board.items.reduce((acc, item) => {
         const existing = acc.get(item.kind);
@@ -117,8 +96,8 @@ export const createBoardContentPage = <TParams extends Record<string, unknown>>(
           },
         };
       } catch (error) {
-        // Ignore not found and bad-request errors and return empty metadata
-        if (error instanceof TRPCError && (error.code === "NOT_FOUND" || error.code === "BAD_REQUEST")) {
+        // Ignore not found errors and return empty metadata
+        if (error instanceof TRPCError && error.code === "NOT_FOUND") {
           return {};
         }
 

apps/nextjs/src/app/[locale]/boards/(content)/_edit-actions.tsx

@@ -1,15 +1,18 @@
 "use client";
 
-import { useEffect, useRef } from "react";
-import { usePathname, useRouter, useSearchParams } from "next/navigation";
-import { IconPlus } from "@tabler/icons-react";
+import { Group, Menu } from "@mantine/core";
+import { IconBox, IconChevronDown, IconLayoutGridAdd, IconPlug, IconPlus, IconResize } from "@tabler/icons-react";
 
+import { useSession } from "@homarr/auth/client";
 import { useRequiredBoard } from "@homarr/boards/context";
 import { useModalAction } from "@homarr/modals";
+import { AppSelectModal } from "@homarr/modals-collection";
 import { useI18n } from "@homarr/translation/client";
 
-import { useBoardAddActions } from "~/components/board/use-board-add-actions";
-import { UniversalCreateModal } from "~/components/create/universal-create-modal";
+import { useItemActions } from "~/components/board/items/item-actions";
+import { ItemSelectModal } from "~/components/board/items/item-select-modal";
+import { useContainerActions } from "~/components/board/sections/container/container-actions";
+import { IntegrationSelectModal } from "~/components/integration/integration-select-modal";
 import { HeaderButton } from "~/components/layout/header/button";
 
 export default function BoardEditActions() {
@@ -17,41 +20,60 @@ export default function BoardEditActions() {
 }
 
 const AddMenu = () => {
+  const { data: session } = useSession();
   const board = useRequiredBoard();
-  const { addWidget, addApp, connectService, addContainer, canConnectService } = useBoardAddActions();
-  const { openModal } = useModalAction(UniversalCreateModal);
+  const { openModal: openItemSelectModal } = useModalAction(ItemSelectModal);
+  const { openModal: openAppSelectModal } = useModalAction(AppSelectModal);
+  const { openModal: openIntegrationSelectModal } = useModalAction(IntegrationSelectModal);
+  const { addContainer } = useContainerActions();
+  const { createItem } = useItemActions();
   const t = useI18n();
-  const pathname = usePathname();
-  const router = useRouter();
-  const searchParams = useSearchParams();
-  const handledInitialAdd = useRef(false);
 
-  useEffect(() => {
-    if (handledInitialAdd.current || searchParams.get("add") !== "true") return;
-    handledInitialAdd.current = true;
-    addWidget();
+  const handleSelectItem = () => {
+    openItemSelectModal({ boardId: board.id });
+  };
 
-    const nextSearchParams = new URLSearchParams(searchParams.toString());
-    nextSearchParams.delete("add");
-    const query = nextSearchParams.toString();
-    router.replace(query ? `${pathname}?${query}` : pathname, { scroll: false });
-  }, [addWidget, board.id, pathname, router, searchParams]);
+  const handleSelectApp = () => {
+    openAppSelectModal({
+      onSelect: (app) => {
+        createItem({
+          kind: "app",
+          options: { appId: app.id },
+        });
+      },
+      withCreate: session?.user.permissions.includes("app-create") ?? false,
+    });
+  };
+
+  const handleAddIntegration = () => {
+    openIntegrationSelectModal({});
+  };
 
   return (
-    <HeaderButton
-      aria-label={t("board.action.addContent")}
-      onClick={() =>
-        openModal({
-          boardActions: {
-            widget: addWidget,
-            app: addApp,
-            integration: canConnectService ? connectService : undefined,
-            container: addContainer,
-          },
-        })
-      }
-    >
-      <IconPlus stroke={1.5} />
-    </HeaderButton>
+    <Menu position="bottom-end">
+      <Menu.Target>
+        <HeaderButton w="auto" px={4} aria-label={t("board.action.addContent")}>
+          <Group gap={4} wrap="nowrap">
+            <IconPlus stroke={1.5} />
+            <IconChevronDown color="gray" size={16} />
+          </Group>
+        </HeaderButton>
+      </Menu.Target>
+      <Menu.Dropdown style={{ transform: "translate(-3px, 0)" }}>
+        <Menu.Item leftSection={<IconResize size={20} />} onClick={handleSelectItem}>
+          {t("item.action.create")}
+        </Menu.Item>
+        <Menu.Item leftSection={<IconBox size={20} />} onClick={handleSelectApp}>
+          {t("app.action.add")}
+        </Menu.Item>
+        <Menu.Item leftSection={<IconPlug size={20} />} onClick={handleAddIntegration}>
+          {t("integration.action.create")}
+        </Menu.Item>
+        <Menu.Divider />
+        <Menu.Item leftSection={<IconLayoutGridAdd size={20} />} onClick={addContainer}>
+          {t("section.container.action.create")}
+        </Menu.Item>
+      </Menu.Dropdown>
+    </Menu>
   );
 };

apps/nextjs/src/app/[locale]/boards/(content)/_header-actions.tsx

@@ -2,19 +2,10 @@
 
 import { startTransition, useCallback, useEffect, useRef, useState } from "react";
 import dynamic from "next/dynamic";
-import { useRouter, useSearchParams } from "next/navigation";
+import { useRouter } from "next/navigation";
 import { Box, Center, Loader, Menu, ScrollArea } from "@mantine/core";
 import { useHotkeys } from "@mantine/hooks";
-import { notifications } from "@mantine/notifications";
-import {
-  IconDeviceFloppy,
-  IconLayoutBoard,
-  IconPencil,
-  IconPencilOff,
-  IconReplace,
-  IconSettings,
-  IconX,
-} from "@tabler/icons-react";
+import { IconLayoutBoard, IconPencil, IconPencilOff, IconReplace, IconSettings } from "@tabler/icons-react";
 
 import { clientApi } from "@homarr/api/client";
 import { useRequiredBoard } from "@homarr/boards/context";
@@ -85,23 +76,12 @@ const EditModeMenu = ({ demoReadOnly }: { demoReadOnly: boolean }) => {
   const [isEnteringEditMode, setIsEnteringEditMode] = useState(false);
   const board = useRequiredBoard();
   const utils = clientApi.useUtils();
-  const router = useRouter();
-  const searchParams = useSearchParams();
-  const { openConfirmModal } = useConfirmModal();
-  const commonT = useI18n();
   const t = useScopedI18n("board.action.edit");
-  const returnToLayoutSettings =
-    isEditMode &&
-    searchParams.get("edit") === "true" &&
-    searchParams.get("layout") !== null &&
-    searchParams.get("returnTo") === "settings";
   const latestBoardRef = useRef(board);
 
   latestBoardRef.current = board;
+
   const { mutate: saveBoard, isPending } = clientApi.board.saveBoard.useMutation({
-    onMutate(boardToSave) {
-      boardToSave.items.forEach(({ id }) => notifications.hide(`board-item-created:${id}`));
-    },
     onSuccess() {
       showSuccessNotification({
         title: t("notification.success.title"),
@@ -111,7 +91,6 @@ const EditModeMenu = ({ demoReadOnly }: { demoReadOnly: boolean }) => {
       void utils.widget.customApi.getData.invalidate();
       void revalidatePathActionAsync(`/boards/${board.name}`);
       close();
-      if (returnToLayoutSettings) router.push(`/boards/${board.name}/settings?tab=layout`);
     },
     onError() {
       showErrorNotification({
@@ -176,45 +155,9 @@ const EditModeMenu = ({ demoReadOnly }: { demoReadOnly: boolean }) => {
     }
   }, [demoReadOnly, discardDemoChanges, isEditMode, open, prepareEditorAsync, saveBoard, t]);
 
-  const cancelLayoutEdit = useCallback(() => {
-    openConfirmModal({
-      title: commonT("board.setting.section.layout.edit.cancel.title"),
-      children: commonT("board.setting.section.layout.edit.cancel.message"),
-      confirmProps: { children: commonT("common.action.discard"), color: "red" },
-      onConfirm() {
-        void (async () => {
-          await utils.board.getBoardByName.invalidate({ name: board.name });
-          close();
-          router.push(`/boards/${board.name}/settings?tab=layout`);
-        })();
-      },
-    });
-  }, [board.name, close, commonT, openConfirmModal, router, utils.board.getBoardByName]);
-
   useHotkeys([[hotkeys.toggleBoardEdit, () => void toggle()]]);
   usePreventLeaveWithDirty(isEditMode);
 
-  if (returnToLayoutSettings) {
-    return (
-      <>
-        <HeaderButton
-          onClick={() => saveBoard(board)}
-          loading={isPending}
-          aria-label={commonT("board.setting.section.layout.edit.save")}
-        >
-          <IconDeviceFloppy stroke={1.5} />
-        </HeaderButton>
-        <HeaderButton
-          onClick={cancelLayoutEdit}
-          disabled={isPending}
-          aria-label={commonT("board.setting.section.layout.edit.cancel.action")}
-        >
-          <IconX stroke={1.5} />
-        </HeaderButton>
-      </>
-    );
-  }
-
   return (
     <TourTarget id="board-edit-mode">
       <HeaderButton

apps/nextjs/src/app/[locale]/boards/[name]/settings/_appereance.tsx

@@ -21,7 +21,6 @@ import { IconX } from "@tabler/icons-react";
 
 import type { UseFormReturnType } from "@homarr/form";
 import { useI18n } from "@homarr/translation/client";
-import { BoardColorInput } from "@homarr/ui";
 
 import { SectionCard } from "~/components/manage/section-card";
 import { generateColors } from "../../(content)/_theme";
@@ -45,11 +44,21 @@ export const ColorSettingsContent = ({ form }: Props) => {
       <Grid>
         <Grid.Col span={{ sm: 12, md: 6 }}>
           <Stack gap="xs">
-            <BoardColorInput label={t("board.field.primaryColor.label")} {...form.getInputProps("primaryColor")} />
+            <ColorInput
+              label={t("board.field.primaryColor.label")}
+              format="hex"
+              swatches={Object.values(theme.colors).map((color) => color[6])}
+              {...form.getInputProps("primaryColor")}
+            />
           </Stack>
         </Grid.Col>
         <Grid.Col span={{ sm: 12, md: 6 }}>
-          <BoardColorInput label={t("board.field.secondaryColor.label")} {...form.getInputProps("secondaryColor")} />
+          <ColorInput
+            label={t("board.field.secondaryColor.label")}
+            format="hex"
+            swatches={Object.values(theme.colors).map((color) => color[6])}
+            {...form.getInputProps("secondaryColor")}
+          />
         </Grid.Col>
         <Grid.Col span={12}>
           <Anchor onClick={toggle}>{showPreview ? t("common.preview.hide") : t("common.preview.show")}</Anchor>

apps/nextjs/src/app/[locale]/boards/[name]/settings/_layout-preview.module.css

@@ -1,70 +0,0 @@
-.canvas {
-  border: 1px solid var(--mantine-color-default-border);
-  border-radius: var(--mantine-radius-md);
-  background: color-mix(in srgb, var(--mantine-color-body) 82%, var(--mantine-primary-color-light));
-  padding: var(--mantine-spacing-xs);
-  min-height: 7rem;
-  max-height: min(18rem, 38dvh);
-  overflow-y: auto;
-  overscroll-behavior: contain;
-  scrollbar-gutter: stable;
-}
-
-.section {
-  border-radius: var(--mantine-radius-sm);
-  background: color-mix(in srgb, var(--mantine-color-default) 78%, transparent);
-  padding: 0.35rem;
-}
-
-.grid {
-  display: grid;
-  gap: 3px;
-  grid-auto-rows: clamp(1.35rem, 2.2vw, 1.75rem);
-  min-height: 2.5rem;
-}
-
-.tile {
-  container-type: inline-size;
-  min-width: 0;
-  overflow: hidden;
-  border: 1px solid color-mix(in srgb, var(--mantine-primary-color-filled) 24%, var(--mantine-color-default-border));
-  border-radius: calc(var(--mantine-radius-sm) * 0.75);
-  background: color-mix(in srgb, var(--mantine-primary-color-light) 70%, var(--mantine-color-body));
-  padding-inline: 0.25rem;
-}
-
-.tileContent {
-  justify-content: center;
-  width: 100%;
-  height: 100%;
-  overflow: hidden;
-}
-
-.tileLabel {
-  display: none;
-  min-width: 0;
-  max-height: 2.1em;
-  overflow: hidden;
-  overflow-wrap: anywhere;
-  line-height: 1.05;
-}
-
-@container (min-width: 9rem) {
-  .tileContent {
-    justify-content: flex-start;
-  }
-
-  .tileLabel {
-    display: block;
-  }
-}
-
-.containerTile {
-  border-style: dashed;
-  background: color-mix(in srgb, var(--mantine-color-default) 88%, var(--mantine-primary-color-light));
-}
-
-.appIcon {
-  width: 0.85rem;
-  height: 0.85rem;
-}

apps/nextjs/src/app/[locale]/boards/[name]/settings/_layout-preview.tsx

@@ -1,124 +0,0 @@
-"use client";
-
-import { Badge, Box, Group, Stack, Text, ThemeIcon, Tooltip } from "@mantine/core";
-import { IconLayoutGrid } from "@tabler/icons-react";
-
-import type { RouterOutputs } from "@homarr/api";
-import type { BoardPreviewLayout } from "@homarr/boards/layout-preview";
-import { getRepresentativeLayoutWidth, projectBoardLayout } from "@homarr/boards/layout-preview";
-import { getBoardLaneColumnCount, getRootSectionLane } from "@homarr/definitions";
-import { useI18n } from "@homarr/translation/client";
-import { MaskedOrNormalImage } from "@homarr/ui";
-import { widgetCatalogIcons } from "@homarr/widgets/catalog";
-
-import type { Board } from "../../_types";
-import classes from "./_layout-preview.module.css";
-
-interface Props {
-  board: Board;
-  layout: BoardPreviewLayout;
-  layouts: BoardPreviewLayout[];
-  sourceLayout: BoardPreviewLayout;
-  apps: RouterOutputs["app"]["byIds"];
-}
-
-export const LayoutPreview = ({ board, layout, layouts, sourceLayout, apps }: Props) => {
-  const t = useI18n();
-  const elements = projectBoardLayout(board, sourceLayout, layout);
-  const representativeWidth = getRepresentativeLayoutWidth(layout, layouts);
-  const largestRepresentativeWidth = Math.max(
-    ...layouts.map((candidate) => getRepresentativeLayoutWidth(candidate, layouts)),
-  );
-  const previewWidth = `${(representativeWidth / largestRepresentativeWidth) * 100}%`;
-  const appsById = new Map(apps.map((app) => [app.id, app]));
-  const rootSections = board.sections
-    .filter((section) => section.kind === "empty")
-    .toSorted((sectionA, sectionB) => sectionA.xOffset - sectionB.xOffset);
-
-  return (
-    <Stack gap={6} align="center" w="100%">
-      <Group gap="xs" justify="center">
-        <Badge variant="light" color={layout.role === "mobile" ? "teal" : layout.role === "base" ? "blue" : "gray"}>
-          {representativeWidth}px
-        </Badge>
-        <Text size="xs">
-          {layout.columnCount} {t("board.setting.section.layout.preview.columns")}
-        </Text>
-      </Group>
-      <Box w={{ base: "100%", md: `max(${previewWidth}, 14rem)` }} maw="100%" className={classes.canvas}>
-        {elements.length === 0 ? (
-          <Text size="xs" c="dimmed" ta="center" py="xl">
-            {t("board.setting.section.layout.preview.empty")}
-          </Text>
-        ) : (
-          <Stack gap="xs">
-            {rootSections.map((section) => {
-              const sectionElements = elements.filter((element) => element.sectionId === section.id);
-              const columnCount = getBoardLaneColumnCount(layout, getRootSectionLane(section.xOffset));
-              if (sectionElements.length === 0 || columnCount === 0) return null;
-
-              return (
-                <Stack key={section.id} gap={4} className={classes.section}>
-                  <Box
-                    className={classes.grid}
-                    style={{ gridTemplateColumns: `repeat(${columnCount}, minmax(0, 1fr))` }}
-                  >
-                    {sectionElements.map((element) => {
-                      const item =
-                        element.type === "item" ? board.items.find((candidate) => candidate.id === element.id) : null;
-                      const appId =
-                        item?.kind === "app" && typeof item.options.appId === "string" ? item.options.appId : null;
-                      const app = appId ? appsById.get(appId) : undefined;
-                      const container =
-                        element.type === "section"
-                          ? board.sections.find((candidate) => candidate.id === element.id)
-                          : undefined;
-                      const containerLabel =
-                        container?.kind === "container" && container.options.title
-                          ? container.options.title
-                          : t("section.container.untitled");
-                      const label = app?.name ?? (item ? t(`widget.${item.kind}.name`) : containerLabel);
-                      const WidgetIcon = item ? widgetCatalogIcons[item.kind] : IconLayoutGrid;
-
-                      return (
-                        <Tooltip key={`${element.type}-${element.id}`} label={label} openDelay={350}>
-                          <Box
-                            role="img"
-                            aria-label={label}
-                            className={`${classes.tile} ${element.type === "section" ? classes.containerTile : ""}`}
-                            style={{
-                              gridColumn: `${element.xOffset + 1} / span ${element.width}`,
-                              gridRow: `${element.yOffset + 1} / span ${element.height}`,
-                            }}
-                          >
-                            <Group gap={4} wrap="nowrap" className={classes.tileContent}>
-                              <ThemeIcon size="sm" variant="light" radius="sm" style={{ flexShrink: 0 }}>
-                                {app ? (
-                                  <MaskedOrNormalImage
-                                    imageUrl={app.iconUrl}
-                                    hasColor={false}
-                                    alt=""
-                                    className={classes.appIcon}
-                                  />
-                                ) : (
-                                  <WidgetIcon size={13} stroke={1.7} />
-                                )}
-                              </ThemeIcon>
-                              <Text component="span" size="xs" fw={500} className={classes.tileLabel}>
-                                {label}
-                              </Text>
-                            </Group>
-                          </Box>
-                        </Tooltip>
-                      );
-                    })}
-                  </Box>
-                </Stack>
-              );
-            })}
-          </Stack>
-        )}
-      </Box>
-    </Stack>
-  );
-};

apps/nextjs/src/app/[locale]/boards/[name]/settings/_layout.module.css

@@ -6,7 +6,7 @@
   display: grid;
   gap: 6px;
   width: 100%;
-  min-height: 88px;
+  min-height: 112px;
   padding: 8px;
   overflow: hidden;
   background: var(--mantine-color-body);

apps/nextjs/src/app/[locale]/boards/[name]/settings/_layout.tsx

@@ -1,9 +1,6 @@
 "use client";
 
-import { useMemo, useState } from "react";
-import { useRouter } from "next/navigation";
 import {
-  Badge,
   Box,
   Button,
   Fieldset,
@@ -18,295 +15,118 @@ import {
   Text,
   TextInput,
 } from "@mantine/core";
-import { IconEdit, IconRefresh } from "@tabler/icons-react";
 
-import { clientApi } from "@homarr/api/client";
 import { createId } from "@homarr/common";
 import type { UseFormReturnType } from "@homarr/form";
-import { useConfirmModal } from "@homarr/modals";
-import { showErrorNotification } from "@homarr/notifications";
 import { useI18n } from "@homarr/translation/client";
 
 import { SectionCard } from "~/components/manage/section-card";
-import type { Board } from "../../_types";
-import { LayoutPreview } from "./_layout-preview";
 import type { FormValues } from "./_settings-form";
 import classes from "./_layout.module.css";
 
 interface Props {
-  board: Board;
   form: UseFormReturnType<FormValues>;
-  isSaving: boolean;
-  saveSettingsAsync: () => Promise<FormValues | null>;
 }
 
-export const LayoutSettingsContent = ({ board, form, isSaving, saveSettingsAsync }: Props) => {
+export const LayoutSettingsContent = ({ form }: Props) => {
   const t = useI18n();
-  const router = useRouter();
-  const utils = clientApi.useUtils();
-  const { openConfirmModal } = useConfirmModal();
-  const [editingLayoutId, setEditingLayoutId] = useState<string | null>(null);
-  const [resettingLayoutId, setResettingLayoutId] = useState<string | null>(null);
-  const { mutateAsync: resetLayout } = clientApi.board.resetLayout.useMutation({
-    onError() {
-      showErrorNotification({
-        title: t("common.notification.update.error"),
-        message: t("common.notification.update.error"),
-      });
-    },
-  });
-  const appIds = useMemo(
-    () =>
-      Array.from(
-        new Set(
-          board.items.flatMap((item) =>
-            item.kind === "app" && typeof item.options.appId === "string" ? [item.options.appId] : [],
-          ),
-        ),
-      ),
-    [board.items],
-  );
-  const { data: apps = [] } = clientApi.app.byIds.useQuery(appIds, { enabled: appIds.length > 0 });
-
-  const openLayoutEditorAsync = async (layout: FormValues["layouts"][number]) => {
-    setEditingLayoutId(layout.id);
-    try {
-      const persistedLayout = board.layouts.find((candidate) => candidate.id === layout.id);
-      const savedValues = form.isDirty() || !persistedLayout ? await saveSettingsAsync() : form.values;
-      const canonicalLayout = savedValues ? findCanonicalLayout(savedValues.layouts, layout) : undefined;
-      if (!canonicalLayout) return;
-
-      router.push(`/boards/${board.name}?layout=${encodeURIComponent(canonicalLayout.id)}&edit=true&returnTo=settings`);
-    } finally {
-      setEditingLayoutId(null);
-    }
-  };
-
-  const confirmReset = (layout: FormValues["layouts"][number]) => {
-    openConfirmModal({
-      title: t("board.setting.section.layout.reset.confirm.title", { layoutName: layout.name }),
-      children: t("board.setting.section.layout.reset.confirm.message"),
-      confirmProps: { children: t("board.setting.section.layout.reset.action"), color: "red" },
-      onConfirm() {
-        setResettingLayoutId(layout.id);
-        void (async () => {
-          try {
-            const savedValues = form.isDirty() ? await saveSettingsAsync() : form.values;
-            const canonicalLayout = savedValues ? findCanonicalLayout(savedValues.layouts, layout) : undefined;
-            if (!canonicalLayout) return;
-
-            await resetLayout({ boardId: board.id, layoutId: canonicalLayout.id });
-            await utils.board.getBoardByName.invalidate({ name: board.name });
-            router.refresh();
-          } catch {
-            // The mutation callback displays the error notification.
-          } finally {
-            setResettingLayoutId(null);
-          }
-        })();
-      },
-    });
-  };
-
-  const nextBreakpoint = getNextCustomBreakpoint(form.values.layouts);
-  const baseLayout = form.values.layouts.find((layout) => layout.role === "base");
-  const sortedLayouts = form.values.layouts
-    .map((layout, index) => ({ layout, index }))
-    .toSorted((entryA, entryB) => entryA.layout.breakpoint - entryB.layout.breakpoint);
 
   return (
     <SectionCard title={t("board.setting.section.layout.title")}>
-      <Stack gap="lg">
-        <Group justify="space-between" align="flex-start" wrap="wrap">
-          <Stack gap={2} maw="52rem">
-            <Text fw={500}>{t("board.setting.section.layout.responsive.title")}</Text>
-            <Text size="sm">{t("board.setting.section.layout.responsive.description")}</Text>
-          </Stack>
+      <Stack gap="sm">
+        <Group justify="space-between" align="center">
+          <Text fw={500}>{t("board.setting.section.layout.responsive.title")}</Text>
           <Button
             type="button"
-            variant="light"
-            disabled={nextBreakpoint === null || !baseLayout}
+            variant="subtle"
             onClick={() => {
-              if (nextBreakpoint === null || !baseLayout) return;
-              form.setFieldValue("layouts", [
-                ...form.values.layouts,
-                {
-                  id: createId(),
-                  name: t("board.setting.section.layout.custom.defaultName"),
-                  columnCount: baseLayout.columnCount,
-                  leftGutterColumnCount: baseLayout.leftGutterColumnCount,
-                  rightGutterColumnCount: baseLayout.rightGutterColumnCount,
-                  breakpoint: nextBreakpoint,
-                  role: "custom",
-                },
-              ]);
+              form.setValues((previous) => ({
+                ...previous,
+                layouts: [
+                  ...(previous.layouts ?? []),
+                  {
+                    id: createId(),
+                    name: "",
+                    columnCount: 10,
+                    leftGutterColumnCount: 0,
+                    rightGutterColumnCount: 0,
+                    breakpoint: 0,
+                  },
+                ],
+              }));
             }}
           >
             {t("board.setting.section.layout.responsive.action.add")}
           </Button>
         </Group>
 
-        {sortedLayouts.map(({ layout, index }) => {
-          const persistedLayout = board.layouts.find((candidate) => candidate.id === layout.id);
-          const sourceLayout = persistedLayout ?? board.layouts.find((candidate) => candidate.role === "base");
-          const customBreakpoints = form.values.layouts
-            .filter((candidate) => candidate.role === "custom" && candidate.id !== layout.id)
-            .map((candidate) => candidate.breakpoint);
-          const baseBreakpoint = form.values.layouts.find((candidate) => candidate.role === "base")?.breakpoint ?? 768;
+        {form.values.layouts.map((layout, index) => (
+          <Fieldset key={layout.id} legend={layout.name} bg="transparent">
+            <Grid>
+              <Grid.Col span={{ sm: 12, md: 6 }}>
+                <TextInput {...form.getInputProps(`layouts.${index}.name`)} label={t("layout.field.name.label")} />
+              </Grid.Col>
 
-          return (
-            <Fieldset
-              key={layout.id}
-              legend={
-                <Group gap="xs">
-                  <Text>{layout.name || t(`board.setting.section.layout.role.${layout.role}`)}</Text>
-                  <Badge size="sm" variant="default">
-                    {t(`board.setting.section.layout.role.${layout.role}`)}
-                  </Badge>
-                </Group>
-              }
-              bg="transparent"
-            >
-              <Grid gap={{ base: "lg", xl: "xl" }} align="flex-start">
-                <Grid.Col span={{ base: 12, md: 6, lg: 4 }}>
-                  <Stack gap="md">
-                    <TextInput {...form.getInputProps(`layouts.${index}.name`)} label={t("layout.field.name.label")} />
-                    <Input.Wrapper label={t("layout.field.columnCount.label")}>
-                      <Slider
-                        thumbLabel={`${t("layout.field.columnCount.label")} — ${layout.name}`}
-                        mt="xs"
-                        min={1}
-                        max={24}
-                        step={1}
-                        marks={[1, 6, 12, 18, 24].map((value) => ({ value, label: String(value) }))}
-                        styles={{
-                          markLabel: { color: "light-dark(var(--mantine-color-black), var(--mantine-color-white))" },
-                        }}
-                        value={layout.columnCount}
-                        onChange={(columnCount) => {
-                          const left = Math.min(layout.leftGutterColumnCount, Math.max(0, columnCount - 1));
-                          const right = Math.min(layout.rightGutterColumnCount, Math.max(0, columnCount - left - 1));
-                          form.setFieldValue(`layouts.${index}.columnCount`, columnCount);
-                          form.setFieldValue(`layouts.${index}.leftGutterColumnCount`, left);
-                          form.setFieldValue(`layouts.${index}.rightGutterColumnCount`, right);
-                        }}
-                      />
-                    </Input.Wrapper>
-                    <NumberInput
-                      {...form.getInputProps(`layouts.${index}.breakpoint`)}
-                      label={t("layout.field.breakpoint.label")}
-                      description={
-                        layout.role === "mobile"
-                          ? t("board.setting.section.layout.mobile.breakpointDescription")
-                          : t("layout.field.breakpoint.description")
-                      }
-                      disabled={layout.role === "mobile"}
-                      styles={{ description: { color: "var(--mantine-color-text)" } }}
-                      min={
-                        layout.role === "base"
-                          ? Math.max(1, ...customBreakpoints.map((breakpoint) => breakpoint + 1))
-                          : 1
-                      }
-                      max={layout.role === "custom" ? baseBreakpoint - 1 : 32767}
-                    />
-                  </Stack>
-                </Grid.Col>
-                <Grid.Col span={{ base: 12, md: 6, lg: 4 }}>
-                  {sourceLayout && (
-                    <LayoutPreview
-                      board={board}
-                      layout={layout}
-                      layouts={form.values.layouts}
-                      sourceLayout={sourceLayout}
-                      apps={apps}
-                    />
-                  )}
-                </Grid.Col>
-                {layout.role !== "mobile" && (
-                  <Grid.Col span={{ base: 12, lg: 4 }}>
-                    <GutterSettings
-                      left={layout.leftGutterColumnCount}
-                      right={layout.rightGutterColumnCount}
-                      columnCount={layout.columnCount}
-                      onLeftChange={(value) => form.setFieldValue(`layouts.${index}.leftGutterColumnCount`, value)}
-                      onRightChange={(value) => form.setFieldValue(`layouts.${index}.rightGutterColumnCount`, value)}
-                    />
-                  </Grid.Col>
-                )}
-              </Grid>
+              <Grid.Col span={{ sm: 12, md: 6 }}>
+                <Input.Wrapper label={t("layout.field.columnCount.label")}>
+                  <Slider
+                    mt="xs"
+                    min={1}
+                    max={24}
+                    step={1}
+                    value={layout.columnCount}
+                    thumbLabel={t("layout.field.columnCount.label")}
+                    onChange={(columnCount) => {
+                      const left = Math.min(layout.leftGutterColumnCount, Math.max(0, columnCount - 1));
+                      const right = Math.min(layout.rightGutterColumnCount, Math.max(0, columnCount - left - 1));
+                      form.setFieldValue(`layouts.${index}.columnCount`, columnCount);
+                      form.setFieldValue(`layouts.${index}.leftGutterColumnCount`, left);
+                      form.setFieldValue(`layouts.${index}.rightGutterColumnCount`, right);
+                    }}
+                  />
+                </Input.Wrapper>
+              </Grid.Col>
 
-              <Group justify="space-between" mt="lg" gap="sm" wrap="wrap">
-                <Group gap="xs">
-                  {layout.role !== "base" && persistedLayout && (
-                    <Button
-                      type="button"
-                      variant="default"
-                      leftSection={<IconRefresh size={16} color="var(--mantine-color-red-5)" />}
-                      loading={resettingLayoutId === layout.id}
-                      disabled={isSaving}
-                      onClick={() => confirmReset(layout)}
-                    >
-                      {t("board.setting.section.layout.reset.action")}
-                    </Button>
-                  )}
-                  {layout.role === "custom" && (
-                    <Button
-                      type="button"
-                      variant="subtle"
-                      color="red"
-                      disabled={isSaving}
-                      onClick={() => {
-                        form.setFieldValue(
-                          "layouts",
-                          form.values.layouts.filter((candidate) => candidate.id !== layout.id),
-                        );
-                      }}
-                    >
-                      {t("common.action.remove")}
-                    </Button>
-                  )}
-                </Group>
+              <Grid.Col span={{ sm: 12, md: 6 }}>
+                <NumberInput
+                  {...form.getInputProps(`layouts.${index}.breakpoint`)}
+                  label={t("layout.field.breakpoint.label")}
+                  description={t("layout.field.breakpoint.description")}
+                />
+              </Grid.Col>
+              <Grid.Col span={12}>
+                <GutterSettings
+                  left={layout.leftGutterColumnCount}
+                  right={layout.rightGutterColumnCount}
+                  columnCount={layout.columnCount}
+                  onLeftChange={(value) => form.setFieldValue(`layouts.${index}.leftGutterColumnCount`, value)}
+                  onRightChange={(value) => form.setFieldValue(`layouts.${index}.rightGutterColumnCount`, value)}
+                />
+              </Grid.Col>
+            </Grid>
+            {form.values.layouts.length >= 2 && (
+              <Group justify="end">
                 <Button
                   type="button"
-                  variant="default"
-                  leftSection={<IconEdit size={16} color="var(--mantine-color-red-5)" />}
-                  loading={editingLayoutId === layout.id}
-                  disabled={isSaving || !form.isValid()}
-                  onClick={() => void openLayoutEditorAsync(layout)}
+                  variant="subtle"
+                  onClick={() => {
+                    form.setValues((previous) => ({
+                      ...previous,
+                      layouts: form.values.layouts.filter((filteredLayout) => filteredLayout.id !== layout.id),
+                    }));
+                  }}
                 >
-                  {form.isDirty() || !persistedLayout
-                    ? t("board.setting.section.layout.edit.saveAndEdit")
-                    : t("board.setting.section.layout.edit.action")}
+                  {t("common.action.remove")}
                 </Button>
               </Group>
-            </Fieldset>
-          );
-        })}
+            )}
+          </Fieldset>
+        ))}
       </Stack>
     </SectionCard>
   );
 };
 
-const findCanonicalLayout = (layouts: FormValues["layouts"], layout: FormValues["layouts"][number]) =>
-  layouts.find((candidate) => candidate.id === layout.id) ??
-  layouts.find((candidate) => candidate.breakpoint === layout.breakpoint && candidate.role === layout.role);
-
-const getNextCustomBreakpoint = (layouts: Array<{ breakpoint: number }>) => {
-  const sortedBreakpoints = layouts
-    .map((layout) => layout.breakpoint)
-    .toSorted((breakpointA, breakpointB) => breakpointA - breakpointB);
-  let largestGap: { start: number; end: number } | null = null;
-
-  for (let index = 0; index < sortedBreakpoints.length - 1; index++) {
-    const start = sortedBreakpoints[index];
-    const end = sortedBreakpoints[index + 1];
-    if (start === undefined || end === undefined || end - start <= 1) continue;
-    if (!largestGap || end - start > largestGap.end - largestGap.start) largestGap = { start, end };
-  }
-
-  return largestGap ? Math.floor((largestGap.start + largestGap.end) / 2) : null;
-};
-
 interface GutterSettingsProps {
   left: number;
   right: number;
@@ -338,7 +158,7 @@ const GutterSettings = ({ left, right, columnCount, onLeftChange, onRightChange
         <GutterPreview left={left} right={right} columnCount={columnCount} />
 
         <Grid>
-          <Grid.Col span={{ base: 12, sm: 6 }}>
+          <Grid.Col span={{ base: 12, md: 6 }}>
             <GutterControl
               side="left"
               value={left}
@@ -346,7 +166,7 @@ const GutterSettings = ({ left, right, columnCount, onLeftChange, onRightChange
               onChange={onLeftChange}
             />
           </Grid.Col>
-          <Grid.Col span={{ base: 12, sm: 6 }}>
+          <Grid.Col span={{ base: 12, md: 6 }}>
             <GutterControl
               side="right"
               value={right}
@@ -381,6 +201,7 @@ const GutterControl = ({
         disabled={max < 1}
         onChange={(event) => onChange(event.currentTarget.checked ? Math.min(2, max) : 0)}
         label={t(`layout.field.gutters.${side}.label`)}
+        description={t(`layout.field.gutters.${side}.description`)}
       />
       {enabled && (
         <Input.Wrapper label={t("layout.field.gutters.width.label")}>

apps/nextjs/src/app/[locale]/boards/[name]/settings/_settings-form.tsx

@@ -36,11 +36,6 @@ const boardSettingsFormSchema = boardSavePartialSettingsSchema
 
 export type FormValues = z.infer<typeof boardSettingsFormSchema>;
 
-const normalizeMobileLayoutGutters = (layouts: readonly FormValues["layouts"][number][]) =>
-  layouts.map((layout) =>
-    layout.role === "mobile" ? { ...layout, leftGutterColumnCount: 0, rightGutterColumnCount: 0 } : layout,
-  );
-
 const PARTIAL_FORM_KEYS = [
   "pageTitle",
   "metaTitle",
@@ -75,7 +70,7 @@ const buildInitialValues = (board: Board): FormValues => ({
   itemRadius: board.itemRadius,
   customCss: board.customCss ?? "",
   disableStatus: board.disableStatus,
-  layouts: normalizeMobileLayoutGutters(board.layouts),
+  layouts: board.layouts,
 });
 
 interface BoardSettingsFormProps {
@@ -127,45 +122,46 @@ export const BoardSettingsForm = ({ board, permissions, hasFullAccess, hideVisib
     return () => window.removeEventListener("beforeunload", handler);
   }, []);
 
-  const saveSettingsAsync = async (values: FormValues): Promise<FormValues | null> => {
+  const handleSubmitAsync = async (values: FormValues) => {
     const defaults = initialValuesRef.current;
     const changed = <TKey extends keyof FormValues>(...fields: TKey[]) =>
       fields.some((field) => values[field] !== defaults[field]);
 
-    const { layouts: submittedLayouts, ...partialSettings } = values;
-    const layouts = normalizeMobileLayoutGutters(submittedLayouts);
-    const partialSettingsChanged = changed(...PARTIAL_FORM_KEYS);
-    const layoutsChanged = changed("layouts");
-    if (!partialSettingsChanged && !layoutsChanged) return values;
+    const { layouts, ...partialSettings } = values;
+
+    const saveActions: { when: boolean; action: () => Promise<unknown> }[] = [
+      {
+        when: changed(...PARTIAL_FORM_KEYS),
+        action: () =>
+          savePartialSettings.mutateAsync({ id: board.id, ...partialSettings }).then(() => {
+            updateFavicon(values.faviconImageUrl ?? homarrLogoPath);
+          }),
+      },
+      {
+        when: changed("layouts"),
+        action: () => saveLayouts.mutateAsync({ id: board.id, layouts }),
+      },
+    ];
+
+    const promises = saveActions.filter((saveAction) => saveAction.when).map((saveAction) => saveAction.action());
+    if (promises.length === 0) return;
 
     try {
-      const [, canonicalLayouts] = await Promise.all([
-        partialSettingsChanged
-          ? savePartialSettings.mutateAsync({ id: board.id, ...partialSettings }).then(() => {
-              updateFavicon(values.faviconImageUrl ?? homarrLogoPath);
-            })
-          : Promise.resolve(),
-        layoutsChanged ? saveLayouts.mutateAsync({ id: board.id, layouts }) : Promise.resolve(null),
-      ]);
-      const canonicalValues = canonicalLayouts ? { ...values, layouts: canonicalLayouts } : values;
-
-      lastSavedRef.current = { pageTitle: canonicalValues.pageTitle, logoImageUrl: canonicalValues.logoImageUrl };
-      initialValuesRef.current = canonicalValues;
-      form.setValues(canonicalValues);
-      form.setInitialValues(canonicalValues);
-      form.resetDirty(canonicalValues);
+      await Promise.all(promises);
+      lastSavedRef.current = { pageTitle: values.pageTitle, logoImageUrl: values.logoImageUrl };
+      initialValuesRef.current = values;
+      form.setInitialValues(values);
+      form.resetDirty();
       await revalidatePathActionAsync(`/boards/${board.name}/settings`);
       showSuccessNotification({
         title: t("common.notification.update.success"),
         message: t("common.notification.update.success"),
       });
-      return canonicalValues;
     } catch {
       showErrorNotification({
         title: t("common.notification.update.error"),
         message: t("common.notification.update.error"),
       });
-      return null;
     }
   };
 
@@ -183,15 +179,10 @@ export const BoardSettingsForm = ({ board, permissions, hasFullAccess, hideVisib
 
   return (
     <Stack gap="xl">
-      <form onSubmit={form.onSubmit((values) => void saveSettingsAsync(values))}>
+      <form onSubmit={form.onSubmit((values) => void handleSubmitAsync(values))}>
         <Stack gap="xl">
           <GeneralSettingsContent board={board} form={form} />
-          <LayoutSettingsContent
-            board={board}
-            form={form}
-            isSaving={isPending}
-            saveSettingsAsync={() => saveSettingsAsync(form.values)}
-          />
+          <LayoutSettingsContent form={form} />
           <BackgroundSettingsContent form={form} />
           <ColorSettingsContent form={form} />
           <CustomCssSettingsContent form={form} />

apps/nextjs/src/app/[locale]/boards/[name]/settings/page.tsx

@@ -53,7 +53,7 @@ export default async function BoardSettingsPage(props: Props) {
   }
 
   return (
-    <Container size="xl" px={{ base: "md", md: "xl" }}>
+    <Container size="xl">
       <Stack>
         <Title>{t("title", { boardName: capitalize(board.name) })}</Title>
         <BoardSettingsForm

apps/nextjs/src/app/[locale]/boards/_layout-creator.tsx

@@ -6,7 +6,8 @@ import { TRPCError } from "@trpc/server";
 
 import { getRscUserSettingsAsync } from "@homarr/api/user-server";
 import { auth } from "@homarr/auth/next";
-import { constructBoardPermissions } from "@homarr/auth/shared";
+import { BoardProvider } from "@homarr/boards/context";
+import { EditModeProvider } from "@homarr/boards/edit-mode";
 import { boardViewportWidthCookieName, getLayoutIdForViewportWidth } from "@homarr/boards/layout-selection";
 import { createLogger } from "@homarr/core/infrastructure/logs";
 import { ModalProvider } from "@homarr/modals";
@@ -18,7 +19,6 @@ import { BoardTourGate } from "~/components/onboarding/board-tour-gate";
 import { env } from "~/env";
 import { getCurrentColorSchemeAsync } from "~/theme/color-scheme";
 import type { Board } from "./_types";
-import { BoardProviders } from "./_providers";
 import type { Params } from "./(content)/_creator";
 import { CustomCss } from "./(content)/_custom-css";
 import { BoardReadyProvider } from "./(content)/_ready-context";
@@ -88,34 +88,34 @@ export const createBoardLayout = <TParams extends Params>({
       throw error;
     }
     const initialBoard = initialBoardResult.board;
-    const { hasChangeAccess } = constructBoardPermissions(initialBoard, session);
     const initialLayoutId = getLayoutIdForViewportWidth(initialBoard.layouts, initialViewportWidth);
 
     return (
-      <BoardProviders
+      <BoardProvider
         initialBoard={initialBoard}
         initialLayoutId={initialLayoutId}
         initialViewportWidth={initialViewportWidth}
-        canModify={hasChangeAccess}
       >
         <BoardReadyProvider>
-          <BoardMantineProvider defaultColorScheme={colorScheme}>
-            <ModalProvider>
-              <CustomCss />
-              <BoardTourGate enabled={shouldRunBoardTour}>
-                <ClientShell hasNavigation={false}>
-                  <MainHeader
-                    logo={<BoardLogoWithTitle size="md" hideTitleOnMobile />}
-                    actions={headerActions}
-                    hasNavigation={false}
-                  />
-                  <AppShellMain data-advanced-focus-background>{children}</AppShellMain>
-                </ClientShell>
-              </BoardTourGate>
-            </ModalProvider>
-          </BoardMantineProvider>
+          <EditModeProvider>
+            <BoardMantineProvider defaultColorScheme={colorScheme}>
+              <ModalProvider>
+                <CustomCss />
+                <BoardTourGate enabled={shouldRunBoardTour}>
+                  <ClientShell hasNavigation={false}>
+                    <MainHeader
+                      logo={<BoardLogoWithTitle size="md" hideTitleOnMobile />}
+                      actions={headerActions}
+                      hasNavigation={false}
+                    />
+                    <AppShellMain data-advanced-focus-background>{children}</AppShellMain>
+                  </ClientShell>
+                </BoardTourGate>
+              </ModalProvider>
+            </BoardMantineProvider>
+          </EditModeProvider>
         </BoardReadyProvider>
-      </BoardProviders>
+      </BoardProvider>
     );
   };
 

apps/nextjs/src/app/[locale]/boards/_providers.tsx

@@ -1,43 +0,0 @@
-"use client";
-
-import type { PropsWithChildren } from "react";
-import { useSearchParams } from "next/navigation";
-import { useMediaQuery } from "@mantine/hooks";
-
-import { BoardProvider } from "@homarr/boards/context";
-import { EditModeProvider } from "@homarr/boards/edit-mode";
-
-import type { Board } from "./_types";
-
-interface Props {
-  initialBoard: Board;
-  initialLayoutId: string;
-  initialViewportWidth: number;
-  canModify: boolean;
-}
-
-export const BoardProviders = ({
-  children,
-  initialBoard,
-  initialLayoutId,
-  initialViewportWidth,
-  canModify,
-}: PropsWithChildren<Props>) => {
-  const searchParams = useSearchParams();
-  const isDesktop = useMediaQuery("(min-width: 64em)");
-  const requestedLayoutId = searchParams.get("layout");
-  const isRequestedLayoutValid = initialBoard.layouts.some((layout) => layout.id === requestedLayoutId);
-  const isLayoutEditRequest = canModify && searchParams.get("edit") === "true" && isRequestedLayoutValid;
-  const layoutOverrideId = isLayoutEditRequest && isDesktop ? requestedLayoutId : null;
-
-  return (
-    <BoardProvider
-      initialBoard={initialBoard}
-      initialLayoutId={initialLayoutId}
-      initialViewportWidth={initialViewportWidth}
-      layoutOverrideId={layoutOverrideId}
-    >
-      <EditModeProvider initialOpen={isLayoutEditRequest}>{children}</EditModeProvider>
-    </BoardProvider>
-  );
-};

apps/nextjs/src/app/[locale]/init/_components/init-step-card.tsx

@@ -0,0 +1,12 @@
+import type { PropsWithChildren } from "react";
+import { Card } from "@mantine/core";
+
+interface InitStepCardProps {
+  withBorder?: boolean;
+}
+
+export const InitStepCard = ({ children, withBorder = true }: PropsWithChildren<InitStepCardProps>) => (
+  <Card w="100%" withBorder={withBorder}>
+    {children}
+  </Card>
+);

apps/nextjs/src/app/[locale]/init/_constants.ts

@@ -0,0 +1,2 @@
+export const onboardingContentWidth = 64 * 16;
+export const onboardingMaxWidth = "90vw";

apps/nextjs/src/app/[locale]/init/_steps/back.tsx

@@ -0,0 +1,23 @@
+"use client";
+
+import { Button } from "@mantine/core";
+
+import { clientApi } from "@homarr/api/client";
+import { revalidatePathActionAsync } from "@homarr/common/client";
+import { useI18n } from "@homarr/translation/client";
+
+export const BackToStart = () => {
+  const t = useI18n();
+  const { mutateAsync, isPending } = clientApi.onboard.previousStep.useMutation();
+
+  const handleBackToStartAsync = async () => {
+    await mutateAsync();
+    await revalidatePathActionAsync("/init");
+  };
+
+  return (
+    <Button loading={isPending} variant="subtle" color="gray" fullWidth onClick={handleBackToStartAsync}>
+      {t("init.backToStart")}
+    </Button>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/finish/init-finish.tsx

@@ -0,0 +1,75 @@
+import type { MantineColor } from "@mantine/core";
+import { Button, Stack, Text } from "@mantine/core";
+import { IconBook2, IconLayoutDashboard, IconMailForward } from "@tabler/icons-react";
+
+import { isProviderEnabled } from "@homarr/auth/server";
+import { getMantineColor } from "@homarr/common";
+import { createDocumentationLink } from "@homarr/definitions";
+import { getScopedI18n } from "@homarr/translation/server";
+import { Link } from "@homarr/ui";
+import type { TablerIcon } from "@homarr/ui";
+
+import { InitStepCard } from "../../_components/init-step-card";
+
+export const InitFinish = async () => {
+  const tFinish = await getScopedI18n("init.step.finish");
+
+  return (
+    <InitStepCard>
+      <Stack>
+        <Text>{tFinish("description")}</Text>
+
+        <InternalLinkButton href="/auth/login?callbackUrl=/" iconProps={{ icon: IconLayoutDashboard, color: "blue" }}>
+          {tFinish("action.goToBoard", { name: "dashboard" })}
+        </InternalLinkButton>
+
+        {isProviderEnabled("credentials") && (
+          <InternalLinkButton
+            href="/auth/login?callbackUrl=/manage/users/invites"
+            iconProps={{ icon: IconMailForward, color: "pink" }}
+          >
+            {tFinish("action.inviteUser")}
+          </InternalLinkButton>
+        )}
+
+        <ExternalLinkButton
+          href={createDocumentationLink("/docs/getting-started/after-the-installation")}
+          iconProps={{ icon: IconBook2, color: "yellow" }}
+        >
+          {tFinish("action.docs")}
+        </ExternalLinkButton>
+      </Stack>
+    </InitStepCard>
+  );
+};
+
+interface LinkButtonProps {
+  href: string;
+  children: string;
+  iconProps: IconProps;
+}
+
+interface IconProps {
+  icon: TablerIcon;
+  color: MantineColor;
+}
+
+const Icon = ({ icon: IcomComponent, color }: IconProps) => {
+  return <IcomComponent color={getMantineColor(color, 6)} size={16} stroke={1.5} />;
+};
+
+const InternalLinkButton = ({ href, children, iconProps }: LinkButtonProps) => {
+  return (
+    <Button variant="default" component={Link} href={href} leftSection={<Icon {...iconProps} />}>
+      {children}
+    </Button>
+  );
+};
+
+const ExternalLinkButton = ({ href, children, iconProps }: LinkButtonProps) => {
+  return (
+    <Button variant="default" component="a" href={href} leftSection={<Icon {...iconProps} />}>
+      {children}
+    </Button>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/group/init-group.tsx

@@ -0,0 +1,55 @@
+"use client";
+
+import { Button, Stack, TextInput } from "@mantine/core";
+import { IconArrowRight } from "@tabler/icons-react";
+import type { z } from "zod/v4";
+
+import { clientApi } from "@homarr/api/client";
+import { revalidatePathActionAsync } from "@homarr/common/client";
+import { useZodForm } from "@homarr/form";
+import { useI18n } from "@homarr/translation/client";
+import { groupCreateSchema } from "@homarr/validation/group";
+
+import { InitStepCard } from "../../_components/init-step-card";
+
+export const InitGroup = () => {
+  const t = useI18n();
+  const { mutateAsync } = clientApi.group.createInitialExternalGroup.useMutation({
+    async onSuccess() {
+      await revalidatePathActionAsync("/init");
+    },
+  });
+  const form = useZodForm(groupCreateSchema, {
+    initialValues: {
+      name: "",
+    },
+  });
+
+  const handleSubmitAsync = async (values: z.infer<typeof groupCreateSchema>) => {
+    await mutateAsync(values, {
+      onError(error) {
+        if (error.data?.code === "CONFLICT") {
+          form.setErrors({ name: t("common.zod.errors.custom.groupNameTaken") });
+        }
+      },
+    });
+  };
+
+  return (
+    <InitStepCard>
+      <form onSubmit={form.onSubmit(handleSubmitAsync)}>
+        <Stack>
+          <TextInput
+            label={t("init.step.group.form.name.label")}
+            description={t("init.step.group.form.name.description")}
+            withAsterisk
+            {...form.getInputProps("name")}
+          />
+          <Button type="submit" loading={form.submitting} rightSection={<IconArrowRight size={16} stroke={1.5} />}>
+            {t("common.action.continue")}
+          </Button>
+        </Stack>
+      </form>
+    </InitStepCard>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/import/file-info-card.tsx

@@ -0,0 +1,43 @@
+import { ActionIcon, Button, Group, Text } from "@mantine/core";
+import type { FileWithPath } from "@mantine/dropzone";
+import { IconPencil } from "@tabler/icons-react";
+
+import { formatBytes } from "@homarr/common";
+import { useScopedI18n } from "@homarr/translation/client";
+
+import { InitStepCard } from "../../_components/init-step-card";
+
+interface FileInfoCardProps {
+  file: FileWithPath;
+  onRemove: () => void;
+}
+
+export const FileInfoCard = ({ file, onRemove }: FileInfoCardProps) => {
+  const tFileInfo = useScopedI18n("init.step.import.fileInfo");
+  return (
+    <InitStepCard withBorder={false}>
+      <Group justify="space-between" align="center" wrap="nowrap">
+        <Group>
+          <Text fw={500} lineClamp={1} style={{ wordBreak: "break-all" }}>
+            {file.name}
+          </Text>
+          <Text visibleFrom="md" c="gray.6" size="sm">
+            {formatBytes(file.size)}
+          </Text>
+        </Group>
+        <Button
+          variant="subtle"
+          color="gray"
+          rightSection={<IconPencil size={16} stroke={1.5} />}
+          onClick={onRemove}
+          visibleFrom="md"
+        >
+          {tFileInfo("action.change")}
+        </Button>
+        <ActionIcon size="sm" variant="subtle" color="gray" hiddenFrom="md" onClick={onRemove}>
+          <IconPencil size={16} stroke={1.5} />
+        </ActionIcon>
+      </Group>
+    </InitStepCard>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/import/import-dropzone.tsx

@@ -0,0 +1,63 @@
+import { Group, rem, Text } from "@mantine/core";
+import type { FileWithPath } from "@mantine/dropzone";
+import { Dropzone, MIME_TYPES } from "@mantine/dropzone";
+import { IconFileZip, IconUpload, IconX } from "@tabler/icons-react";
+
+import "@mantine/dropzone/styles.css";
+
+import { useScopedI18n } from "@homarr/translation/client";
+
+interface ImportDropZoneProps {
+  loading: boolean;
+  updateFile: (file: FileWithPath) => void;
+}
+
+export const ImportDropZone = ({ loading, updateFile }: ImportDropZoneProps) => {
+  const tDropzone = useScopedI18n("init.step.import.dropzone");
+  return (
+    <Dropzone
+      onDrop={(files) => {
+        const firstFile = files[0];
+        if (!firstFile) return;
+
+        updateFile(firstFile);
+      }}
+      acceptColor="blue.6"
+      rejectColor="red.6"
+      accept={[MIME_TYPES.zip, "application/x-zip-compressed"]}
+      loading={loading}
+      multiple={false}
+      maxSize={1024 * 1024 * 1024 * 64} // 64 MB
+      onReject={(rejections) => {
+        console.error(
+          "Rejected files",
+          rejections.map(
+            (rejection) =>
+              `File: ${rejection.file.name} size=${rejection.file.size} fileType=${rejection.file.type}\n - ${rejection.errors.map((error) => error.message).join("\n - ")}`,
+          ),
+        );
+      }}
+    >
+      <Group justify="center" gap="xl" mih={220} style={{ pointerEvents: "none" }}>
+        <Dropzone.Accept>
+          <IconUpload style={{ width: rem(52), height: rem(52), color: "var(--mantine-color-blue-6)" }} stroke={1.5} />
+        </Dropzone.Accept>
+        <Dropzone.Reject>
+          <IconX style={{ width: rem(52), height: rem(52), color: "var(--mantine-color-red-6)" }} stroke={1.5} />
+        </Dropzone.Reject>
+        <Dropzone.Idle>
+          <IconFileZip style={{ width: rem(52), height: rem(52), color: "var(--mantine-color-dimmed)" }} stroke={1.5} />
+        </Dropzone.Idle>
+
+        <div>
+          <Text size="xl" inline>
+            {tDropzone("title")}
+          </Text>
+          <Text size="sm" c="dimmed" inline mt={7}>
+            {tDropzone("description")}
+          </Text>
+        </div>
+      </Group>
+    </Dropzone>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/import/init-import.tsx

@@ -0,0 +1,54 @@
+"use client";
+
+import { startTransition, useState } from "react";
+import { Stack } from "@mantine/core";
+import type { FileWithPath } from "@mantine/dropzone";
+
+import type { RouterOutputs } from "@homarr/api";
+import { clientApi } from "@homarr/api/client";
+import { InitialOldmarrImport } from "@homarr/old-import/components";
+
+import { InitStepCard } from "../../_components/init-step-card";
+import { FileInfoCard } from "./file-info-card";
+import { ImportDropZone } from "./import-dropzone";
+
+export const InitImport = () => {
+  const [file, setFile] = useState<FileWithPath | null>(null);
+  const { isPending, mutate } = clientApi.import.analyseInitialOldmarrImport.useMutation();
+  const [analyseResult, setAnalyseResult] = useState<RouterOutputs["import"]["analyseInitialOldmarrImport"] | null>(
+    null,
+  );
+
+  if (!file) {
+    return (
+      <InitStepCard>
+        <ImportDropZone
+          loading={isPending}
+          updateFile={(file) => {
+            const formData = new FormData();
+            formData.append("file", file);
+
+            mutate(formData, {
+              onSuccess: (result) => {
+                startTransition(() => {
+                  setAnalyseResult(result);
+                  setFile(file);
+                });
+              },
+              onError: (error) => {
+                console.error(error);
+              },
+            });
+          }}
+        />
+      </InitStepCard>
+    );
+  }
+
+  return (
+    <Stack w="100%" mb="sm">
+      <FileInfoCard file={file} onRemove={() => setFile(null)} />
+      {analyseResult !== null && <InitialOldmarrImport file={file} analyseResult={analyseResult} />}
+    </Stack>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/integrations/docker-discovery-panel.tsx

@@ -0,0 +1,209 @@
+"use client";
+
+import { useEffect, useRef, useState } from "react";
+import {
+  Avatar,
+  Badge,
+  Card,
+  Collapse,
+  Group,
+  Loader,
+  Paper,
+  ScrollArea,
+  SimpleGrid,
+  Stack,
+  Text,
+  ThemeIcon,
+  UnstyledButton,
+} from "@mantine/core";
+import { IconBrandDocker, IconCheck, IconChevronDown } from "@tabler/icons-react";
+
+import type { IntegrationKind } from "@homarr/definitions";
+import { getIntegrationName } from "@homarr/definitions";
+import { useScopedI18n } from "@homarr/translation/client";
+import { IntegrationAvatar } from "@homarr/ui";
+
+export interface DiscoveredIntegration {
+  containerId: string;
+  containerName: string;
+  kind: IntegrationKind;
+  suggestedUrl: string;
+  publishedPort: number | null;
+  iconUrl: string | null;
+}
+
+export interface DiscoveredApp {
+  containerId: string;
+  containerName: string;
+  suggestedUrl: string;
+  publishedPort: number | null;
+  iconUrl: string | null;
+}
+
+interface DockerDiscoveryIndicatorProps {
+  integrations: DiscoveredIntegration[];
+  apps: DiscoveredApp[];
+  selectedAppIds: Set<string>;
+  onToggleApp: (containerId: string) => void;
+  isLoading: boolean;
+}
+
+const APP_CARD_HEIGHT = 80;
+
+export const DockerDiscoveryIndicator = ({
+  integrations,
+  apps,
+  selectedAppIds,
+  onToggleApp,
+  isLoading,
+}: DockerDiscoveryIndicatorProps) => {
+  const hasApps = apps.length > 0;
+  const [expanded, setExpanded] = useState(false);
+
+  const expandedOnce = useRef(false);
+  useEffect(() => {
+    if ((hasApps || integrations.length > 0) && !expandedOnce.current) {
+      expandedOnce.current = true;
+      setExpanded(true);
+    }
+  }, [hasApps, integrations.length]);
+
+  const t = useScopedI18n("init.step.integrations.docker");
+  const totalCount = integrations.length + apps.length;
+
+  if (!isLoading && totalCount === 0) return null;
+
+  const selectedAppCount = apps.filter((app) => selectedAppIds.has(app.containerId)).length;
+
+  if (isLoading) {
+    return (
+      <Paper
+        withBorder
+        p="sm"
+        radius="md"
+        style={{
+          borderColor: "var(--mantine-color-blue-4)",
+          background: "var(--mantine-color-blue-light)",
+        }}
+      >
+        <Group gap="sm" wrap="nowrap">
+          <ThemeIcon variant="light" color="blue" size="lg" radius="md">
+            <IconBrandDocker size={20} />
+          </ThemeIcon>
+          <Stack gap={0} style={{ flex: 1 }}>
+            <Text size="sm" fw={600}>
+              {t("scanning")}
+            </Text>
+            <Text size="xs" c="dimmed">
+              {t("scanningDescription")}
+            </Text>
+          </Stack>
+          <Loader size="sm" color="blue" type="dots" />
+        </Group>
+      </Paper>
+    );
+  }
+
+  return (
+    <Paper
+      withBorder
+      p="sm"
+      radius="md"
+      style={{
+        borderColor: "var(--mantine-color-blue-4)",
+        background: "var(--mantine-color-blue-light)",
+      }}
+    >
+      <UnstyledButton onClick={() => setExpanded((prev) => !prev)} w="100%">
+        <Group justify="space-between" wrap="nowrap">
+          <Group gap="sm" wrap="nowrap">
+            <ThemeIcon variant="light" color="blue" size="lg" radius="md">
+              <IconBrandDocker size={20} />
+            </ThemeIcon>
+            <Stack gap={0}>
+              <Text size="sm" fw={600}>
+                {t("detected", { count: String(totalCount) })}
+              </Text>
+              <Text size="xs" c="dimmed">
+                {t("detectedBreakdown", {
+                  integrations: String(integrations.length),
+                  apps: String(apps.length),
+                })}
+              </Text>
+            </Stack>
+          </Group>
+          <IconChevronDown
+            size={16}
+            color="var(--mantine-color-dimmed)"
+            style={{
+              transform: expanded ? "rotate(180deg)" : undefined,
+              transition: "transform 200ms ease",
+            }}
+          />
+        </Group>
+      </UnstyledButton>
+
+      <Collapse expanded={expanded}>
+        <Stack gap="xs" mt="sm">
+          {integrations.length > 0 && (
+            <Stack gap={4}>
+              {integrations.map((integration) => (
+                <Group key={integration.containerId} gap="xs" wrap="nowrap" py={2}>
+                  <IntegrationAvatar kind={integration.kind} size="xs" />
+                  <Text size="xs" fw={500} lineClamp={1} style={{ flex: 1, minWidth: 0 }}>
+                    {integration.containerName}
+                  </Text>
+                  <Badge size="xs" variant="light" color="blue">
+                    {getIntegrationName(integration.kind)}
+                  </Badge>
+                </Group>
+              ))}
+            </Stack>
+          )}
+
+          {hasApps && (
+            <Stack gap="xs">
+              <Text size="xs" fw={500}>
+                {t("appSectionLabel", { count: String(selectedAppCount) })}
+              </Text>
+              <ScrollArea.Autosize mah="30vh">
+                <SimpleGrid cols={{ base: 3, xs: 4, sm: 5 }} spacing="xs">
+                  {apps.map((app) => {
+                    const isSelected = selectedAppIds.has(app.containerId);
+                    return (
+                      <Card
+                        key={app.containerId}
+                        h={APP_CARD_HEIGHT}
+                        p="xs"
+                        withBorder
+                        style={{
+                          cursor: "pointer",
+                          borderColor: isSelected ? "var(--mantine-color-blue-6)" : undefined,
+                          borderWidth: isSelected ? 2 : undefined,
+                          opacity: isSelected ? 1 : 0.6,
+                        }}
+                        onClick={() => onToggleApp(app.containerId)}
+                      >
+                        <Stack justify="space-between" h="100%" gap={4} align="center">
+                          <Group justify="space-between" w="100%" wrap="nowrap">
+                            <Text size="xs" fw={500} lineClamp={1} style={{ flex: 1, minWidth: 0 }}>
+                              {app.containerName}
+                            </Text>
+                            {isSelected && <IconCheck size={14} color="var(--mantine-color-blue-6)" />}
+                          </Group>
+                          <Avatar size="sm" radius="sm" src={app.iconUrl} styles={{ image: { objectFit: "contain" } }}>
+                            {app.containerName.at(0)?.toUpperCase()}
+                          </Avatar>
+                        </Stack>
+                      </Card>
+                    );
+                  })}
+                </SimpleGrid>
+              </ScrollArea.Autosize>
+            </Stack>
+          )}
+        </Stack>
+      </Collapse>
+    </Paper>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/integrations/init-integrations.tsx

@@ -0,0 +1,483 @@
+"use client";
+
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useRouter } from "next/navigation";
+import {
+  ActionIcon,
+  Alert,
+  Avatar,
+  Button,
+  Card,
+  Center,
+  Collapse,
+  Group,
+  Loader,
+  Paper,
+  Progress,
+  SegmentedControl,
+  SimpleGrid,
+  Stack,
+  Text,
+  TextInput,
+  ThemeIcon,
+  Tooltip,
+} from "@mantine/core";
+import { useDisclosure } from "@mantine/hooks";
+import {
+  IconAlertTriangle,
+  IconArrowRight,
+  IconBrandDocker,
+  IconCheck,
+  IconChevronDown,
+  IconSettings,
+} from "@tabler/icons-react";
+
+import { clientApi } from "@homarr/api/client";
+import type { IntegrationKind, UrlTemplateMode } from "@homarr/definitions";
+import { buildAppUrl, buildIntegrationUrl, getIntegrationName } from "@homarr/definitions";
+import { showErrorNotification } from "@homarr/notifications";
+import { useScopedI18n } from "@homarr/translation/client";
+import { IntegrationAvatar } from "@homarr/ui";
+
+import { NewIntegrationForm } from "~/app/[locale]/manage/integrations/new/_integration-new-form";
+import { IntegrationMultiSelectGrid } from "~/components/integration/integration-multi-select-grid";
+import { InitStepCard } from "../../_components/init-step-card";
+
+type Phase = "select" | "configure" | "done";
+
+interface IntegrationDraft {
+  kind: IntegrationKind;
+  initialUrl: string;
+  initialName?: string;
+  dockerPort?: number | null;
+  source: "manual" | "docker";
+}
+
+export const InitIntegrations = () => {
+  const [phase, setPhase] = useState<Phase>("select");
+  const [drafts, setDrafts] = useState<Map<IntegrationKind, IntegrationDraft>>(new Map());
+  const [selectedKinds, setSelectedKinds] = useState<IntegrationKind[]>([]);
+  const [currentIndex, setCurrentIndex] = useState(0);
+  const [baseHost, setBaseHost] = useState("");
+  const [urlMode, setUrlMode] = useState<UrlTemplateMode>("subdomain");
+  const t = useScopedI18n("init.step.integrations");
+  const router = useRouter();
+
+  const { mutateAsync: setupIntegrations } = clientApi.onboard.setupIntegrations.useMutation();
+  const { mutateAsync: createApps } = clientApi.onboard.createAppsFromDiscovery.useMutation();
+
+  const { data: dockerData, isPending: isDockerLoading } = clientApi.onboard.discoverDockerServices.useQuery(
+    undefined,
+    {
+      retry: false,
+      refetchOnWindowFocus: false,
+    },
+  );
+
+  const dockerIntegrations = dockerData?.status === "success" ? dockerData.integrations : [];
+  const dockerApps = dockerData?.status === "success" ? dockerData.apps : [];
+  const totalDetected = dockerIntegrations.length + dockerApps.length;
+
+  const detectedKinds = useMemo(() => new Set(dockerIntegrations.map((i) => i.kind)), [dockerIntegrations]);
+
+  const [selectedAppIds, setSelectedAppIds] = useState<Set<string>>(new Set());
+  const [appsExpanded, setAppsExpanded] = useState(false);
+
+  const dockerApplied = useRef(false);
+  useEffect(() => {
+    if (dockerData?.status !== "success" || dockerApplied.current) return;
+    dockerApplied.current = true;
+
+    const newDrafts = new Map(drafts);
+    const newKinds = new Set(selectedKinds);
+
+    for (const item of dockerData.integrations) {
+      if (!newDrafts.has(item.kind)) {
+        newDrafts.set(item.kind, {
+          kind: item.kind,
+          initialUrl: item.suggestedUrl,
+          initialName: item.containerName,
+          dockerPort: item.publishedPort,
+          source: "docker",
+        });
+      }
+      newKinds.add(item.kind);
+    }
+
+    setDrafts(newDrafts);
+    setSelectedKinds(Array.from(newKinds));
+    setSelectedAppIds(new Set(dockerData.apps.map((app) => app.containerId)));
+    if (dockerData.apps.length > 0) {
+      setAppsExpanded(true);
+    }
+  }, [dockerData]);
+
+  const handleSelectionChange = useCallback((kinds: IntegrationKind[]) => {
+    setSelectedKinds(kinds);
+  }, []);
+
+  const handleToggleApp = useCallback((containerId: string) => {
+    setSelectedAppIds((prev) => {
+      const next = new Set(prev);
+      if (next.has(containerId)) {
+        next.delete(containerId);
+      } else {
+        next.add(containerId);
+      }
+      return next;
+    });
+  }, []);
+
+  const handleContinueToConfig = () => {
+    const newDrafts = new Map(drafts);
+    for (const kind of selectedKinds) {
+      const existing = newDrafts.get(kind);
+      if (baseHost) {
+        newDrafts.set(kind, {
+          kind,
+          initialUrl: buildIntegrationUrl(kind, baseHost, urlMode, existing?.dockerPort ?? undefined),
+          initialName: existing?.initialName,
+          dockerPort: existing?.dockerPort,
+          source: existing?.source ?? "manual",
+        });
+      } else if (!existing) {
+        newDrafts.set(kind, { kind, initialUrl: "", source: "manual" });
+      }
+    }
+    setDrafts(newDrafts);
+    setCurrentIndex(0);
+    setPhase("configure");
+  };
+
+  const finishSetupAsync = async () => {
+    setPhase("done");
+    try {
+      const appsToCreate = dockerApps.filter((app) => selectedAppIds.has(app.containerId));
+      if (appsToCreate.length > 0) {
+        await createApps(
+          appsToCreate.map((app) => {
+            const href = baseHost
+              ? buildAppUrl(app.containerName, baseHost, urlMode, app.publishedPort ?? undefined)
+              : app.suggestedUrl;
+            return {
+              name: app.containerName,
+              href: href || null,
+              iconUrl: app.iconUrl,
+            };
+          }),
+        );
+      }
+      await setupIntegrations();
+      router.refresh();
+    } catch {
+      showErrorNotification({
+        title: t("configure.error.title"),
+        message: t("configure.error.message"),
+      });
+      setPhase("select");
+    }
+  };
+
+  const advanceOrFinish = () => {
+    if (currentIndex + 1 >= selectedKinds.length) {
+      void finishSetupAsync();
+    } else {
+      setCurrentIndex((i) => i + 1);
+    }
+  };
+
+  const backToSelect = () => {
+    setPhase("select");
+    setCurrentIndex(0);
+  };
+
+  if (phase === "done") {
+    return (
+      <InitStepCard>
+        <Center py="xl">
+          <Stack align="center" gap="md">
+            <Loader size="lg" />
+            <Text>{t("configure.finishing")}</Text>
+          </Stack>
+        </Center>
+      </InitStepCard>
+    );
+  }
+
+  if (phase === "configure") {
+    return (
+      <ConfigurePhase
+        selectedKinds={selectedKinds}
+        currentIndex={currentIndex}
+        drafts={drafts}
+        baseHost={baseHost}
+        setBaseHost={setBaseHost}
+        urlMode={urlMode}
+        setUrlMode={setUrlMode}
+        onSuccess={advanceOrFinish}
+        onCancel={backToSelect}
+        onSkip={advanceOrFinish}
+      />
+    );
+  }
+
+  const selectedAppCount = dockerApps.filter((app) => selectedAppIds.has(app.containerId)).length;
+
+  return (
+    <InitStepCard>
+      <Stack>
+        <Text>{t("description")}</Text>
+
+        <Alert variant="outline" color="orange" icon={<IconAlertTriangle />} title={t("urlTemplate.label")}>
+          <Stack gap="xs">
+            <Text size="sm" fw={500}>
+              {t("urlTemplate.warning")}
+            </Text>
+            <Group gap="sm" grow>
+              <TextInput
+                placeholder={t("urlTemplate.placeholder")}
+                value={baseHost}
+                onChange={(e) => setBaseHost(e.currentTarget.value)}
+                data-autofocus
+              />
+              <SegmentedControl
+                value={urlMode}
+                onChange={(value) => setUrlMode(value as UrlTemplateMode)}
+                data={[
+                  { label: t("urlTemplate.mode.subdomain"), value: "subdomain" },
+                  { label: t("urlTemplate.mode.hostPort"), value: "hostPort" },
+                ]}
+                style={{ flex: "0 0 auto" }}
+              />
+            </Group>
+            {baseHost && (
+              <Text size="xs" c="dimmed">
+                {t("urlTemplate.preview", { example: buildIntegrationUrl("sonarr", baseHost, urlMode) })}
+              </Text>
+            )}
+          </Stack>
+        </Alert>
+
+        {isDockerLoading && (
+          <Paper withBorder p="sm" radius="md">
+            <Group gap="sm" wrap="nowrap">
+              <ThemeIcon variant="light" color="blue" size="lg" radius="md">
+                <IconBrandDocker size={20} />
+              </ThemeIcon>
+              <Text size="sm" fw={500}>
+                {t("docker.scanning")}
+              </Text>
+              <Loader size="sm" color="blue" type="dots" />
+            </Group>
+          </Paper>
+        )}
+
+        {!isDockerLoading && totalDetected > 0 && (
+          <Paper withBorder p="sm" radius="md" style={{ borderColor: "var(--mantine-color-teal-4)" }}>
+            <Group gap="sm" wrap="nowrap">
+              <ThemeIcon variant="light" color="teal" size="lg" radius="md">
+                <IconBrandDocker size={20} />
+              </ThemeIcon>
+              <Text size="sm">
+                {t("docker.summary", {
+                  apps: String(totalDetected),
+                  integrations: String(dockerIntegrations.length),
+                })}
+              </Text>
+            </Group>
+          </Paper>
+        )}
+
+        <IntegrationMultiSelectGrid
+          selectedKinds={selectedKinds}
+          onSelectionChange={handleSelectionChange}
+          detectedKinds={detectedKinds}
+          onboarding
+        />
+
+        {dockerApps.length > 0 && (
+          <Paper withBorder p="sm" radius="md">
+            <Stack gap="xs">
+              <Group
+                justify="space-between"
+                wrap="nowrap"
+                style={{ cursor: "pointer" }}
+                onClick={() => setAppsExpanded((prev) => !prev)}
+              >
+                <Text size="sm" fw={500}>
+                  {t("docker.appSectionLabel", { count: String(selectedAppCount) })}
+                </Text>
+                <IconChevronDown
+                  size={16}
+                  color="var(--mantine-color-dimmed)"
+                  style={{
+                    transform: appsExpanded ? "rotate(180deg)" : undefined,
+                    transition: "transform 200ms ease",
+                  }}
+                />
+              </Group>
+              <Collapse expanded={appsExpanded}>
+                <SimpleGrid cols={{ base: 3, xs: 4, sm: 5 }} spacing="xs">
+                  {dockerApps.map((app) => {
+                    const isSelected = selectedAppIds.has(app.containerId);
+                    return (
+                      <Card
+                        key={app.containerId}
+                        h={80}
+                        p="xs"
+                        withBorder
+                        style={{
+                          cursor: "pointer",
+                          borderColor: isSelected ? "var(--mantine-color-blue-6)" : undefined,
+                          borderWidth: isSelected ? 2 : undefined,
+                          opacity: isSelected ? 1 : 0.6,
+                        }}
+                        onClick={() => handleToggleApp(app.containerId)}
+                      >
+                        <Stack justify="space-between" h="100%" gap={4} align="center">
+                          <Group justify="space-between" w="100%" wrap="nowrap">
+                            <Text size="xs" fw={500} lineClamp={1} style={{ flex: 1, minWidth: 0 }}>
+                              {app.containerName}
+                            </Text>
+                            {isSelected && <IconCheck size={14} color="var(--mantine-color-blue-6)" />}
+                          </Group>
+                          <Avatar size="sm" radius="sm" src={app.iconUrl} styles={{ image: { objectFit: "contain" } }}>
+                            {app.containerName.at(0)?.toUpperCase()}
+                          </Avatar>
+                        </Stack>
+                      </Card>
+                    );
+                  })}
+                </SimpleGrid>
+              </Collapse>
+            </Stack>
+          </Paper>
+        )}
+
+        <Group justify="space-between">
+          <Button variant="subtle" onClick={() => void finishSetupAsync()}>
+            {t("action.skip")}
+          </Button>
+          <Button
+            onClick={handleContinueToConfig}
+            disabled={selectedKinds.length === 0 || undefined}
+            rightSection={<IconArrowRight size={16} stroke={1.5} />}
+            suppressHydrationWarning
+          >
+            {t("action.continue")} {selectedKinds.length > 0 && `(${selectedKinds.length})`}
+          </Button>
+        </Group>
+      </Stack>
+    </InitStepCard>
+  );
+};
+
+interface ConfigurePhaseProps {
+  selectedKinds: IntegrationKind[];
+  currentIndex: number;
+  drafts: Map<IntegrationKind, IntegrationDraft>;
+  baseHost: string;
+  setBaseHost: (value: string) => void;
+  urlMode: UrlTemplateMode;
+  setUrlMode: (value: UrlTemplateMode) => void;
+  onSuccess: () => void;
+  onCancel: () => void;
+  onSkip: () => void;
+}
+
+const ConfigurePhase = ({
+  selectedKinds,
+  currentIndex,
+  drafts,
+  baseHost,
+  setBaseHost,
+  urlMode,
+  setUrlMode,
+  onSuccess,
+  onCancel,
+  onSkip,
+}: ConfigurePhaseProps) => {
+  const t = useScopedI18n("init.step.integrations");
+  const [helpersOpen, { toggle: toggleHelpers }] = useDisclosure(false);
+
+  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- currentIndex is always within bounds of selectedKinds
+  const currentKind = selectedKinds[currentIndex]!;
+  const draft = drafts.get(currentKind);
+  const progress = ((currentIndex + 1) / selectedKinds.length) * 100;
+  const computedUrl = baseHost
+    ? buildIntegrationUrl(currentKind, baseHost, urlMode, draft?.dockerPort ?? undefined)
+    : draft?.initialUrl;
+
+  return (
+    <InitStepCard>
+      <Stack>
+        <Group justify="space-between" align="center">
+          <Group gap="xs">
+            <IntegrationAvatar kind={currentKind} size="sm" />
+            <Text fw={500}>{getIntegrationName(currentKind)}</Text>
+          </Group>
+          <Tooltip label={t("configure.helpers.tooltip")}>
+            <ActionIcon variant={helpersOpen ? "light" : "subtle"} color="gray" onClick={toggleHelpers}>
+              <IconSettings size={18} stroke={1.5} />
+            </ActionIcon>
+          </Tooltip>
+        </Group>
+
+        <Stack gap={4}>
+          <Progress value={progress} size="sm" />
+          <Text size="xs" c="dimmed" ta="center">
+            {t("configure.progress", { current: String(currentIndex + 1), total: String(selectedKinds.length) })}
+          </Text>
+        </Stack>
+
+        <Collapse expanded={helpersOpen}>
+          <Stack
+            gap="xs"
+            p="xs"
+            style={{ background: "var(--mantine-color-default-hover)", borderRadius: "var(--mantine-radius-sm)" }}
+          >
+            <Text size="xs" c="dimmed">
+              {t("configure.helpers.description")}
+            </Text>
+            <Group gap="sm" grow>
+              <TextInput
+                size="xs"
+                placeholder={t("urlTemplate.placeholder")}
+                value={baseHost}
+                onChange={(e) => setBaseHost(e.currentTarget.value)}
+              />
+              <SegmentedControl
+                size="xs"
+                value={urlMode}
+                onChange={(value) => setUrlMode(value as UrlTemplateMode)}
+                data={[
+                  { label: t("urlTemplate.mode.subdomain"), value: "subdomain" },
+                  { label: t("urlTemplate.mode.hostPort"), value: "hostPort" },
+                ]}
+                style={{ flex: "0 0 auto" }}
+              />
+            </Group>
+            {baseHost && (
+              <Text size="xs" c="dimmed">
+                {t("urlTemplate.preview", {
+                  example: buildIntegrationUrl(currentKind, baseHost, urlMode, draft?.dockerPort ?? undefined),
+                })}
+              </Text>
+            )}
+          </Stack>
+        </Collapse>
+
+        <NewIntegrationForm
+          key={currentKind}
+          kind={currentKind}
+          initialUrl={computedUrl}
+          initialName={draft?.initialName}
+          onSuccess={onSuccess}
+          onCancel={onCancel}
+          onSkip={onSkip}
+          isOnboarding
+        />
+      </Stack>
+    </InitStepCard>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/settings/init-settings.tsx

@@ -0,0 +1,129 @@
+"use client";
+
+import { Button, Group, Stack, Switch, Text } from "@mantine/core";
+import { IconArrowRight } from "@tabler/icons-react";
+import type { z } from "zod/v4";
+
+import { clientApi } from "@homarr/api/client";
+import { revalidatePathActionAsync } from "@homarr/common/client";
+import { useZodForm } from "@homarr/form";
+import type { CheckboxProps } from "@homarr/form/types";
+import { defaultServerSettings } from "@homarr/server-settings";
+import type { TranslationObject } from "@homarr/translation";
+import { useI18n, useScopedI18n } from "@homarr/translation/client";
+import { settingsInitSchema } from "@homarr/validation/settings";
+
+import { InitStepCard } from "../../_components/init-step-card";
+
+export const InitSettings = () => {
+  const tSection = useScopedI18n("management.page.settings.section");
+  const t = useI18n();
+  const { mutateAsync } = clientApi.serverSettings.initSettings.useMutation({
+    async onSuccess() {
+      await revalidatePathActionAsync("/init");
+    },
+  });
+  const form = useZodForm(settingsInitSchema, { initialValues: defaultServerSettings });
+
+  const handleSubmitAsync = async (values: z.infer<typeof settingsInitSchema>) => {
+    await mutateAsync(values);
+  };
+
+  return (
+    <form onSubmit={form.onSubmit(handleSubmitAsync)}>
+      <Stack w="100%">
+        <InitStepCard>
+          <Stack gap="sm">
+            <Text fw={500}>{tSection("analytics.title")}</Text>
+
+            <Stack gap="xs">
+              <AnalyticsRow kind="general" {...form.getInputProps("analytics.enableGeneral", { type: "checkbox" })} />
+            </Stack>
+          </Stack>
+        </InitStepCard>
+        <InitStepCard>
+          <Stack gap="sm">
+            <Text fw={500}>{tSection("crawlingAndIndexing.title")}</Text>
+
+            <Stack gap="xs">
+              <CrawlingRow
+                kind="noIndex"
+                {...form.getInputProps("crawlingAndIndexing.noIndex", { type: "checkbox" })}
+              />
+              <CrawlingRow
+                kind="noFollow"
+                {...form.getInputProps("crawlingAndIndexing.noFollow", { type: "checkbox" })}
+              />
+              <CrawlingRow
+                kind="noTranslate"
+                {...form.getInputProps("crawlingAndIndexing.noTranslate", { type: "checkbox" })}
+              />
+              <CrawlingRow
+                kind="noSiteLinksSearchBox"
+                {...form.getInputProps("crawlingAndIndexing.noSiteLinksSearchBox", { type: "checkbox" })}
+              />
+            </Stack>
+          </Stack>
+        </InitStepCard>
+
+        <Button type="submit" loading={form.submitting} rightSection={<IconArrowRight size={16} stroke={1.5} />}>
+          {t("common.action.continue")}
+        </Button>
+      </Stack>
+    </form>
+  );
+};
+
+interface AnalyticsRowProps {
+  kind: Exclude<keyof TranslationObject["management"]["page"]["settings"]["section"]["analytics"], "title">;
+  disabled?: boolean;
+}
+
+const AnalyticsRow = ({ kind, ...props }: AnalyticsRowProps & CheckboxProps) => {
+  const tSection = useI18n("management.page.settings.section");
+
+  return (
+    <SettingRow title={tSection(`analytics.${kind}.title`)} text={tSection(`analytics.${kind}.text`)} {...props} />
+  );
+};
+
+interface CrawlingRowProps {
+  kind: Exclude<
+    keyof TranslationObject["management"]["page"]["settings"]["section"]["crawlingAndIndexing"],
+    "title" | "warning"
+  >;
+}
+
+const CrawlingRow = ({ kind, ...inputProps }: CrawlingRowProps & CheckboxProps) => {
+  const tSection = useI18n("management.page.settings.section");
+
+  return (
+    <SettingRow
+      title={tSection(`crawlingAndIndexing.${kind}.title`)}
+      text={tSection(`crawlingAndIndexing.${kind}.text`)}
+      {...inputProps}
+    />
+  );
+};
+
+const SettingRow = ({
+  title,
+  text,
+  disabled,
+  ...inputProps
+}: { title: string; text: string; disabled?: boolean } & CheckboxProps) => {
+  return (
+    <Group wrap="nowrap" align="center">
+      <Stack gap={0} style={{ flex: 1 }}>
+        <Text size="sm" fw={500}>
+          {title}
+        </Text>
+        <Text size="xs" c="gray.5">
+          {text}
+        </Text>
+      </Stack>
+
+      <Switch disabled={disabled} {...inputProps} />
+    </Group>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/start/init-start.tsx

@@ -0,0 +1,37 @@
+import { Stack, Text } from "@mantine/core";
+import { IconFileImport, IconPlayerPlay } from "@tabler/icons-react";
+
+import { getMantineColor } from "@homarr/common";
+import { dbEnv } from "@homarr/core/infrastructure/db/env";
+import { getScopedI18n } from "@homarr/translation/server";
+
+import { InitStepCard } from "../../_components/init-step-card";
+import { InitSqliteRestore } from "./sqlite-restore";
+import { InitStartButton } from "./next-button";
+
+export const InitStart = async () => {
+  const tStart = await getScopedI18n("init.step.start");
+  const isSqlite = dbEnv.DRIVER === "better-sqlite3";
+
+  return (
+    <InitStepCard>
+      <Stack>
+        <Text>{tStart("description")}</Text>
+
+        <InitStartButton
+          preferredStep={undefined}
+          icon={<IconPlayerPlay color={getMantineColor("green", 6)} size={16} stroke={1.5} />}
+        >
+          {tStart("action.scratch")}
+        </InitStartButton>
+        <InitStartButton
+          preferredStep="import"
+          icon={<IconFileImport color={getMantineColor("cyan", 6)} size={16} stroke={1.5} />}
+        >
+          {tStart("action.importOldmarr")}
+        </InitStartButton>
+        {isSqlite && <InitSqliteRestore />}
+      </Stack>
+    </InitStepCard>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/start/next-button.tsx

@@ -0,0 +1,28 @@
+"use client";
+
+import type { PropsWithChildren, ReactNode } from "react";
+import { Button } from "@mantine/core";
+
+import { clientApi } from "@homarr/api/client";
+import { revalidatePathActionAsync } from "@homarr/common/client";
+import type { OnboardingStep } from "@homarr/definitions";
+
+interface InitStartButtonProps {
+  icon: ReactNode;
+  preferredStep: OnboardingStep | undefined;
+}
+
+export const InitStartButton = ({ preferredStep, icon, children }: PropsWithChildren<InitStartButtonProps>) => {
+  const { mutateAsync } = clientApi.onboard.nextStep.useMutation();
+
+  const handleClickAsync = async () => {
+    await mutateAsync({ preferredStep });
+    await revalidatePathActionAsync("/init");
+  };
+
+  return (
+    <Button onClick={handleClickAsync} variant="default" leftSection={icon}>
+      {children}
+    </Button>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/start/sqlite-restore.tsx

@@ -0,0 +1,39 @@
+"use client";
+
+import { useState } from "react";
+import { Button, Stack, Text } from "@mantine/core";
+import { IconDatabaseImport } from "@tabler/icons-react";
+
+import { getMantineColor } from "@homarr/common";
+import { useScopedI18n } from "@homarr/translation/client";
+
+import { DatabaseRestoreFlow } from "~/components/backup";
+
+export const InitSqliteRestore = () => {
+  const t = useScopedI18n("init.step.start.action");
+  const [expanded, setExpanded] = useState(false);
+
+  if (expanded) {
+    return (
+      <Stack gap="sm">
+        <Button variant="subtle" size="xs" onClick={() => setExpanded(false)}>
+          {t("backToOptions")}
+        </Button>
+        <Text size="sm" c="dimmed">
+          {t("restoreSqliteDescription")}
+        </Text>
+        <DatabaseRestoreFlow variant="standalone" />
+      </Stack>
+    );
+  }
+
+  return (
+    <Button
+      onClick={() => setExpanded(true)}
+      variant="default"
+      leftSection={<IconDatabaseImport color={getMantineColor("orange", 6)} size={16} stroke={1.5} />}
+    >
+      {t("restoreSqlite")}
+    </Button>
+  );
+};

apps/nextjs/src/app/[locale]/init/_steps/user/init-user-form.tsx

@@ -0,0 +1,75 @@
+"use client";
+
+import { Button, Stack, TextInput } from "@mantine/core";
+import type { z } from "zod/v4";
+
+import { clientApi } from "@homarr/api/client";
+import { signIn } from "@homarr/auth/client";
+import { revalidatePathActionAsync } from "@homarr/common/client";
+import { useZodForm } from "@homarr/form";
+import { UserCreatePasswordFields } from "@homarr/forms-collection";
+import { showErrorNotification, showSuccessNotification } from "@homarr/notifications";
+import { useScopedI18n } from "@homarr/translation/client";
+import { userInitSchema } from "@homarr/validation/user";
+
+export const InitUserForm = () => {
+  const t = useScopedI18n("user");
+  const tUser = useScopedI18n("init.step.user");
+  const { mutateAsync, isPending } = clientApi.user.initUser.useMutation();
+  const form = useZodForm(userInitSchema, {
+    initialValues: {
+      username: "",
+      password: "",
+      confirmPassword: "",
+    },
+  });
+
+  const handleSubmitAsync = async (values: FormType) => {
+    await mutateAsync(values, {
+      onSuccess() {
+        showSuccessNotification({
+          title: tUser("notification.success.title"),
+          message: tUser("notification.success.message"),
+        });
+
+        void signIn("credentials", {
+          name: values.username,
+          password: values.password,
+          redirect: false,
+        }).then(async () => {
+          await revalidatePathActionAsync("/init");
+        });
+      },
+      onError: (error) => {
+        showErrorNotification({
+          title: tUser("notification.error.title"),
+          message: error.message,
+        });
+      },
+    });
+  };
+
+  return (
+    <Stack gap="xl">
+      <form
+        onSubmit={form.onSubmit(
+          (values) => void handleSubmitAsync(values),
+          (err) => console.log(err),
+        )}
+      >
+        <Stack gap="lg">
+          <TextInput label={t("field.username.label")} {...form.getInputProps("username")} />
+          <UserCreatePasswordFields
+            passwordInputProps={form.getInputProps("password")}
+            confirmPasswordInputProps={form.getInputProps("confirmPassword")}
+          />
+          <Button type="submit" fullWidth loading={isPending}>
+            {t("action.create")}
+          </Button>
+        </Stack>
+      </form>
+    </Stack>
+  );
+};
+
+type FormType = z.infer<typeof userInitSchema>;

apps/nextjs/src/app/[locale]/init/_steps/user/init-user.tsx

@@ -0,0 +1,10 @@
+import { InitStepCard } from "../../_components/init-step-card";
+import { InitUserForm } from "./init-user-form";
+
+export const InitUser = () => {
+  return (
+    <InitStepCard>
+      <InitUserForm />
+    </InitStepCard>
+  );
+};

apps/nextjs/src/app/[locale]/init/page.tsx

@@ -1,78 +1,66 @@
-import { headers } from "next/headers";
+import type { JSX } from "react";
+import { Box, Center, Stack, Text, Title } from "@mantine/core";
 
-import { getOnboardingClaimTokenFromCookieHeader, isOnboardingClaimValidAsync } from "@homarr/api/onboarding-claim";
-import { normalizeOnboardingStep } from "@homarr/api/onboarding-step";
-import { auth } from "@homarr/auth/next";
-import { isProviderEnabled } from "@homarr/auth/server";
-import { extractBaseUrlFromHeaders } from "@homarr/common";
-import { dbEnv } from "@homarr/core/infrastructure/db/env";
-import { db, eq } from "@homarr/db";
-import { groups } from "@homarr/db/schema";
-import { everyoneGroup } from "@homarr/definitions";
-import { env as dockerEnv } from "@homarr/docker/env";
-import { OnboardingStudio } from "@homarr/onboarding";
-import { resolveHomarrUrlConfig } from "@homarr/workshop/schema";
+import type { MaybePromise } from "@homarr/common/types";
+import { db } from "@homarr/db";
+import type { OnboardingStep } from "@homarr/definitions";
+import { getScopedI18n } from "@homarr/translation/server";
 
-import { DatabaseRestoreFlow } from "~/components/backup";
-import { env } from "~/env";
-import { getPackageVersion } from "~/versions/package-reader";
-import { AssistantConfiguration } from "../manage/assistant/_components/assistant-configuration";
+import { CurrentColorSchemeCombobox } from "~/components/color-scheme/current-color-scheme-combobox";
+import { CurrentLanguageCombobox } from "~/components/language/current-language-combobox";
+import { HomarrLogoWithTitle } from "~/components/layout/logo/homarr-logo";
+import { onboardingContentWidth, onboardingMaxWidth } from "./_constants";
+import { BackToStart } from "./_steps/back";
+import { InitFinish } from "./_steps/finish/init-finish";
+import { InitGroup } from "./_steps/group/init-group";
+import { InitImport } from "./_steps/import/init-import";
+import { InitIntegrations } from "./_steps/integrations/init-integrations";
+import { InitSettings } from "./_steps/settings/init-settings";
+import { InitStart } from "./_steps/start/init-start";
+import { InitUser } from "./_steps/user/init-user";
+
+const stepComponents: Record<OnboardingStep, null | (() => MaybePromise<JSX.Element>)> = {
+  start: InitStart,
+  import: InitImport,
+  user: InitUser,
+  group: InitGroup,
+  settings: InitSettings,
+  integrations: InitIntegrations,
+  finish: InitFinish,
+};
+
+const getCurrentOnboardingStepAsync = async () => {
+  const value = await db.query.onboarding.findFirst();
+  if (!value) return { current: "start" as const, previous: null };
+
+  return { current: value.step, previous: value.previousStep };
+};
 
 export default async function InitPage() {
-  const [state, session, requestHeaders, firstUser] = await Promise.all([
-    db.query.onboarding.findFirst(),
-    auth(),
-    headers(),
-    db.query.users.findFirst({ columns: { id: true } }),
-  ]);
-  const canConfigurePrivileged = session?.user.permissions.includes("admin") ?? false;
-  const onboardingClaim = getOnboardingClaimTokenFromCookieHeader(requestHeaders.get("cookie"));
-  const canReadSetupContext =
-    canConfigurePrivileged || (!firstUser && (await isOnboardingClaimValidAsync(db, onboardingClaim)));
-  const [defaultGroup, availableBoards] = canReadSetupContext
-    ? await Promise.all([
-        db.query.groups.findFirst({
-          where: eq(groups.name, everyoneGroup),
-          columns: { homeBoardId: true },
-        }),
-        db.query.boards.findMany({ columns: { id: true, name: true, primaryColor: true, secondaryColor: true } }),
-      ])
-    : [undefined, []];
-  const homeBoardId = defaultGroup?.homeBoardId;
-  const homeBoard = availableBoards.find((board) => board.id === homeBoardId);
-  const initialBoard = homeBoard ?? (availableBoards.length === 1 ? availableBoards[0] : null);
-  const currentStep = normalizeOnboardingStep(state?.step);
-  const databaseDriver =
-    dbEnv.DRIVER === "better-sqlite3" ? "sqlite" : dbEnv.DRIVER === "mysql2" ? "mysql" : "postgresql";
-  const { workshopApiUrl, workshopWebUrl } = canReadSetupContext
-    ? resolveHomarrUrlConfig({
-        homarrWebsiteUrl: env.HOMARR_WEBSITE_URL,
-        workshopApiUrl: env.WORKSHOP_API_URL,
-        workshopWebUrl: env.WORKSHOP_WEB_URL,
-      })
-    : { workshopApiUrl: "", workshopWebUrl: "" };
-  const baseUrl = extractBaseUrlFromHeaders(requestHeaders);
+  const t = await getScopedI18n("init.step");
+  const currentStep = await getCurrentOnboardingStepAsync();
+
+  const CurrentComponent = stepComponents[currentStep.current];
 
   return (
-    <OnboardingStudio
-      environment={{
-        version: getPackageVersion(),
-        currentStep,
-        databaseDriver,
-        externalAuthEnabled: isProviderEnabled("ldap") || isProviderEnabled("oidc"),
-        dockerConfigured: canReadSetupContext && dockerEnv.ENABLE_DOCKER,
-        kubernetesConfigured: canReadSetupContext && dockerEnv.ENABLE_KUBERNETES,
-        workshopApiUrl,
-        workshopUrl: workshopWebUrl,
-        serverOrigin: baseUrl,
-        mcpEndpoint: `${baseUrl}/api/mcp`,
-        canConfigurePrivileged,
-        hasUsers: Boolean(firstUser),
-        initialBoard: initialBoard ?? null,
-        availableBoards: availableBoards.map(({ id, name }) => ({ id, name })),
-      }}
-      sqliteRestore={databaseDriver === "sqlite" ? <DatabaseRestoreFlow variant="standalone" /> : undefined}
-      assistantConfiguration={canConfigurePrivileged ? <AssistantConfiguration /> : undefined}
-    />
+    <Box mih="100dvh">
+      <Center>
+        <Stack align="center" mt="xl" w={onboardingContentWidth} maw={onboardingMaxWidth}>
+          <HomarrLogoWithTitle size="lg" />
+          <Stack gap={6} align="center">
+            <Title order={3} fw={400} ta="center">
+              {t(`${currentStep.current}.title`)}
+            </Title>
+            <Text size="sm" c="gray.5" ta="center">
+              {t(`${currentStep.current}.subtitle`)}
+            </Text>
+          </Stack>
+          <CurrentLanguageCombobox width="100%" />
+          <CurrentColorSchemeCombobox w="100%" />
+          {CurrentComponent && <CurrentComponent />}
+          {currentStep.previous === "start" && <BackToStart />}
+        </Stack>
+      </Center>
+    </Box>
   );
 }

apps/nextjs/src/app/[locale]/layout.tsx

@@ -5,7 +5,6 @@ import "@gfazioli/mantine-onboarding-tour/styles.css";
 import "@homarr/notifications/styles.css";
 import "@homarr/spotlight/styles.css";
 import "@homarr/ui/styles.css";
-import "flag-icons/css/flag-icons.min.css";
 import "mantine-datatable/styles.css";
 import "~/styles/color-scheme.scss";
 import "~/styles/scroll-area.scss";
@@ -14,7 +13,6 @@ import { notFound } from "next/navigation";
 import type { DayOfWeek } from "@mantine/dates";
 import { NextIntlClientProvider } from "next-intl";
 
-import { api } from "@homarr/api/server";
 import { env as authEnv } from "@homarr/auth/env";
 import { getRscServerSettingsAsync } from "@homarr/api/server-settings-server";
 import { getRscUserSettingsAsync } from "@homarr/api/user-server";
@@ -29,8 +27,6 @@ import { isLocaleRTL, isLocaleSupported } from "@homarr/translation";
 import { resolveHomarrUrlConfig } from "@homarr/workshop/schema";
 
 import { Analytics } from "~/components/layout/analytics";
-import type { AssistantAvailability } from "~/components/assistant/assistant-gate";
-import { AssistantGate } from "~/components/assistant/assistant-gate";
 import { CrowdinLiveTranslation } from "~/components/layout/crowdin-live-translation";
 import { env } from "~/env";
 
@@ -101,20 +97,11 @@ export default async function Layout(props: {
         })
       : null,
   );
-  const assistantAvailabilityPromise: Promise<AssistantAvailability> = sessionPromise.then((session) =>
-    !session
-      ? "unauthenticated"
-      : api.assistant
-          .getAvailability()
-          .then((availability) => (availability.enabled ? "enabled" : "unconfigured"))
-          .catch(() => "error"),
-  );
-  const [session, user, serverSettings, colorScheme, assistantAvailability] = await Promise.all([
+  const [session, user, serverSettings, colorScheme] = await Promise.all([
     sessionPromise,
     userPromise,
     getRscServerSettingsAsync(),
     getCurrentColorSchemeAsync(),
-    assistantAvailabilityPromise,
   ]);
   const direction = isLocaleRTL(locale) ? "rtl" : "ltr";
   const publicUrls = resolveHomarrUrlConfig({
@@ -158,7 +145,6 @@ export default async function Layout(props: {
     (innerProps) => <CustomMantineProvider {...innerProps} defaultColorScheme={colorScheme} />,
     (innerProps) => <ModalProvider {...innerProps} />,
     (innerProps) => <SpotlightProvider {...innerProps} />,
-    (innerProps) => <AssistantGate availability={assistantAvailability} {...innerProps} />,
   ]);
 
   return (
@@ -174,12 +160,8 @@ export default async function Layout(props: {
     >
       <head>
         <meta name="homarr-website-url" content={publicUrls.homarrWebsiteUrl} />
-        {session ? (
-          <>
-            <meta name="homarr-workshop-api-url" content={publicUrls.workshopApiUrl} />
-            <meta name="homarr-workshop-web-url" content={publicUrls.workshopWebUrl} />
-          </>
-        ) : null}
+        <meta name="homarr-workshop-api-url" content={publicUrls.workshopApiUrl} />
+        <meta name="homarr-workshop-web-url" content={publicUrls.workshopWebUrl} />
         <SearchEngineOptimization />
         <CrowdinLiveTranslation locale={locale} />
       </head>

apps/nextjs/src/app/[locale]/manage/_components/hero-banner.module.css

@@ -21,4 +21,26 @@
 
 .scrollContainer {
   height: 100%;
+  transform: rotateZ(10deg);
+}
+
+@keyframes scrolling {
+  0% {
+    transform: translateY(0);
+  }
+  100% {
+    transform: translateY(-50.8%);
+  }
+}
+
+.scrollAnimationContainer {
+  animation: scrolling;
+  animation-timing-function: linear;
+  animation-iteration-count: infinite;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .scrollAnimationContainer {
+    animation: none !important;
+  }
 }

apps/nextjs/src/app/[locale]/manage/_components/hero-banner.tsx

@@ -1,10 +1,20 @@
-import { Box, Group, Image, Stack, Title } from "@mantine/core";
+import { Box, Grid, GridCol, Group, Image, Stack, Title } from "@mantine/core";
 
+import { splitToNChunks } from "@homarr/common";
+import { integrationDefs } from "@homarr/definitions";
 import { getScopedI18n } from "@homarr/translation/server";
-import { IntegrationMarquee } from "@homarr/ui";
 
 import classes from "./hero-banner.module.css";
 
+const icons = Object.values(integrationDefs)
+  .filter((int) => int.name !== "Mock")
+  .map((int) => int.iconUrl);
+
+const countIconGroups = 3;
+const animationDurationInSeconds = icons.length;
+const arrayInChunks = splitToNChunks(icons, countIconGroups);
+const gridSpan = 12 / countIconGroups;
+
 export const HeroBanner = async () => {
   const t = await getScopedI18n("management.page.home");
 
@@ -20,7 +30,41 @@ export const HeroBanner = async () => {
         </Group>
       </Stack>
       <Box visibleFrom="md" className={classes.scrollContainer} w={"30%"} top={0} right={0} pos="absolute">
-        <IntegrationMarquee />
+        <Grid>
+          {Array(countIconGroups)
+            .fill(0)
+            .map((_, columnIndex) => (
+              <GridCol key={`grid-column-${columnIndex}`} span={gridSpan}>
+                <Stack
+                  className={classes.scrollAnimationContainer}
+                  style={{
+                    animationDuration: `${animationDurationInSeconds - columnIndex}s`,
+                  }}
+                >
+                  {arrayInChunks[columnIndex]?.map((icon, index) => (
+                    <Image
+                      key={`grid-column-${columnIndex}-scroll-1-${index}`}
+                      src={icon}
+                      fit={"contain"}
+                      w={50}
+                      h={50}
+                    />
+                  ))}
+
+                  {/* This is used for making the animation seem seamless */}
+                  {arrayInChunks[columnIndex]?.map((icon, index) => (
+                    <Image
+                      key={`grid-column-${columnIndex}-scroll-2-${index}`}
+                      src={icon}
+                      fit={"contain"}
+                      w={50}
+                      h={50}
+                    />
+                  ))}
+                </Stack>
+              </GridCol>
+            ))}
+        </Grid>
       </Box>
     </Box>
   );

apps/nextjs/src/app/[locale]/manage/apps/_app-delete-button.tsx

@@ -17,7 +17,6 @@ interface AppDeleteButtonProps {
 
 export const AppDeleteButton = ({ app }: AppDeleteButtonProps) => {
   const t = useScopedI18n("app.page.delete");
-  const tList = useScopedI18n("app.page.list.action");
   const { openConfirmModal } = useConfirmModal();
   const { mutate, isPending } = clientApi.app.delete.useMutation();
 
@@ -51,14 +50,7 @@ export const AppDeleteButton = ({ app }: AppDeleteButtonProps) => {
   }, [app, mutate, t, openConfirmModal]);
 
   return (
-    <ActionIcon
-      loading={isPending}
-      variant="subtle"
-      color="red"
-      size={44}
-      onClick={onClick}
-      aria-label={tList("delete", { name: app.name })}
-    >
+    <ActionIcon loading={isPending} variant="subtle" color="red" onClick={onClick} aria-label={t("title")}>
       <IconTrash color="red" size={16} stroke={1.5} />
     </ActionIcon>
   );

apps/nextjs/src/app/[locale]/manage/apps/edit/[id]/page.tsx

@@ -16,7 +16,10 @@ export default async function AppEditPage(props: AppEditPageProps) {
   const params = await props.params;
   const session = await auth();
 
-  if (!session?.user.permissions.includes("app-modify-all")) {
+  if (
+    !session?.user.permissions.includes("board-modify-all") ||
+    !session?.user.permissions.includes("app-modify-all")
+  ) {
     notFound();
   }
   const app = await api.app.byId({ id: params.id });

apps/nextjs/src/app/[locale]/manage/apps/new/page.tsx

@@ -10,7 +10,7 @@ import { DynamicBreadcrumb } from "~/components/navigation/dynamic-breadcrumb";
 export default async function AppNewPage() {
   const session = await auth();
 
-  if (!session?.user.permissions.includes("app-create")) {
+  if (!session?.user.permissions.includes("board-modify-all") || !session?.user.permissions.includes("app-create")) {
     notFound();
   }