Skip to content

Getting Started

Welcome to Fox — a native issue tracker for Mac, iPad, and iPhone built for developers, designers, and anyone who wants to stay organized without the overhead of heavier project tools. Every project is its own workspace with its own issues, versions, milestones, and kanban board, and everything syncs across your devices through iCloud.

This guide walks you through the essentials: creating your first project, navigating the workspace, working with issues, moving them across the board, and organizing them into versions and milestones. If you're brand new, start with The Basics and work your way through. If you're looking for something specific, jump straight to the section you need.

Just getting started?

If you'd rather follow a guided walkthrough for configuring a brand-new project from scratch — prefix, statuses, types, priorities, and your first batch of issues — jump to Setting Up a Project.

Download on the App Store

The Basics

Get oriented with projects, the workspace, and the kanban board. These pages cover how Fox is structured and where to find things as you move between projects and issues.

  • Projects

    Create, configure, and manage your projects — title, prefix, display image, and the project picker.

  • The Workspace

    The three-column layout — Navigator, Issue Browser, and Issue Detail — and how it adapts across Mac, iPad, and iPhone.

  • Issues

    The work unit at the heart of Fox. Learn how to create issues and what makes them tick.

  • The Board

    The kanban board, how status columns work, and how to move issues through your workflow.

Working with Issues

Issues start simple — a title is all you need — but they grow with your work. These pages cover the properties, connections, notes, and resolution workflow that turn a bare issue into a full record.

  • Issue Properties

    Type, status, priority, tags, due dates, estimates, and actual effort.

  • Subtasks & Links

    Break issues into subtasks and connect related work with typed links, including cross-project references.

  • Resolving Issues

    Close issues with a resolution, add resolution notes, and reopen when needed.

  • Writing Notes

    The markdown editor, wiki-links to other issues, and inline images.

Organizing Work

Versions, milestones, tags, and project archives give you a structure to plan inside — and when something is finished, it moves out of the way without being lost.

  • Versions & Milestones

    Group issues into releases and goals. Start flat and add structure as projects grow.

  • Tags

    Flexible, project-specific labels for anything that cuts across types and statuses.

  • Archives

    Tuck away finished versions, milestones, and projects while keeping them fully browsable.

  • Customizing Project Attributes

    Tailor statuses, issue types, priorities, resolutions, and link types per project.

Syncing & Sharing

Fox keeps your projects in sync across every device you use, and Fox for Teams adds shared projects for working alongside others.

  • iCloud Sync

    How Fox syncs projects, issues, attachments, and settings through CloudKit.

  • Collaboration

    Share projects with Fox for Teams, assign issues, and track who changed what.

Next Steps

Once you're comfortable with the basics, explore the in-depth guides for specific workflows: