Scope and default
The Tasks board header belongs to the shared board UI used by Web and Tasks. Project Tasks tabs reuse the header with project-specific actions. A new board view starts on Kanban with all lists, no people or project selection, no search and no explicit sort. Saved board view, people, project and priority-sort choices can restore on return; search is not saved. Removed label, priority-value, date, estimate and source filters do not restore from saved settings or another viewer.Three rows
The first row has the board breadcrumb/picker (and the sprint, when the board has sprints) on the left; presence avatars, Share, New task and More on the right. The second row has Plan | Board (sprint boards only) and search on the left, then priority Sort and View on the right. Searching from Timeline switches to List so results can be shown. View offers the views available on that surface: Kanban, List, Timeline, My Tasks, Drafts and Recycle bin. The third row has the people pills, Project and Focus, then Clear when filters are active. The rows never wrap, so nothing moves up or down as the header narrows (for example when the side panel opens or is resized). Lower-priority parts hide or drop to icons instead, in this order: sprint dates, presence, the Share, Sort and View labels, the Project and Focus labels, people names (the avatar stays, with the name on hover), every person after the first two (moved into the “+N” menu), the Plan, Board and sprint-progress text, dropdown chevrons, and last the New task label. Every control keeps its accessible name when its label hides.People and projects
People pills use only the current workspace’s member roster. Task assignees never add people to this roster, including on personal boards containing tasks from other workspaces. A personal workspace offers its owner and Unassigned. Cross-workspace tasks remain visible under their existing access rules; their co-assignees do not become people filter options. Your pill comes first, followed by task count and name. Five people are visible; the rest are in the overflow menu. Picking only yourself means Mine. Adding another person changes the selection to those people together; it must not keep an additional Mine restriction. Unassigned and named people exclude each other. Project allows one or more workspace projects and excludes deleted projects. People, Unassigned and project counts describe the unfiltered board tasks, not the current filtered result. Counts stay hidden while any list has unvisited, loading or remaining pages. Member and project options remain usable, including Unassigned when no loaded task is unassigned yet. Applying another viewer’s filters keeps only the header’s supported choices. Mine is relative to the receiving viewer and is enabled only when that viewer is the sole selected assignee. Legacy source, label, date, estimate and priority-value restrictions cannot silently narrow the joined view.Focus and sorting
Focus shows your open tasks, highest priority first. Open includes Not started, Active and Review lists, and excludes Done and Closed. It selects you alone, clears Unassigned and the Project selection, and keeps the current search. Clicking an active Focus again removes its people restriction, open-list scope and priority sort. Clear resets the filters, search and sort while preserving the empty-list display preference. A filtered-empty project Tasks tab retains the header and Clear so the viewer can recover. Sort offers only highest priority first, lowest priority first, and clearing the sort to return to the board’s normal order. It does not offer due-date, name, creation-date or estimate sorting. Filters, search and sort on the board’s own tasks run in the browser. The first one loads an unfiltered copy of the board once (all its pages, a few at a time), or uses the board cache when every list (and, on a personal board, the external tasks column) is already loaded; every later filter, search or sort change, and the per-list counts that hide empty lists, come from that copy with no request. Pointing at the search or filter row starts loading the copy early. While it loads, the loaded matches show and lists stop loading more pages. Search here also matches labels, projects and assignee names. Tasks from other boards (another source scope) are still filtered on the server, and the previous result stays on screen until the next one arrives. A filtered list’s count is its matches, not the unfiltered list total.More and button styles
More contains Choose tasks, Board settings, Refresh, Hide sidebar, Create board and the personal Planner, when each action is available. Board settings uses the existing contextual settings dialog. Hide sidebar appears only when the sidebar is available and visible. Planner appears only on personal Kanban boards. Share, Project, Focus, Sort and View are the neutral outline buttons the board header has always used. A control that is not on its default (a selected project, active Focus, an explicit priority sort or a view other than Kanban) gets the primary tint, as Smart Focus did before. People pills highlight selected people and dim unselected people while a selection is active.Exceptions
Public boards show the board title instead of the member board picker. Public read-only boards keep search, Sort and the permitted views; member-only people, Project, Focus, presence, Share, task creation and More actions are absent. The header does not query private board members for public or read-only boards. Read-only boards use local filtering rather than member mutations. Unshared personal workspaces omit presence avatars; personal boards shared with guests can show them. The personal Planner remains in More on Kanban only. My Tasks replaces the board picker with its own title and keeps its existing workspace-wide task content. Project Tasks tabs omit people and Project options when no board header data is supplied, retain Link tasks, and hide board-manager actions. The shared UI and its Next.js and native app adapters follow the same header contract; this decision does not change board access permissions. Regression coverage:packages/tasks-ui/src/tu-do/shared/board-header/board-filter-state.test.tspackages/tasks-ui/src/tu-do/shared/board-header/use-board-header-data.test.tsxpackages/tasks-ui/src/tu-do/shared/__tests__/board-header.test.tsxpackages/tasks-ui/src/tu-do/shared/__tests__/board-views.test.tsxpackages/tasks-ui/src/tu-do/shared/__tests__/board-task-search.test.tspackages/tasks-ui/src/tu-do/shared/__tests__/use-board-task-source.test.tsxpackages/tasks-ui/src/tu-do/shared/board-user-presence-avatars.test.tsxpackages/tasks-ui/src/tu-do/projects/projectId/task-project-detail.test.tsxpackages/tasks-ui/src/tu-do/projects/projectId/components/__tests__/tasks-tab-layout.test.tsx
board-filter-state.test.ts and
use-board-header-data.test.tsx in packages/tasks-ui/src/tu-do/shared/board-header.
The task-board member endpoint returns public profile names and avatars with
email: null. Board visibility does not grant access to private member email
addresses. The assignee picker and mention suggestions use the task home
workspace; task cards and history retain authorized task identities. History actor names
come from public profiles; private email fallbacks from history storage are
not returned.