SpedySpedy Docs

Create Your First Board

Set up a project board with Kanban columns and start tracking work

Boards are the heart of Spedy. Each board represents a project, product, or area of work. Inside a board you will find a Kanban view for visualizing progress, tickets for tracking individual pieces of work, and a flexible set of statuses to match your workflow.

What is a Board?

Think of a board as a dedicated space for one project or team. It keeps everything organized in one place -- all the tickets, statuses, and team assignments related to that project. You can create as many boards as you need, one for each project, product, or initiative.

Create a New Board

To create your first board, navigate to the boards section in the sidebar and select the option to create a new board. You will need to provide:

  • Board Name -- A descriptive name for your project, like "Customer Portal" or "Mobile App".
  • Board Key -- A short prefix (usually 2-4 uppercase letters) that identifies tickets in this board.

Understanding Board Keys

The board key is used to generate ticket numbers. For example, if you set your board key to CS, every ticket in that board will be numbered sequentially:

Board KeyTicket Numbers
CSCS-1, CS-2, CS-3, ...
APPAPP-1, APP-2, APP-3, ...
DESIGNDESIGN-1, DESIGN-2, DESIGN-3, ...

These ticket numbers make it easy to reference specific issues in conversations, commits, or documentation. Choose a key that is short, memorable, and clearly associated with the project.

Default Statuses

Every new board comes with a set of default statuses that represent stages in a typical workflow:

StatusCategoryPurpose
BacklogPlanningWork that has been identified but not yet scheduled
TodoPlanningWork that is ready to be picked up
In ProgressActiveWork that someone is actively doing
BlockedActiveWork that cannot continue due to a dependency or issue
DoneFinalWork that has been completed

These statuses appear as columns in the Kanban view. You can drag and drop tickets between columns to update their progress.

Customize Your Statuses

The default statuses work well for most teams, but you can customize them to match your own workflow. From the board settings, you can:

  • Add new statuses to represent additional stages, such as "In Review" or "QA Testing".
  • Rename existing statuses to use terminology your team prefers.
  • Reorder statuses to reflect the sequence of your process.
  • Remove statuses that do not apply to your workflow.

Each status belongs to one of three categories -- Planning, Active, or Final -- which determines how Spedy groups and reports on your work.

The Kanban View

Once your board is created, you will see the Kanban view. This is a visual representation of your workflow where each column is a status and each card is a ticket. You can:

  • Create tickets directly from the board by clicking the add button on any column.
  • Drag and drop tickets between columns to update their status.
  • Click on a ticket to open its full detail view with description, comments, attachments, and more.

Ticket Types

When creating tickets, you can choose from several types to categorize the work:

  • Task -- A general unit of work.
  • Bug -- Something that is broken and needs fixing.
  • Feature -- A new capability to build.
  • Epic -- A large body of work that can be broken down into smaller tickets.

Next Steps

Your board is set up and ready for work. Now bring your team in so everyone can collaborate.

Invite your team