Docs / Getting started / Quick start

Quick start

Four steps from a blank slate to a board with work on it: an account, a workspace, a board, and an issue. Ten minutes, once.

Create an account#

Sign up with your full name, email and a password. You can also continue with Google, which skips the email step below and takes you straight into the app. Depending on how your deployment is configured, the sign-in screen may offer GitHub too.

Verify your email#

If you signed up with a password, Kevta emails you a verification link and shows a “check your email” screen.

!
You cannot sign in until you verify. Signing in before then is refused, with an offer to resend the link. If it never arrives, use that resend button rather than creating a second account.

Clicking the link does two things at once: it verifies the address and signs you in, landing you on Home. There is no second trip through the sign-in form.

Create a workspace#

A workspace is the container your boards and teammates live in. A new account has none, so this is the first thing to do — open Workspaces in the sidebar and choose New workspace.

You are asked for four things, only the first of which is required:

  • Workspace name — what your team calls it.
  • A colour — picked from six swatches, used on the workspace tiles.
  • Workspace URL — a short slug, filled in from the name and editable here. Lowercase letters, numbers and hyphens.
  • Description — optional.
i
Choose the URL deliberately: it is fixed once the workspace exists and cannot be edited afterwards. The name, colour and description can all be changed later in workspace settings.

Create a board#

Open your new workspace and choose New board — from the header, or the dashed tile at the end of the board grid. Boards are created inside a workspace; there is no separate boards area.

!
Only the workspace owner can create boards. If you joined someone else's workspace and see no New board button, that is why — ask the owner to create it.

The dialog asks for:

  • Board name — required.
  • Board key — the short prefix stamped on every issue, so Marketing Site becomes keys like MS-42. Kevta derives one from the name; edit it if you would rather choose. Two to ten uppercase letters and digits, starting with a letter, unique within the workspace.
  • Colour and an optional description.

The board arrives ready to use, with five built-in properties —

  • Title, Assignees, Status, Priority and Due Date

— a status workflow of To Do → In Progress → In Review → Ready for QA → Done, and one saved view called All issues. All of it is yours to change; see boards & views.

File your first issue#

There are three ways in, and they all create the same thing:

  • New issue in the board header.
  • The + on a status column, or Add issue at its foot — these pre-set the status to that column.
  • Press C while viewing a board.

A title is all that is required. Everything else — assignee, priority, due date, labels — can be filled in now or later from the task itself.

Where to go next#

You now have somewhere to put work. Two shortcuts worth learning immediately: ⌘K (or Ctrl+K) opens a command palette that searches your boards and issues, and ? lists every keyboard shortcut.

Boards & views

Shape the workflow, then slice it four ways — board, list, table and calendar.

Tasks & fields

Properties, labels, sub-issues, blocking relationships and comments.

Kevta is in beta