diff --git a/apps/docs/blog/2026/09-03-homarr-2.0/img/drag-and-drop-still.webp b/apps/docs/blog/2026/09-03-homarr-2.0/img/drag-and-drop-still.webp deleted file mode 100644 index 50c21f40d..000000000 Binary files a/apps/docs/blog/2026/09-03-homarr-2.0/img/drag-and-drop-still.webp and /dev/null differ diff --git a/apps/docs/blog/2026/09-03-homarr-2.0/img/drag-and-drop.gif b/apps/docs/blog/2026/09-03-homarr-2.0/img/drag-and-drop.gif new file mode 100644 index 000000000..15871579f Binary files /dev/null and b/apps/docs/blog/2026/09-03-homarr-2.0/img/drag-and-drop.gif differ diff --git a/apps/docs/blog/2026/09-03-homarr-2.0/index.mdx b/apps/docs/blog/2026/09-03-homarr-2.0/index.mdx index 13ea745d9..0368d4da7 100644 --- a/apps/docs/blog/2026/09-03-homarr-2.0/index.mdx +++ b/apps/docs/blog/2026/09-03-homarr-2.0/index.mdx @@ -65,7 +65,7 @@ We have called this the **"ultimate Homarr update"**. Not because work stops, bu We threw out the old drag-and-drop system and rebuilt it on [`dnd-kit`](https://dndkit.com/). Moves and eight-direction resizes are transactional: Homarr previews the result, checks collisions and only saves a valid layout. Bad moves roll back instead of wrecking the board. In short: less fighting with your own dashboard. -![A Calendar tile repositioned between widgets on the rebuilt Homarr 2.0 board grid](./img/drag-and-drop-still.webp) +![A Calendar tile moving across the rebuilt Homarr 2.0 board grid](./img/drag-and-drop.gif) ### Goodbye Groups and sections, bonjour Containers diff --git a/apps/nextjs/src/app/[locale]/boards/[name]/settings/_settings-form.tsx b/apps/nextjs/src/app/[locale]/boards/[name]/settings/_settings-form.tsx index dddadf906..0eeb06f36 100644 --- a/apps/nextjs/src/app/[locale]/boards/[name]/settings/_settings-form.tsx +++ b/apps/nextjs/src/app/[locale]/boards/[name]/settings/_settings-form.tsx @@ -7,6 +7,7 @@ import type { z } from "zod/v4"; import type { RouterOutputs } from "@homarr/api"; import { useUpdateBoard } from "@homarr/boards/updater"; import { revalidatePathActionAsync } from "@homarr/common/client"; +import { env } from "@homarr/common/env"; import { useZodForm } from "@homarr/form"; import { showErrorNotification, showSuccessNotification } from "@homarr/notifications"; import { useSettings } from "@homarr/settings"; @@ -107,7 +108,7 @@ export const BoardSettingsForm = ({ board, permissions, hasFullAccess, hideVisib const initialValuesRef = useRef(buildInitialValues(board)); const lastSavedRef = useRef({ pageTitle: board.pageTitle, logoImageUrl: board.logoImageUrl }); - useUnsavedChangesGuard(form.isDirty()); + useUnsavedChangesGuard(form.isDirty(), { guardBeforeUnload: env.NODE_ENV !== "development" }); useEffect(() => { return () => { diff --git a/apps/nextjs/src/app/[locale]/manage/settings/_components/settings-form.tsx b/apps/nextjs/src/app/[locale]/manage/settings/_components/settings-form.tsx index 387ec9e46..208733a6e 100644 --- a/apps/nextjs/src/app/[locale]/manage/settings/_components/settings-form.tsx +++ b/apps/nextjs/src/app/[locale]/manage/settings/_components/settings-form.tsx @@ -8,6 +8,7 @@ import { z } from "zod/v4"; import type { RouterOutputs } from "@homarr/api"; import { clientApi } from "@homarr/api/client"; import { revalidatePathActionAsync } from "@homarr/common/client"; +import { env } from "@homarr/common/env"; import { colorSchemes } from "@homarr/definitions"; import { useZodForm } from "@homarr/form"; import { showErrorNotification, showSuccessNotification } from "@homarr/notifications"; @@ -80,7 +81,7 @@ export const SettingsForm = ({ initialData, selectableBoards, selectableSearchEn initialValues, }); - useUnsavedChangesGuard(form.isDirty()); + useUnsavedChangesGuard(form.isDirty(), { guardBeforeUnload: env.NODE_ENV !== "development" }); const [isSubmitting, setIsSubmitting] = useState(false); diff --git a/apps/nextjs/src/app/[locale]/manage/users/[userId]/general/_components/_general-settings-form.tsx b/apps/nextjs/src/app/[locale]/manage/users/[userId]/general/_components/_general-settings-form.tsx index 43386803d..587d2289b 100644 --- a/apps/nextjs/src/app/[locale]/manage/users/[userId]/general/_components/_general-settings-form.tsx +++ b/apps/nextjs/src/app/[locale]/manage/users/[userId]/general/_components/_general-settings-form.tsx @@ -27,6 +27,7 @@ import type { RouterOutputs } from "@homarr/api"; import { clientApi } from "@homarr/api/client"; import type { BoardPreviewData } from "@homarr/boards/layout-preview"; import { revalidatePathActionAsync } from "@homarr/common/client"; +import { env } from "@homarr/common/env"; import { useZodForm } from "@homarr/form"; import { showErrorNotification, showSuccessNotification } from "@homarr/notifications"; import { useI18n } from "@homarr/translation/client"; @@ -125,7 +126,7 @@ export const UserGeneralSettingsForm = ({ initialValues, }); - useUnsavedChangesGuard(form.isDirty()); + useUnsavedChangesGuard(form.isDirty(), { guardBeforeUnload: env.NODE_ENV !== "development" }); const weekDays = useMemo(() => dayjs.weekdays(false), []); diff --git a/apps/nextjs/src/components/manage/unsaved-changes-guard.ts b/apps/nextjs/src/components/manage/unsaved-changes-guard.ts index 1d76cbff5..4793600df 100644 --- a/apps/nextjs/src/components/manage/unsaved-changes-guard.ts +++ b/apps/nextjs/src/components/manage/unsaved-changes-guard.ts @@ -1,9 +1,14 @@ interface UnsavedChangesGuardOptions { isDirty(): boolean; confirmNavigation(href: string): void; + guardBeforeUnload?: boolean; } -export function registerUnsavedChangesGuard({ isDirty, confirmNavigation }: UnsavedChangesGuardOptions) { +export function registerUnsavedChangesGuard({ + isDirty, + confirmNavigation, + guardBeforeUnload = true, +}: UnsavedChangesGuardOptions) { let currentHref = `${window.location.pathname}${window.location.search}${window.location.hash}`; const handleClick = (event: MouseEvent) => { if (!isDirty() || event.defaultPrevented || event.button !== 0) return; @@ -17,6 +22,7 @@ export function registerUnsavedChangesGuard({ isDirty, confirmNavigation }: Unsa const current = new URL(window.location.href); if (destination.origin !== current.origin) return; if (destination.pathname === current.pathname && destination.search === current.search) { + currentHref = `${destination.pathname}${destination.search}${destination.hash}`; return; } @@ -48,11 +54,11 @@ export function registerUnsavedChangesGuard({ isDirty, confirmNavigation }: Unsa }; document.addEventListener("click", handleClick, true); - window.addEventListener("beforeunload", handleBeforeUnload); + if (guardBeforeUnload) window.addEventListener("beforeunload", handleBeforeUnload); window.addEventListener("popstate", handlePopState); return () => { document.removeEventListener("click", handleClick, true); - window.removeEventListener("beforeunload", handleBeforeUnload); + if (guardBeforeUnload) window.removeEventListener("beforeunload", handleBeforeUnload); window.removeEventListener("popstate", handlePopState); }; } diff --git a/apps/nextjs/src/components/manage/use-unsaved-changes-guard.ts b/apps/nextjs/src/components/manage/use-unsaved-changes-guard.ts index c054f1f82..fa3aa0925 100644 --- a/apps/nextjs/src/components/manage/use-unsaved-changes-guard.ts +++ b/apps/nextjs/src/components/manage/use-unsaved-changes-guard.ts @@ -7,7 +7,11 @@ import { useConfirmModal } from "@homarr/modals"; import { useI18n } from "@homarr/translation/client"; import { registerUnsavedChangesGuard } from "./unsaved-changes-guard"; -export function useUnsavedChangesGuard(isDirty: boolean) { +interface UnsavedChangesGuardOptions { + guardBeforeUnload?: boolean; +} + +export function useUnsavedChangesGuard(isDirty: boolean, options: UnsavedChangesGuardOptions = {}) { const tConfirmLeave = useI18n("board.action.edit.confirmLeave"); const tCommon = useI18n("common"); const router = useRouter(); @@ -39,7 +43,8 @@ export function useUnsavedChangesGuard(isDirty: boolean) { registerUnsavedChangesGuard({ isDirty: () => dirtyRef.current, confirmNavigation: (href) => confirmNavigationRef.current(href), + guardBeforeUnload: options.guardBeforeUnload, }), - [], + [options.guardBeforeUnload], ); } diff --git a/e2e/onboarding.spec.ts b/e2e/onboarding.spec.ts index 0935acaf1..7f1d3b9b0 100644 --- a/e2e/onboarding.spec.ts +++ b/e2e/onboarding.spec.ts @@ -89,7 +89,7 @@ describe("Onboarding", () => { try { await page.goto(`http://${homarrContainer.getHost()}:${homarrContainer.getMappedPort(7575)}/init`); - await page.getByRole("heading", { name: "Make home feel organized." }).waitFor(); + await page.getByRole("heading", { name: "Welcome home." }).waitFor(); const start = page.getByRole("button", { name: "Get started" }); await start.focus(); await start.press("Enter"); @@ -356,7 +356,7 @@ describe("Onboarding", () => { ); await loginAsync({ page, baseUrl, credentials, destination: "/init" }); - await page.getByRole("heading", { name: "Make home feel organized." }).waitFor(); + await page.getByRole("heading", { name: "Welcome home." }).waitFor(); await page.getByRole("button", { name: "Get started" }).click(); await page.getByRole("heading", { name: "Start with familiar defaults" }).waitFor(); expect(await page.getByRole("heading", { name: "Create your administrator" }).count()).toBe(0); diff --git a/packages/modals-collection/src/apps/app-select-modal.tsx b/packages/modals-collection/src/apps/app-select-modal.tsx index 8ec360141..7236eed7b 100644 --- a/packages/modals-collection/src/apps/app-select-modal.tsx +++ b/packages/modals-collection/src/apps/app-select-modal.tsx @@ -12,13 +12,13 @@ import { Text, ThemeIcon, } from "@mantine/core"; -import { IconListCheck, IconPlus, IconSearch } from "@tabler/icons-react"; +import { IconBulb, IconListCheck, IconPlus, IconSearch } from "@tabler/icons-react"; import type { RouterOutputs } from "@homarr/api"; import { clientApi } from "@homarr/api/client"; import { createModal, modalSizeSelect, useModalAction } from "@homarr/modals"; import { useI18n } from "@homarr/translation/client"; -import { selectGridCols, SelectableCard } from "@homarr/ui"; +import { FloatingTip, selectGridCols, SelectableCard } from "@homarr/ui"; import { QuickAddAppModal } from "./quick-add-app/quick-add-app-modal"; @@ -106,6 +106,17 @@ export const AppSelectModal = createModal(({ actions, inner return ( + , variant: "light" }} + > + {t("tips.multiSelectApps")} + + {/* Top Search Input */}