⭐️⭐️⭐️ 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.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
'use client';
import { useEffect, useMemo } from 'react';
import { useParams, useRouter } from 'next/navigation';
import { useShellRoute } from '@/hooks/useShellRoute';
import { useTranslations } from 'next-intl';
import { useQueryClient } from '@tanstack/react-query';
import { ReactFlowProvider } from '@xyflow/react';
import { useShell } from '@/context/shellContext';
import { ApiError } from '@/lib/api/core/client';
import { usePermissions } from '@/hooks/usePermissions';
import { titlePath, useDocumentTitle } from '@/hooks/useDocumentTitle';
import { notePath, notesPath } from '@/utils/paths';
import { qk } from '@/services/queryKeys';
import { Skeleton } from '@/components/ui/skeleton';
import {
useNoteBoardSearch,
useNoteBoardQuery,
useCreateNoteBoard,
useRenameNoteBoard,
useDeleteNoteBoard,
} from './services/noteBoards.service';
import { useNoteBoardMru, type MruEntry } from './hooks/useNoteBoardMru';
import type { NewBoardVisibility } from './utils/visibility';
import NoteBoardBar from './components/NoteBoardBar';
import NoteCanvas from './components/NoteCanvas';
import NotesEmptyState from './components/NotesEmptyState';
// The maximum number of tabs shown (matches the MRU cap).
const MAX_TABS = 5;
// The notes section: a tab strip of boards over a freeform canvas of sticky notes.
// The active board comes from the route, falling back to the first tab. The tabs
// are the recently-used boards, topped up from the first page of the switcher list
// when fewer than MAX_TABS have been opened. Opening a board loads it fresh (its
// full canvas) and moves it to the front.
export default function NotesPage() {
const { project } = useShell();
const params = useParams<{ boardId?: string }>();
const router = useRouter();
const qc = useQueryClient();
const projectKey = useShellRoute().projectKey ?? '';
const t = useTranslations('notes');
const { can } = usePermissions();
const { entries: mru, record, remove: removeMru } = useNoteBoardMru(projectKey);
// The switcher's unfiltered list, reused to top up the tabs and sharing its cache.
const seedQuery = useNoteBoardSearch(projectKey, '');
const createBoard = useCreateNoteBoard(projectKey);
const renameBoard = useRenameNoteBoard(projectKey);
const deleteBoard = useDeleteNoteBoard(projectKey);
const tabs = useMemo<MruEntry[]>(() => {
const result = [...mru];
const seen = new Set(mru.map((e) => e.id));
for (const b of seedQuery.data ?? []) {
if (result.length >= MAX_TABS) break;
if (seen.has(b.id)) continue;
result.push({ id: b.id, name: b.name, visibility: b.visibility });
seen.add(b.id);
}
return result;
}, [mru, seedQuery.data]);
const routeId = params.boardId ? Number(params.boardId) : null;
const activeBoardId = routeId ?? tabs[0]?.id ?? null;
const { data: activeBoard, isError, error } = useNoteBoardQuery(projectKey, activeBoardId);
useDocumentTitle(titlePath(project?.project.name, !isError && activeBoard?.name));
// Record the opened board as most-recent once it loads. Also refreshes its cached
// tab label and visibility, healing a stale MRU entry (renamed elsewhere).
useEffect(() => {
if (activeBoard) {
record({ id: activeBoard.id, name: activeBoard.name, visibility: activeBoard.visibility });
}
}, [activeBoard, record]);
// A board that is gone or no longer accessible: drop it from the MRU tabs, drop
// it from the switcher lists (it may still be in a stale seed page), and fall
// back to the board list.
useEffect(() => {
if (isError && error instanceof ApiError && error.status === 404 && activeBoardId != null) {
removeMru(activeBoardId);
void qc.invalidateQueries({ queryKey: [...qk.noteBoardsForProject(projectKey), 'search'] });
router.replace(notesPath(projectKey));
}
}, [isError, error, activeBoardId, removeMru, qc, router, projectKey]);
if (!project || seedQuery.isLoading) {
return (
<div className="flex-1 space-y-4 p-6">
<Skeleton className="h-8 w-full max-w-md" />
<Skeleton className="h-96 w-full" />
</div>
);
}
if (!can('note_boards', 'read')) {
return (
<div className="flex h-full items-center justify-center px-4 text-center text-sm text-muted-foreground">
{t('noAccess')}
</div>
);
}
async function create(name: string, visibility: NewBoardVisibility) {
const board = await createBoard.mutateAsync({ name, visibility });
router.push(notePath(projectKey, board.id));
}
function remove(boardId: number) {
deleteBoard.mutate(boardId, {
onSuccess: () => {
removeMru(boardId);
if (boardId === activeBoardId) router.push(notesPath(projectKey));
},
});
}
function renderContent() {
if (activeBoard) {
return (
<ReactFlowProvider key={activeBoard.id}>
<NoteCanvas projectKey={projectKey} board={activeBoard} />
</ReactFlowProvider>
);
}
// A board is selected but its canvas is still loading.
if (activeBoardId != null && !isError) {
return <Skeleton className="m-6 flex-1" />;
}
return <NotesEmptyState projectKey={projectKey} onCreate={create} />;
}
return (
<div className="flex flex-1 flex-col overflow-hidden">
<NoteBoardBar
projectKey={projectKey}
tabs={tabs}
activeBoardId={activeBoardId}
onSelect={(id) => router.push(notePath(projectKey, id))}
onCreate={create}
onRename={(id, name) => renameBoard.mutate({ boardId: id, name })}
onDelete={remove}
/>
{renderContent()}
</div>
);
}