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.

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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.css
index 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.tsx
index 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({
<div
className={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 the
board 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>
<Button
variant="ghost"
size="icon"
@@ -159,7 +173,10 @@ export function BoardColumn({
<div
ref={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',
+ )}
>
<div
style={{
diff --git a/apps/web/src/features/work-items/components/kanban/CollapsedColumn.tsx b/apps/web/src/features/work-items/components/kanban/CollapsedColumn.tsx
index 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,
+ )}
+ >
<Button
variant="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 && (
<Button
variant="ghost"
diff --git a/apps/web/src/features/work-items/components/kanban/FlatBoard.tsx b/apps/web/src/features/work-items/components/kanban/FlatBoard.tsx
index 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) ? (
<CollapsedColumn
key={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.tsx
index 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.ts
index 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.ts
index 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.ts
index 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,
};
}