Skip to content

⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.

fix(web): show an empty state on empty boards and normalize shared view display (#774)

Croff4f2a4b4da471
diff --git a/apps/web/messages/ar/workItems.json b/apps/web/messages/ar/workItems.json
index 9b4d8e9a..f38dfbf3 100644
--- a/apps/web/messages/ar/workItems.json
+++ b/apps/web/messages/ar/workItems.json
@@ -60,8 +60,13 @@
"custom": "كل العناصر لها تاريخ."
}
},
+ "empty": {
+ "title": "لا توجد مهام",
+ "description": "ستظهر المهام هنا.",
+ "filteredTitle": "لا توجد مهام مطابقة",
+ "filteredDescription": "غيّر عوامل التصفية لرؤية المزيد."
+ },
"timeline": {
- "empty": "لا توجد مهام لعرضها على الخط الزمني بعد.",
"expandGroup": "توسيع المجموعة",
"collapseGroup": "طيّ المجموعة",
"inferredStart": "البدء مُستنتج من تاريخ الإنشاء",
diff --git a/apps/web/messages/en/workItems.json b/apps/web/messages/en/workItems.json
index de94dd23..f75f7819 100644
--- a/apps/web/messages/en/workItems.json
+++ b/apps/web/messages/en/workItems.json
@@ -67,8 +67,13 @@
"custom": "Everything has a date."
}
},
+ "empty": {
+ "title": "No issues",
+ "description": "Issues will show up here.",
+ "filteredTitle": "No matching issues",
+ "filteredDescription": "Change the filters to see more."
+ },
"timeline": {
- "empty": "No issues to place on the timeline yet.",
"expandGroup": "Expand group",
"collapseGroup": "Collapse group",
"inferredStart": "Start inferred from the created date",
diff --git a/apps/web/messages/es-ES/workItems.json b/apps/web/messages/es-ES/workItems.json
index eadeea29..5c21420d 100644
--- a/apps/web/messages/es-ES/workItems.json
+++ b/apps/web/messages/es-ES/workItems.json
@@ -67,8 +67,13 @@
"custom": "Todo el mundo tiene fecha."
}
},
+ "empty": {
+ "title": "No hay tickets",
+ "description": "Los tickets aparecerán aquí.",
+ "filteredTitle": "Ningún ticket coincide",
+ "filteredDescription": "Cambia los filtros para ver más."
+ },
"timeline": {
- "empty": "Todavía no hay tickets para situar en la cronología.",
"expandGroup": "Expandir grupo",
"collapseGroup": "Contraír grupo",
"inferredStart": "Inicio inferido de la fecha de creación",
diff --git a/apps/web/messages/fa/workItems.json b/apps/web/messages/fa/workItems.json
index 18caf4b6..1d7f4fd7 100644
--- a/apps/web/messages/fa/workItems.json
+++ b/apps/web/messages/fa/workItems.json
@@ -67,8 +67,13 @@
"custom": "همه‌چیز تاریخ دارد."
}
},
+ "empty": {
+ "title": "تسکی وجود ندارد",
+ "description": "تسک‌ها اینجا نمایش داده می‌شوند.",
+ "filteredTitle": "تسک مطابقی وجود ندارد",
+ "filteredDescription": "برای دیدن موارد بیشتر، فیلترها را تغییر دهید."
+ },
"timeline": {
- "empty": "هنوز تسکی برای قرار دادن روی خط زمانی وجود ندارد.",
"expandGroup": "باز کردن گروه",
"collapseGroup": "جمع کردن گروه",
"inferredStart": "شروع استنباط‌شده از تاریخ ایجاد",
diff --git a/apps/web/messages/fr/workItems.json b/apps/web/messages/fr/workItems.json
index 61bf2b31..1546980c 100644
--- a/apps/web/messages/fr/workItems.json
+++ b/apps/web/messages/fr/workItems.json
@@ -67,8 +67,13 @@
"custom": "Tout a une date."
}
},
+ "empty": {
+ "title": "Aucun ticket",
+ "description": "Les tickets apparaîtront ici.",
+ "filteredTitle": "Aucun ticket correspondant",
+ "filteredDescription": "Modifiez les filtres pour en voir plus."
+ },
"timeline": {
- "empty": "Aucun ticket à placer sur la chronologie pour l'instant.",
"expandGroup": "Développer le groupe",
"collapseGroup": "Réduire le groupe",
"inferredStart": "Début déduit de la date de création",
diff --git a/apps/web/messages/id/workItems.json b/apps/web/messages/id/workItems.json
index 984fd7c7..c8e5bae1 100644
--- a/apps/web/messages/id/workItems.json
+++ b/apps/web/messages/id/workItems.json
@@ -67,8 +67,13 @@
"custom": "Semua memiliki tanggal."
}
},
+ "empty": {
+ "title": "Tidak ada issue",
+ "description": "Issue akan muncul di sini.",
+ "filteredTitle": "Tidak ada issue yang cocok",
+ "filteredDescription": "Ubah filter untuk melihat lebih banyak."
+ },
"timeline": {
- "empty": "Belum ada issue untuk ditempatkan di linimasa.",
"expandGroup": "Bentangkan grup",
"collapseGroup": "Ciutkan grup",
"inferredStart": "Tanggal mulai ditentukan dari tanggal dibuat",
diff --git a/apps/web/messages/ko/workItems.json b/apps/web/messages/ko/workItems.json
index 70aec90c..d246b897 100644
--- a/apps/web/messages/ko/workItems.json
+++ b/apps/web/messages/ko/workItems.json
@@ -67,8 +67,13 @@
"custom": "모든 이슈에 날짜가 있습니다."
}
},
+ "empty": {
+ "title": "이슈가 없습니다",
+ "description": "이슈가 여기에 표시됩니다.",
+ "filteredTitle": "일치하는 이슈가 없습니다",
+ "filteredDescription": "더 보려면 필터를 변경하세요."
+ },
"timeline": {
- "empty": "타임라인에 표시할 이슈가 아직 없습니다.",
"expandGroup": "그룹 펼치기",
"collapseGroup": "그룹 접기",
"inferredStart": "생성일을 기준으로 추정한 시작일",
diff --git a/apps/web/messages/pt-BR/workItems.json b/apps/web/messages/pt-BR/workItems.json
index fa73af37..f18fc97f 100644
--- a/apps/web/messages/pt-BR/workItems.json
+++ b/apps/web/messages/pt-BR/workItems.json
@@ -67,8 +67,13 @@
"custom": "Tudo tem data."
}
},
+ "empty": {
+ "title": "Nenhuma issue",
+ "description": "As issues aparecerão aqui.",
+ "filteredTitle": "Nenhuma issue corresponde",
+ "filteredDescription": "Altere os filtros para ver mais."
+ },
"timeline": {
- "empty": "Nenhuma issue para colocar na linha do tempo ainda.",
"expandGroup": "Expandir grupo",
"collapseGroup": "Recolher grupo",
"inferredStart": "Início inferido da data de criação",
diff --git a/apps/web/messages/ru/workItems.json b/apps/web/messages/ru/workItems.json
index 9a834606..90b0a7d0 100644
--- a/apps/web/messages/ru/workItems.json
+++ b/apps/web/messages/ru/workItems.json
@@ -67,8 +67,13 @@
"custom": "У всего есть дата."
}
},
+ "empty": {
+ "title": "Задач нет",
+ "description": "Задачи появятся здесь.",
+ "filteredTitle": "Нет подходящих задач",
+ "filteredDescription": "Измените фильтры, чтобы увидеть больше."
+ },
"timeline": {
- "empty": "Пока нет задач для таймлайна.",
"expandGroup": "Развернуть группу",
"collapseGroup": "Свернуть группу",
"inferredStart": "Начало выведено из даты создания",
diff --git a/apps/web/messages/tr/workItems.json b/apps/web/messages/tr/workItems.json
index d594a525..50cd0c37 100644
--- a/apps/web/messages/tr/workItems.json
+++ b/apps/web/messages/tr/workItems.json
@@ -67,8 +67,13 @@
"custom": "Tüm işlerin tarihi var."
}
},
+ "empty": {
+ "title": "İş yok",
+ "description": "İşler burada görünecek.",
+ "filteredTitle": "Eşleşen iş yok",
+ "filteredDescription": "Daha fazlasını görmek için filtreleri değiştirin."
+ },
"timeline": {
- "empty": "Zaman çizelgesine yerleştirilecek henüz iş yok.",
"expandGroup": "Grubu genişlet",
"collapseGroup": "Grubu daralt",
"inferredStart": "Başlangıç oluşturulma tarihine göre belirlendi",
diff --git a/apps/web/messages/uk/workItems.json b/apps/web/messages/uk/workItems.json
index b0ab1c0d..7f16dbf2 100644
--- a/apps/web/messages/uk/workItems.json
+++ b/apps/web/messages/uk/workItems.json
@@ -67,8 +67,13 @@
"custom": "Усе має дату."
}
},
+ "empty": {
+ "title": "Задач немає",
+ "description": "Задачі з’являться тут.",
+ "filteredTitle": "Немає відповідних задач",
+ "filteredDescription": "Змініть фільтри, щоб побачити більше."
+ },
"timeline": {
- "empty": "Ще немає задач для таймлайну.",
"expandGroup": "Розгорнути групу",
"collapseGroup": "Згорнути групу",
"inferredStart": "Початок виведено з дати створення",
diff --git a/apps/web/messages/zh-CN/workItems.json b/apps/web/messages/zh-CN/workItems.json
index 32b8f6b8..0d34c14e 100644
--- a/apps/web/messages/zh-CN/workItems.json
+++ b/apps/web/messages/zh-CN/workItems.json
@@ -67,8 +67,13 @@
"custom": "所有工作项都已设置日期。"
}
},
+ "empty": {
+ "title": "暂无工作项",
+ "description": "工作项会显示在这里。",
+ "filteredTitle": "没有匹配的工作项",
+ "filteredDescription": "修改筛选条件以查看更多。"
+ },
"timeline": {
- "empty": "暂无可放入时间线的工作项。",
"expandGroup": "展开分组",
"collapseGroup": "折叠分组",
"inferredStart": "根据创建日期推算开始时间",
diff --git a/apps/web/messages/zh-TW/workItems.json b/apps/web/messages/zh-TW/workItems.json
index 4dac207f..280cc7a9 100644
--- a/apps/web/messages/zh-TW/workItems.json
+++ b/apps/web/messages/zh-TW/workItems.json
@@ -67,8 +67,13 @@
"custom": "所有工作項目都已設定日期。"
}
},
+ "empty": {
+ "title": "暫無工作項目",
+ "description": "工作項目會顯示在這裡。",
+ "filteredTitle": "沒有符合的工作項目",
+ "filteredDescription": "修改篩選條件以查看更多。"
+ },
"timeline": {
- "empty": "暫無可放入時間軸的工作項目。",
"expandGroup": "展開分組",
"collapseGroup": "摺疊分組",
"inferredStart": "根據建立日期推算開始時間",
diff --git a/apps/web/src/features/work-items/WorkItemsPage.tsx b/apps/web/src/features/work-items/WorkItemsPage.tsx
index a5fc8bda..53093f4f 100644
--- a/apps/web/src/features/work-items/WorkItemsPage.tsx
+++ b/apps/web/src/features/work-items/WorkItemsPage.tsx
@@ -30,6 +30,7 @@ import KanbanBoard from './components/kanban/KanbanBoard';
import TableView from './components/table/TableView';
import TimelineView from './components/timeline/TimelineView';
import CalendarView from './components/calendar/CalendarView';
+import { WorkItemsEmpty } from './components/shared/WorkItemsEmpty';
interface TimelineCollapseState {
scope: string;
@@ -142,6 +143,9 @@ export default function WorkItemsPage() {
/>
);
case 'timeline':
+ if (viewProps.project.issues.length === 0) {
+ return <WorkItemsEmpty filters={editor.effectiveFilters} />;
+ }
return (
<TimelineView
{...viewProps}
diff --git a/apps/web/src/features/work-items/components/BoardLayout.tsx b/apps/web/src/features/work-items/components/BoardLayout.tsx
index 66428516..f3552d24 100644
--- a/apps/web/src/features/work-items/components/BoardLayout.tsx
+++ b/apps/web/src/features/work-items/components/BoardLayout.tsx
@@ -8,6 +8,7 @@ import KanbanBoard from './kanban/KanbanBoard';
import TableView from './table/TableView';
import TimelineView from './timeline/TimelineView';
import CalendarView from './calendar/CalendarView';
+import { WorkItemsEmpty } from './shared/WorkItemsEmpty';
interface BoardLayoutProps extends WorkItemsViewProps {
view: WorkItemsView;
@@ -44,6 +45,9 @@ export default function BoardLayout({
case 'table':
return <TableView {...layoutProps} widthScope={widthScope} />;
case 'timeline':
+ if (layoutProps.project.issues.length === 0) {
+ return <WorkItemsEmpty filters={layoutProps.filters} />;
+ }
return <TimelineView {...layoutProps} />;
case 'calendar':
return <CalendarView {...layoutProps} />;
diff --git a/apps/web/src/features/work-items/components/kanban/KanbanBoard.tsx b/apps/web/src/features/work-items/components/kanban/KanbanBoard.tsx
index de161692..2009131c 100644
--- a/apps/web/src/features/work-items/components/kanban/KanbanBoard.tsx
+++ b/apps/web/src/features/work-items/components/kanban/KanbanBoard.tsx
@@ -1,6 +1,7 @@
import { useMemo } from 'react';
import { type WorkItemsViewProps } from '@/utils/project';
import { SelectionProvider } from '../../context/useSelection';
+import { WorkItemsEmpty } from '../shared/WorkItemsEmpty';
import FlatBoard from './FlatBoard';
import SwimlaneBoard from './SwimlaneBoard';
import { BulkActionBar } from './BulkActionBar';
@@ -16,6 +17,10 @@ export default function KanbanBoard(props: WorkItemsViewProps) {
[props.project.issues],
);
+ if (props.project.issues.length === 0 && !props.settings.showEmptyGroups) {
+ return <WorkItemsEmpty filters={props.filters} />;
+ }
+
return (
<SelectionProvider validIds={validIds}>
{props.settings.subgroup === 'none' ? <FlatBoard {...props} /> : <SwimlaneBoard {...props} />}
diff --git a/apps/web/src/features/work-items/components/public/ReadOnlyBoard.tsx b/apps/web/src/features/work-items/components/public/ReadOnlyBoard.tsx
index d4c5bf0b..5b32ed74 100644
--- a/apps/web/src/features/work-items/components/public/ReadOnlyBoard.tsx
+++ b/apps/web/src/features/work-items/components/public/ReadOnlyBoard.tsx
@@ -1,5 +1,5 @@
import type { SharedViewBundle } from '@/lib/api/endpoints/share';
-import { defaultViewSettings } from '@/utils/viewSettings';
+import { normalizeSavedDisplay } from '@/utils/viewSettings';
import { EMPTY_FILTER_SET } from '@/utils/filters';
import { type WorkItemsViewProps } from '@/utils/project';
import { toPublicProjectDetail } from '@/utils/publicProject';
@@ -20,9 +20,7 @@ export default function ReadOnlyBoard({
onOpenIssue: (id: number) => void;
}) {
const project = toPublicProjectDetail(bundle.project, bundle.issues);
- const layout = bundle.view.display.layout ?? 'kanban';
- const { layout: _omit, ...displaySettings } = bundle.view.display;
- const settings = { ...defaultViewSettings(layout), ...displaySettings };
+ const { layout, ...settings } = normalizeSavedDisplay(bundle.view.display);
const viewProps: WorkItemsViewProps = {
project,
diff --git a/apps/web/src/features/work-items/components/shared/WorkItemsEmpty.tsx b/apps/web/src/features/work-items/components/shared/WorkItemsEmpty.tsx
new file mode 100644
index 00000000..626a14b3
--- /dev/null
+++ b/apps/web/src/features/work-items/components/shared/WorkItemsEmpty.tsx
@@ -0,0 +1,16 @@
+import { useTranslations } from 'next-intl';
+import { isActiveFilterSet, type FilterSet } from '@/utils/filters';
+import { EmptyState } from '@/components/common/page/EmptyState';
+
+export function WorkItemsEmpty({ filters }: { filters: FilterSet }) {
+ const t = useTranslations('workItems.empty');
+ const filtered = isActiveFilterSet(filters);
+ return (
+ <div className="flex h-full flex-col">
+ <EmptyState
+ title={filtered ? t('filteredTitle') : t('title')}
+ description={filtered ? t('filteredDescription') : t('description')}
+ />
+ </div>
+ );
+}
diff --git a/apps/web/src/features/work-items/components/table/TableView.tsx b/apps/web/src/features/work-items/components/table/TableView.tsx
index 3543cdcb..fa5f0dfd 100644
--- a/apps/web/src/features/work-items/components/table/TableView.tsx
+++ b/apps/web/src/features/work-items/components/table/TableView.tsx
@@ -21,6 +21,7 @@ import {
type FlatItem,
} from '../../utils/table';
import { IssueDragOverlay } from '../shared/IssueDragOverlay';
+import { WorkItemsEmpty } from '../shared/WorkItemsEmpty';
import { TableColumnHeader } from './TableColumnHeader';
import { TableSectionHeader } from './TableSectionHeader';
import { TableSubHeader } from './TableSubHeader';
@@ -142,6 +143,8 @@ export default function TableView({
}
}
+ if (items.length === 0) return <WorkItemsEmpty filters={filters} />;
+
return (
<DndContext
sensors={reorder.sensors}
diff --git a/apps/web/src/features/work-items/components/timeline/TimelineView.tsx b/apps/web/src/features/work-items/components/timeline/TimelineView.tsx
index f3fe325e..2f0a77c3 100644
--- a/apps/web/src/features/work-items/components/timeline/TimelineView.tsx
+++ b/apps/web/src/features/work-items/components/timeline/TimelineView.tsx
@@ -1,6 +1,5 @@
import { useRef, useState } from 'react';
import { DndContext } from '@dnd-kit/core';
-import { useTranslations } from 'next-intl';
import { buildMaps, issueColor, type WorkItemsViewProps } from '@/utils/project';
import { usePermissions } from '@/hooks/usePermissions';
import { useGroupLabels } from '@/hooks/useGroupLabels';
@@ -40,7 +39,6 @@ export default function TimelineView({
viewId,
readOnly,
}: TimelineViewProps) {
- const t = useTranslations('workItems.timeline');
const { can } = usePermissions(project);
const groupLabels = useGroupLabels();
const barsReadOnly = readOnly || !can('work_items', 'edit');
@@ -117,10 +115,6 @@ export default function TimelineView({
/>
{!narrow && <TimelineLabelResizer labelW={titleW} onResize={setTitleWidth} />}
- {rows.length === 0 && (
- <div className="p-8 text-center text-sm text-muted-foreground">{t('empty')}</div>
- )}
-
{rows.map((row) => {
if (row.kind === 'group') {
return (
diff --git a/apps/web/src/utils/viewSettings.test.ts b/apps/web/src/utils/viewSettings.test.ts
new file mode 100644
index 00000000..378328d1
--- /dev/null
+++ b/apps/web/src/utils/viewSettings.test.ts
@@ -0,0 +1,31 @@
+import assert from 'node:assert/strict';
+import { describe, it } from 'node:test';
+import { defaultViewSettings, normalizeSavedDisplay } from './viewSettings';
+
+describe('normalizeSavedDisplay', () => {
+ it('falls back to the kanban defaults for a display that is not an object', () => {
+ for (const blob of [null, undefined, 'kanban', 42, []]) {
+ assert.deepEqual(normalizeSavedDisplay(blob), {
+ layout: 'kanban',
+ ...defaultViewSettings('kanban'),
+ });
+ }
+ });
+
+ it('falls back to kanban for an unknown layout', () => {
+ assert.equal(normalizeSavedDisplay({ layout: 'board' }).layout, 'kanban');
+ });
+
+ it('keeps a known layout and its valid settings', () => {
+ const display = normalizeSavedDisplay({ layout: 'table', showEmptyGroups: false });
+ assert.equal(display.layout, 'table');
+ assert.equal(display.showEmptyGroups, false);
+ });
+
+ it('forces a non-boolean flag to its default', () => {
+ assert.equal(
+ normalizeSavedDisplay({ layout: 'kanban', showEmptyGroups: 'yes' }).showEmptyGroups,
+ defaultViewSettings('kanban').showEmptyGroups,
+ );
+ });
+});