First project and tickets
A project groups tickets that belong together — an app, a customer, a machine. For pure task and bug tracking you need nothing more than a workspace and a project.
1. Create a project
1. In the sidebar under Projects click + New Project. 2. Enter a name and choose the project type:
| Type | When |
|---|---|
| General | Tasks, bugs, feedback — without code integration |
| FlawDesk Code | With GitHub repo, server deploy and MCP tools for AI clients |
3. Optionally pick a group to organise projects in the sidebar (e.g. "IT", "Customers"). Groups are managed under Workspace settings → Groups. 4. Create.
2. Create a ticket
Click New task at the top right (or press N). A title is enough; description, priority, tags and assignee can be added at any time.
A ticket has:
- Status —
New→In analysis→In progress→Fixed(orNot reproducible). Change it inside the ticket or by dragging the card onto the status zones at the bottom. - Priority — Critical, High, Medium, Low. The list can be sorted by it.
- Tags — free keywords with a colour, e.g.
frontend,customer-x. - Due date, platform and version — optional.
- Description and steps — Markdown, stored encrypted.
3. Comments and mentions
Every ticket has comments. Use @ to mention colleagues — they get a notification in their inbox (bell at the top right). Reactions and editing your own comments are possible.
4. Links
Under Links in a ticket you can record relations:
- Blocks / Duplicate of / Related — between two tickets.
- Fixed in — ticket ↔ commit. FlawDesk then shows directly in the ticket which files the commit changed. Requires a FlawDesk Code project with a linked repository.
Even without a manual link, FlawDesk recognises ticket numbers such as #123 in commit messages.
5. Finding your way around
- Sidebar — on the left you choose workspace and project. Clicking a project shows only its tickets; All shows the whole workspace.
- Open / Done — at the top of the sidebar you switch between open and completed tickets.
- Filter — by status, priority, tag, platform and assignee; sorting is set in the title bar.
- Personal — your private task list outside all workspaces, e.g. for notes to yourself.
- Priorities (view in the left rail) — your personal order across all projects. Tickets are added via "Add to priorities" on the ticket: what do I do next?
6. Custom fields (optional)
If the standard fields are not enough, create your own under Workspace settings → Fields — text, number, select, multi-select — and enable them per project under Project settings → Fields. These values are stored encrypted as well.
Next
For pure ticket management you are done. If FlawDesk should also build and deploy: