How to work with projects in Conveyor

Conveyor breaks up work on projects into tasks. Whenever there’s work to get done, you create a new task. The files added/modified on a project gets done at the task level. Behind the scenes, every task is a branch.

Creating a Task

Whenever you’re ready to create a new task, select “+” in Conveyor’s toolbar (or ⌘+N). If you’re in the web app, creating a new task is available from the project overview.

Task Types

A task can be one of three types:

  • Feature
  • Bugfix
  • Improvement

The type helps to express the purpose of the task. Conveyor adds an icon to the task to show the type at a glance.

Task States

A task can be in one of several states in Conveyor. These indicate the current progress of a task. The possible states:

  • Backlog
  • Up Next
  • In Progress
  • Finished

States help solve an out-of-sync workflow when work gets planned and organized in one place but gets done in another. When you start work on a task, Conveyor marks it as In Progress for you. When you finish a task, the state changes. If a task isn’t necessary, moving it to the backlog is a piece of cake. There’s no need to go to another tool to update the status of your work.


Every project in Conveyor includes a Stable version. This is the “production” or “master” version of a project, comprised of all completed tasks.

Staying in Sync

With Conveyor, forget about pushing or pulling. All changes committed to a task get synced to everyone in the workspace.

Working with Files

Conveyor works with your favorite text editor to edit your code. From Conveyor’s toolbar, there’s easy access to your default editor, Terminal, and Finder. On your computer, Conveyor stores files at ~/conveyor. When you’re ready to commit your changes, head to the uncommitted section in the client and make your commit!