Quickstart

Go from zero to a fully configured workspace in five minutes.

Prerequisites

• A Velocity account (sign up at app.velocity.dev)
• At least one team member to invite (optional but recommended)

Step 1: Create Issues

Navigate to the Issues page from the sidebar. Press C to create an issue inline, or use the command palette (Cmd+K).

Each issue has a status (Backlog, Todo, In Progress, Done, Cancelled), a priority (None, Low, Medium, High, Urgent), and can be assigned to a team member.

Step 2: Organize with Labels

Go to Settings → Labels to create labels like “bug”, “feature”, or “tech-debt”. Labels help you filter and group issues.

Step 3: Switch to Kanban

Click the Board toggle in the issues toolbar to switch to Kanban view. Drag and drop issues between columns to update their status. Issues can also be reordered within a column.

Step 4: Create a Project

Navigate to Projects and click New Project. Projects group related issues and have milestones with due dates. Track progress with the built-in progress bar.

Step 5: Plan a Cycle

Go to Cycles and create a new cycle with a start and end date. Add issues to the cycle to plan your sprint. The burndown chart tracks progress automatically.

Step 6: Connect Integrations

Visit Settings → Integrations to connect GitHub (link PRs to issues), Slack (get notifications), or X (post updates). See the Integrations guide for details.