⭐️⭐️⭐️ 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
feat(web): pin one column on the board layout (#203)
Croff23aebe1de7ed
diff --git a/apps/web/messages/ar/workItems.json b/apps/web/messages/ar/workItems.jsonindex fb33e5f6..22f92931 100644--- a/apps/web/messages/ar/workItems.json+++ b/apps/web/messages/ar/workItems.json@@ -1,5 +1,7 @@{"newIssue": "مهمة جديدة",+ "pin": "تثبيت",+ "unpin": "إلغاء التثبيت","collapse": "طيّ","expand": "توسيع","hide": "إخفاء",diff --git a/apps/web/messages/en/workItems.json b/apps/web/messages/en/workItems.jsonindex d8176cf5..c9d63f6f 100644--- a/apps/web/messages/en/workItems.json+++ b/apps/web/messages/en/workItems.json@@ -1,5 +1,7 @@{"newIssue": "New issue",+ "pin": "Pin",+ "unpin": "Unpin","collapse": "Collapse","expand": "Expand","hide": "Hide",diff --git a/apps/web/messages/ru/workItems.json b/apps/web/messages/ru/workItems.jsonindex 72af0d74..6ff9a827 100644--- a/apps/web/messages/ru/workItems.json+++ b/apps/web/messages/ru/workItems.json@@ -1,5 +1,7 @@{"newIssue": "Новая задача",+ "pin": "Закрепить",+ "unpin": "Открепить","collapse": "Свернуть","expand": "Развернуть","hide": "Скрыть",diff --git a/apps/web/messages/uk/workItems.json b/apps/web/messages/uk/workItems.jsonindex 536aa811..ded625c6 100644--- a/apps/web/messages/uk/workItems.json+++ b/apps/web/messages/uk/workItems.json@@ -1,5 +1,7 @@{"newIssue": "Нова задача",+ "pin": "Закріпити",+ "unpin": "Відкріпити","collapse": "Згорнути","expand": "Розгорнути","hide": "Сховати",diff --git a/apps/web/messages/zh-CN/workItems.json b/apps/web/messages/zh-CN/workItems.jsonindex d458bca2..72c51632 100644--- a/apps/web/messages/zh-CN/workItems.json+++ b/apps/web/messages/zh-CN/workItems.json@@ -1,5 +1,7 @@{"newIssue": "新建工作项",+ "pin": "固定",+ "unpin": "取消固定","collapse": "折叠","expand": "展开","hide": "隐藏",diff --git a/apps/web/src/app/globals.css b/apps/web/src/app/globals.cssindex a6a5eb6b..b91d8938 100644--- a/apps/web/src/app/globals.css+++ b/apps/web/src/app/globals.css@@ -44,6 +44,9 @@--color-foreground: var(--foreground);--color-background: var(--background);--color-kanban-column: var(--kanban-column);+ --color-kanban-column-raised: var(--kanban-column-raised);+ --color-kanban-column-wip-destructive: var(--kanban-column-wip-destructive);+ --color-kanban-column-wip-warning: var(--kanban-column-wip-warning);--radius-sm: calc(var(--radius) * 0.6);--radius-md: calc(var(--radius) * 0.8);--radius-lg: var(--radius);@@ -108,6 +111,9 @@--priority-high: #f97316;--priority-urgent: #f2683c;--kanban-column: oklch(0.945 0 0);+ --kanban-column-raised: oklch(0.958 0 0);+ --kanban-column-wip-destructive: oklch(0.923 0.011 27);+ --kanban-column-wip-warning: oklch(0.926 0.007 75);--kanban-card: oklch(0.972 0 0);--kanban-card-hover: oklch(0.995 0 0);--kanban-card-blocked: oklch(0.969 0.008 25);@@ -116,6 +122,7 @@--row-blocked-hover: oklch(0.968 0.013 25);--kanban-card-selected: oklch(0.925 0.04 265);--overlay-shadow: 0 12px 28px -8px rgb(0 0 0 / 0.18), 0 4px 10px -4px rgb(0 0 0 / 0.1);+ --pinned-column-shadow: 0 0 18px 2px rgb(0 0 0 / 0.16);--modal-shadow: 0 32px 64px -16px rgb(0 0 0 / 0.28), 0 12px 24px -12px rgb(0 0 0 / 0.16);}@@ -157,6 +164,9 @@--priority-high: #f97316;--priority-urgent: #f2683c;--kanban-column: oklch(0.16 0 0);+ --kanban-column-raised: oklch(0.19 0 0);+ --kanban-column-wip-destructive: oklch(0.191 0.009 22);+ --kanban-column-wip-warning: oklch(0.193 0.007 80);--kanban-card: oklch(0.215 0 0);--kanban-card-hover: oklch(0.25 0 0);--kanban-card-blocked: oklch(0.222 0.012 25);@@ -165,6 +175,7 @@--row-blocked-hover: oklch(0.23 0.016 25);--kanban-card-selected: oklch(0.31 0.07 266);--overlay-shadow: 0 18px 40px -12px rgb(0 0 0 / 0.7), 0 6px 16px -6px rgb(0 0 0 / 0.55);+ --pinned-column-shadow: 0 0 20px 4px rgb(0 0 0 / 0.6);--modal-shadow: 0 40px 80px -20px rgb(0 0 0 / 0.85), 0 16px 32px -16px rgb(0 0 0 / 0.7);}diff --git a/apps/web/src/features/work-items/components/kanban/BoardColumn.tsx b/apps/web/src/features/work-items/components/kanban/BoardColumn.tsxindex 505e36cd..d5abd3b0 100644--- a/apps/web/src/features/work-items/components/kanban/BoardColumn.tsx+++ b/apps/web/src/features/work-items/components/kanban/BoardColumn.tsx@@ -1,7 +1,7 @@import { useCallback, useRef } from 'react';import { useDroppable } from '@dnd-kit/core';import { useVirtualizer } from '@tanstack/react-virtual';-import { ChevronsRightLeft, EyeOff, Plus } from 'lucide-react';+import { ChevronsRightLeft, EyeOff, Pin, PinOff, Plus } from 'lucide-react';import { useTranslations } from 'next-intl';import { type ProjectDetail, type BoardIssue } from '@/lib/api';import { type Maps, type IssueGroup } from '@/utils/project';@@ -16,7 +16,7 @@ import { DropLine } from '../shared/DropLine';import { SelectAllToggle } from './SelectAllToggle';import { useIsOverContainer } from '../../hooks/useIsOverContainer';import { useIncomingCount } from '../../hooks/useIncomingCount';-import { COLUMN_WIDTH } from '../../utils/kanban';+import { COLUMN_WIDTH, PINNED_COLUMN } from '../../utils/kanban';import { wipAllows, wipFullColor, WIP_FULL_TINT, type WipState } from '../../utils/wipLimit';import { WipCount } from './WipCount';@@ -42,6 +42,8 @@ export function BoardColumn({onAddIssue,onHide,onCollapse,+ pinned,+ onTogglePin,wip,filtered,boardIssues,@@ -62,6 +64,8 @@ export function BoardColumn({onAddIssue: () => void;onHide: () => void;onCollapse: () => void;+ pinned: boolean;+ onTogglePin: () => void;// The column's WIP limit, or null when it has none or this board is not grouped// by status. `filtered` says whether the cards shown are a subset of the column.wip: WipState | null;@@ -111,11 +115,12 @@ export function BoardColumn({<divclassName={cn('group/column flex h-full shrink-0 flex-col rounded-md bg-kanban-column px-3 py-2',+ pinned && PINNED_COLUMN,wip?.full && WIP_FULL_TINT[wipFullColor(wip)],)}style={{ width: COLUMN_WIDTH }}>- {/* Stop header clicks (select-all, collapse, hide, add) from reaching the+ {/* Stop header clicks (select-all, pin, collapse, hide, add) from reaching theboard background, which clears the selection. */}<div className="mb-2 flex items-center justify-between" onClick={(e) => e.stopPropagation()}><div className="flex items-center gap-2 text-sm font-medium text-foreground">@@ -125,6 +130,15 @@ export function BoardColumn({</div><div className="flex items-center gap-1">{!readOnly && <SelectAllToggle ids={issues.map((i) => i.id)} />}+ <Button+ variant="ghost"+ size="icon"+ className="hidden size-6 text-muted-foreground md:inline-flex"+ onClick={onTogglePin}+ title={pinned ? t('unpin') : t('pin')}+ >+ {pinned ? <PinOff /> : <Pin />}+ </Button><Buttonvariant="ghost"size="icon"@@ -159,7 +173,10 @@ export function BoardColumn({<divref={mergedRef}- className={cn('min-h-0 flex-1 overflow-y-auto rounded-md', isOverColumn && 'bg-accent/40')}+ className={cn(+ 'min-h-0 flex-1 overflow-y-auto rounded-md',+ isOverColumn && 'bg-kanban-column-raised',+ )}><divstyle={{diff --git a/apps/web/src/features/work-items/components/kanban/CollapsedColumn.tsx b/apps/web/src/features/work-items/components/kanban/CollapsedColumn.tsxindex 136c110f..8820dea9 100644--- a/apps/web/src/features/work-items/components/kanban/CollapsedColumn.tsx+++ b/apps/web/src/features/work-items/components/kanban/CollapsedColumn.tsx@@ -1,10 +1,11 @@-import { ChevronsLeftRight, Plus } from 'lucide-react';+import { ChevronsLeftRight, Pin, PinOff, Plus } from 'lucide-react';import { useTranslations } from 'next-intl';import { type IssueGroup } from '@/utils/project';import { usePermissions } from '@/hooks/usePermissions';import { cn } from '@/lib/utils';import { Button } from '@/components/ui/button';import { GroupDot } from '../shared/GroupDot';+import { PINNED_COLUMN } from '../../utils/kanban';import { type WipState, WIP_FULL_TEXT, wipFullColor } from '../../utils/wipLimit';// A column collapsed to a narrow vertical strip. It stays in place (in column@@ -14,7 +15,9 @@ export function CollapsedColumn({group,count,wip,+ pinned,onExpand,+ onTogglePin,onAddIssue,readOnly,}: {@@ -23,7 +26,9 @@ export function CollapsedColumn({// The column's WIP limit, or null when it has none. The strip is too narrow for// the full `count / max`, so a full column only colours its count.wip: WipState | null;+ pinned: boolean;onExpand: () => void;+ onTogglePin: () => void;onAddIssue: () => void;// In a read-only share the add affordance is hidden.readOnly?: boolean;@@ -32,7 +37,12 @@ export function CollapsedColumn({const { can } = usePermissions();const canCreateIssue = can('work_items', 'create') && !readOnly;return (- <div className="flex h-full w-10 shrink-0 flex-col items-center gap-2 rounded-md bg-kanban-column py-2">+ <div+ className={cn(+ 'flex h-full w-10 shrink-0 flex-col items-center gap-2 rounded-md bg-kanban-column py-2',+ pinned && PINNED_COLUMN,+ )}+ ><Buttonvariant="ghost"size="icon"@@ -42,6 +52,15 @@ export function CollapsedColumn({><ChevronsLeftRight /></Button>+ <Button+ variant="ghost"+ size="icon"+ className="hidden size-6 text-muted-foreground md:inline-flex"+ onClick={onTogglePin}+ title={pinned ? t('unpin') : t('pin')}+ >+ {pinned ? <PinOff /> : <Pin />}+ </Button>{canCreateIssue && (<Buttonvariant="ghost"diff --git a/apps/web/src/features/work-items/components/kanban/FlatBoard.tsx b/apps/web/src/features/work-items/components/kanban/FlatBoard.tsxindex e080089a..648a1f46 100644--- a/apps/web/src/features/work-items/components/kanban/FlatBoard.tsx+++ b/apps/web/src/features/work-items/components/kanban/FlatBoard.tsx@@ -57,6 +57,8 @@ export default function FlatBoard({hiddenGroups: hide? [...settings.hiddenGroups, key]: settings.hiddenGroups.filter((k) => k !== key),+ // A hidden column is off the board, so it cannot stay pinned.+ pinnedGroup: hide && settings.pinnedGroup === key ? null : settings.pinnedGroup,});// Collapsed columns stay in place as a narrow strip; the state lives in the@@ -71,6 +73,10 @@ export default function FlatBoard({: settings.collapsedGroups.filter((k) => k !== key),});+ // At most one column is pinned; it persists the same way as the two sets above.+ const togglePin = (key: string) =>+ onSettingsChange({ ...settings, pinnedGroup: settings.pinnedGroup === key ? null : key });+const groups = buildGroups(project, settings.group, groupLabels, filters);const sorted = sortIssues(project.issues, settings.sort, project);const issuesByGroup = groupIssues(groups, sorted, settings.group);@@ -84,6 +90,13 @@ export default function FlatBoard({const visibleGroups = baseGroups.filter((g) => !hiddenSet.has(g.key));const hiddenGroups = baseGroups.filter((g) => hiddenSet.has(g.key));+ // The pinned column renders first. A key that names no group on the board+ // (another grouping field, a since-deleted column) pins nothing.+ const pinnedGroup = visibleGroups.find((g) => g.key === settings.pinnedGroup) ?? null;+ const orderedGroups = pinnedGroup+ ? [pinnedGroup, ...visibleGroups.filter((g) => g !== pinnedGroup)]+ : visibleGroups;+// Reordering inside a column only holds when the view is ordered manually: with// any other sort field the card would snap back to where the sort puts it. Cards// already in the target column are then skipped, and a drop left with nothing to@@ -131,14 +144,16 @@ export default function FlatBoard({className="flex h-full gap-3 overflow-x-auto p-4"onClick={() => selection.isSelecting && selection.clear()}>- {visibleGroups.map((group) =>+ {orderedGroups.map((group) =>collapsedSet.has(group.key) ? (<CollapsedColumnkey={group.key}group={group}count={issuesByGroup.get(group.key)?.length ?? 0}wip={wipOf(group)}+ pinned={group === pinnedGroup}onExpand={() => setCollapsed(group.key, false)}+ onTogglePin={() => togglePin(group.key)}onAddIssue={() => addIssueTo(group)}readOnly={readOnly}/>@@ -159,6 +174,8 @@ export default function FlatBoard({onAddIssue={() => addIssueTo(group)}onHide={() => setHidden(group.key, true)}onCollapse={() => setCollapsed(group.key, true)}+ pinned={group === pinnedGroup}+ onTogglePin={() => togglePin(group.key)}readOnly={readOnly}/>),diff --git a/apps/web/src/features/work-items/components/kanban/SwimlaneCell.tsx b/apps/web/src/features/work-items/components/kanban/SwimlaneCell.tsxindex 5d90d8ee..2b924607 100644--- a/apps/web/src/features/work-items/components/kanban/SwimlaneCell.tsx+++ b/apps/web/src/features/work-items/components/kanban/SwimlaneCell.tsx@@ -47,7 +47,7 @@ export function SwimlaneCell({ref={setNodeRef}className={cn('min-h-16 shrink-0 rounded-md bg-kanban-column px-3 py-2',- isOverCell && 'bg-accent/40',+ isOverCell && 'bg-kanban-column-raised',)}style={{ width: COLUMN_WIDTH }}>diff --git a/apps/web/src/features/work-items/utils/kanban.ts b/apps/web/src/features/work-items/utils/kanban.tsindex 989df88e..97f1dc8e 100644--- a/apps/web/src/features/work-items/utils/kanban.ts+++ b/apps/web/src/features/work-items/utils/kanban.ts@@ -36,6 +36,12 @@ export function issuesToMove(// the column header row lines up with the cells below it.export const COLUMN_WIDTH = 348;+// A full column's WIP tint still wins over this background: BoardColumn passes it+// to cn() after this one. Below the mobile breakpoint one column already fills the+// screen, so the pinned one only leads the column order there.+export const PINNED_COLUMN =+ 'md:sticky md:start-0 md:z-10 bg-kanban-column-raised shadow-[var(--pinned-column-shadow)]';+export const boardCollision = preferPrefix('card:');// Collapsed swimlanes are a per-project, per-swimlane-field client-only preference,diff --git a/apps/web/src/features/work-items/utils/wipLimit.ts b/apps/web/src/features/work-items/utils/wipLimit.tsindex 25b74107..53252867 100644--- a/apps/web/src/features/work-items/utils/wipLimit.ts+++ b/apps/web/src/features/work-items/utils/wipLimit.ts@@ -51,9 +51,11 @@ export const WIP_FULL_TEXT: Record<WipFullColor, string> = {warning: 'text-warning',};+// Opaque, not a translucent tint: a pinned column is sticky, and the columns+// scrolling behind it would show through.export const WIP_FULL_TINT: Record<WipFullColor, string> = {- destructive: 'bg-destructive/5',- warning: 'bg-warning/5',+ destructive: 'bg-kanban-column-wip-destructive',+ warning: 'bg-kanban-column-wip-warning',};// Whether `incoming` more issues may enter the column. Only a hard limit refuses;diff --git a/apps/web/src/utils/viewSettings.ts b/apps/web/src/utils/viewSettings.tsindex 04425d5d..a3020cbb 100644--- a/apps/web/src/utils/viewSettings.ts+++ b/apps/web/src/utils/viewSettings.ts@@ -144,6 +144,9 @@ export interface ViewSettings {// hiddenGroups, empty for every other layout, and part of the display so each// saved view keeps its own collapsed set.collapsedGroups: string[];+ // Group key of the column pinned to the start edge of the flat project, or null+ // when none is. Namespaced like hiddenGroups, and null for every other layout.+ pinnedGroup: string | null;}const DEFAULT_SORT: Sort = { field: 'manual', dir: 'asc' };@@ -160,6 +163,7 @@ const COMMON: Omit<ViewSettings, 'group' | 'subgroup' | 'properties' | 'sort'> =weekStart: 0,hiddenGroups: [],collapsedGroups: [],+ pinnedGroup: null,};// The properties shown by default per view; the Timeline and Calendar lay issues@@ -299,6 +303,7 @@ export function normalizeViewSettings(collapsedGroups: Array.isArray(s.collapsedGroups)? (s.collapsedGroups as unknown[]).filter((x): x is string => typeof x === 'string'): d.collapsedGroups,+ pinnedGroup: typeof s.pinnedGroup === 'string' ? s.pinnedGroup : d.pinnedGroup,};}