Skip to content

Projects

Projects are the top-level containers in Fox. Each one is a self-contained workspace with its own issues, versions, milestones, and customized attributes — the statuses, types, priorities, tags, and link types you use to organize work. Projects can represent apps, frameworks, or even more abstract things like research projects.

Fox Project Picker on macOS

Fox Project Picker on macOS

What Makes a Project

Every project has a handful of identifying properties:

  • Title — The display name, shown everywhere the project appears.
  • Prefix — A 1–4 character alphanumeric code (e.g., FOX) used to build issue reference numbers like FOX-001 and FOX-042. Pick something short, unique, and memorable.
  • Display image — Optional. A visual for quick recognition in the project picker.

Projects are isolated from each other. Changing the statuses in one project doesn't affect another, and every project gets its own independent set of:

  • Statuses (which become board columns)
  • Issue types (Bug, Feature, Refactor…)
  • Priorities
  • Resolutions
  • Tags
  • Link types

See Customizing Project Attributes for how to configure each of these.

Creating a Project

  1. Open the project picker.
  2. Tap or click the + button.
  3. Give your project a title and prefix.
  4. Optionally add a display image.
  5. Start adding issues.

You can change any of these later in project settings.

Want a guided walkthrough?

For a step-by-step tour of configuring a brand-new project — picking a prefix, mapping out statuses, setting up types, priorities, and resolutions — see Setting Up a Project.

The Project Picker

The picker is where you browse and switch between projects. It offers two layouts:

  • Grid view — Large tiles with display images and titles. Good for visual scanning when you have a few projects.
  • Table view — Compact rows with more metadata visible at once. Good when you have many projects.

Sort projects by last opened, name, or date created. Archived projects are hidden by default; toggle them back into view when you need to browse or unarchive one.

Project Workspaces

When you open a project, it opens in its own workspace window. The workspace is where the actual work happens — see The Workspace for a tour.

Tip

Althrough Fox only supports a single Workspace window (which includes a navigator), Issues can be opened independently on both macOS and iPadOS.

Project Lifecycle

Projects have two states:

  • Active — The default. The project appears in the picker and can be opened for work.
  • Archived — The project is hidden from the main list but fully preserved. Archiving is for projects you've finished or paused indefinitely.

Archived projects live in Archives alongside archived versions and milestones. Unarchiving returns a project to active status with everything intact.

Deep Linking

Every issue in a project is addressable via the fox:// URL scheme using its reference number — for example, fox://issue/FOX-042 opens that specific issue. Share links to issues, wire them into Shortcuts, or link to them from other apps. See the URL Scheme guide for details.

See Also