Project Header

Every project opens with a header at the top of the Project Details Page. The header combines a banner image, the project's core info (name, description, status, health, dates), a grid of quick stats that summarise the project's current state, and action buttons for the most common operations. You can hide the header when you want a more focused view, and bring it back with one key.

This article covers everything in the header. For the tabs below the header, see the dedicated tab articles starting with Project Overview Tab.

What you can do

The banner image

Every project can have a banner image that appears at the top of the Project Details Page. Banner images add visual identity to projects across the app - they also show on project cards in the Projects page and sidebar.

How banner images work

Banner images are stored locally in your Space and sync to your other devices via File Sync or iCloud (if enabled). Images you pick from Unsplash are downloaded once and cached - they don't require an internet connection to view later.

When a project has no banner, the header shows a colour gradient based on the project's colour setting. The project colour is chosen when you create the project (and editable from the Edit Project modal).

Adding or changing the banner

Open the image picker from the header. The picker has two tabs:

Library - every image you've previously used in this Space, ready to reuse on another project. Upload your own files here, and PrimeTask saves them to the library. You can also delete library images (this removes them from your local disk and iCloud if sync is enabled).

Unsplash - search Unsplash for high-quality photos. PrimeTask asks for your consent before connecting to Unsplash the first time you open this tab. Once granted, type a keyword and pick an image - PrimeTask downloads it and saves a local copy.

Removing the banner

Use the remove action on the image. This removes the banner from the project and returns to the colour gradient - it doesn't delete the image from your library. To fully delete the image, use the library tab in the image picker.

Unsplash consent

Because Unsplash is an external service, PrimeTask asks for your consent before connecting. The consent prompt explains what data is sent (search queries and photo IDs) and confirms that no PrimeTask data is shared with Unsplash. You can choose Remember my choice to skip this prompt on future uses, or grant consent for just the current session.

Core project info

The header shows:

Project name and description

The project's name is prominent at the top. A description (if set) appears below. Both are edited from the Edit Project modal (shortcut: E) - they aren't inline-editable from the header.

Status badge

A status badge shows which lifecycle state the project is in:

• Active - currently being worked on
• On Hold - paused
• Completed - finished
• Canceled - abandoned

Change the status from the Edit Project modal.

Health badge

A health badge shows the auto-calculated project health:

• On Track - progressing as expected
• At Risk - watch closely
• Behind - slipping against the deadline
• Critical - significant intervention needed
• Completed - done

Health is not a field you set - it's computed from progress, deadline, milestones, and overdue tasks. Click the Explain Health action in the header to see a breakdown of how health was calculated for this project. See Project Health & Progress.

Dates and timeline

The header shows the project's start date, deadline, and either days remaining (if the deadline is in the future) or days overdue (if past). These dates drive the expected-progress calculation that feeds into health.

Progress bar

An animated progress bar shows the project's overall completion percentage. The number combines tasks, milestones, goals, and CRM tasks via an adaptive weighted average - see Project Health & Progress.

CRM mode badge

When CRM is enabled on the project, a badge shows the CRM mode:

• Shared - the project uses your Space's main CRM
• Isolated - the project has its own CRM, separate from the Space's CRM

See Project Team & CRM.

The quick stats grid

Below the project info, the header shows a grid of 12 quick stats. Each stat is clickable - click to jump to the relevant tab.

Priority is derived from goals

The Priority stat isn't something you set directly on the project - it's calculated from the goals attached to the project:

• Any goal marked Critical → project priority is Critical
• Any goal marked High → project priority is High
• All goals marked Low → project priority is Low
• Otherwise (or no goals) → project priority is Medium

This keeps project priority honest - it reflects what your actual goals require, not a field you might forget to update.

Quick stats update live

Stats refresh in real time as you add, edit, and complete items. Add a new task → the task count updates instantly. Complete a milestone → the completed-milestones count bumps. You don't need to refresh anything.

Action buttons

The header has buttons for the most common project operations. Each has a single-key shortcut that works anywhere on the Project Details Page (as long as you're not typing in an input).

See Keyboard Shortcuts for the full app-wide shortcut reference.

Change or remove banner from the header

When a banner is already set, hovering over the image reveals two additional actions: Change Image (reopens the picker) and Remove Image (returns to the gradient fallback).

Hiding and showing the header

Press H (or click the toggle in the header) to fold the header. The tabs and tab content stay in place - the header compresses to give you more vertical space for work.

When folded with a banner image, the header keeps the image visible with the project name and essential actions overlaid on it. When folded without an image, the header collapses further.

Press H again to bring the full header back.

Going further with Shift + H

For the cleanest possible layout, press Shift + H to hide both the back button and the project header at the same time. The tabs row stays visible (with the project name and a colour dot inline so you still know where you are), and the tab content fills the entire window vertically. This is especially useful in the Tasks tab Split view, Notes, or CRM tab on large displays where every extra line counts.

Press Shift + H again to restore the back button and project header.

Things worth knowing

Banner images sync across devices

Banner images are part of your project data. If you use File Sync or iCloud Sync, banner images sync to all your devices. They're stored as local files - viewing and working with them doesn't require an internet connection. See Projects Overview and the sync architecture overview in File Sync Settings.

The image library is per-Space

Your image library (images you've used on projects) is scoped to the current Space. Switching Spaces gives you a different library. Images deleted from the library are removed from local disk and iCloud (if sync is enabled).

Header is responsive

The header adapts to window width - smaller screens show more compact buttons, tighter stat grids, and smaller typography. All functionality is available at every size.

Health updates dynamically

Every time you add, edit, or complete tasks, milestones, or goals, the health status re-calculates. There's no manual refresh step. If you want to understand why a particular health state was assigned, use the Explain Health action.

The edit modal is the same as the create modal

Pressing E opens the same modal used when creating the project. In edit mode every field is pre-filled with the project's current values, and an Archive button appears alongside Save. See Creating Projects.

Common questions

Where to go next