diff --git a/apps/docs/docs/management/boards/index.mdx b/apps/docs/docs/management/boards/index.mdx
index effa13748..7d6267687 100644
--- a/apps/docs/docs/management/boards/index.mdx
+++ b/apps/docs/docs/management/boards/index.mdx
@@ -66,6 +66,9 @@ with enabled sidebars shown beside the main canvas.
Enter edit mode from the board header to add, move, resize, configure, or remove content. Save the board to persist the
layout.
+Dismissing the setup checklist is remembered per board in the current browser, independently of board contents.
+Clearing browser site data restores it; dismissal does not sync across browsers.
+
- Drag from an item's inactive content area; Containers use their grip.
- Hold `Ctrl` on Windows/Linux or `Cmd` on macOS to select several items.
- Use **Move / resize item** for another canvas, rail, Container, or exact coordinates.
diff --git a/apps/nextjs/src/components/board/board-setup-checklist.tsx b/apps/nextjs/src/components/board/board-setup-checklist.tsx
index 126cc24fd..b73987f34 100644
--- a/apps/nextjs/src/components/board/board-setup-checklist.tsx
+++ b/apps/nextjs/src/components/board/board-setup-checklist.tsx
@@ -2,7 +2,7 @@
import { ActionIcon, Affix, Button, Group, Paper, Progress, Stack, Text, ThemeIcon, Tooltip } from "@mantine/core";
import { useLocalStorage } from "@mantine/hooks";
-import { IconCheck, IconChevronDown, IconChecklist } from "@tabler/icons-react";
+import { IconCheck, IconChevronDown, IconChecklist, IconX } from "@tabler/icons-react";
import { useIntegrationsWithUseAccess } from "@homarr/auth/client";
import { useRequiredBoard } from "@homarr/boards/context";
@@ -22,6 +22,10 @@ export const BoardSetupChecklist = () => {
key: `homarr-board-setup-checklist-${board.id}`,
defaultValue: false,
});
+ const [dismissed, setDismissed] = useLocalStorage({
+ key: `homarr-board-setup-checklist-dismissed-${board.id}`,
+ defaultValue: false,
+ });
const t = useI18n("board.setupChecklist");
const tCommon = useI18n("common.action");
const progress = getBoardSetupProgress({
@@ -29,7 +33,7 @@ export const BoardSetupChecklist = () => {
usableIntegrationCount: integrations.length,
});
- if (!isEditMode || progress.isComplete) return null;
+ if (!isEditMode || progress.isComplete || dismissed) return null;
if (collapsed) {
return (
@@ -58,11 +62,18 @@ export const BoardSetupChecklist = () => {
{t("description")}
-
- setCollapsed(true)}>
-
-
-
+
+
+ setCollapsed(true)}>
+
+
+
+
+ setDismissed(true)}>
+
+
+
+