Projects App

The Projects app is a full task tracker built into Fishladder. Use it to break roadmap items into actionable tasks, assign work to team members, and track progress. Open it from the App Switcher in the header — click the current app's name to open a menu of every app you can use.

Navigating the Projects App

• Sidebar — lists all your projects. Projects can be organized into project groups (folders), and admins can drag projects up and down to set a custom order. Drag the sidebar's right edge to resize it (double-click the edge to reset); the width is saved to your account, so it follows you across browsers.
• My Tasks — a personal view showing all tasks assigned to you across every project, grouped by due date (Overdue, Due Today, Due This Week, Upcoming, Recently Completed).
• App Switcher — in the header, a dropdown listing every app you have access to (Roadmap, Projects, and any others your admin has turned on for you).

Creating a Project

Admins create projects:

1. Click the + icon next to the PROJECTS heading in the sidebar. The Create a project dialog opens.
2. Choose how to start:
   • Blank Project — To Do, In Progress and Done statuses and matching categories, ready to fill in.
   • Use a Template — a pre-built workflow (such as Software Development, Work Requests or Employee Onboarding) with its statuses, categories and tags already set up. Templates your team saved with Save as template in project settings appear here too.
   • Import File — build a project from a CSV, PDF or DOCX file.
3. The new project opens, named after the option you picked. Click the project name in the header to rename it, and use the icon/color picker to customize its appearance.

Group Overview

Hover over a project group header in the sidebar and click the grid icon to open the group overview — a holistic view of every task across all projects in that group. Toggle between a List mode (tasks grouped by project) and a Board mode (columns merge same-named statuses across projects). Click any task to jump to it in its own project. The Group View button on a project's board opens the same overview, and a back link at the top returns you to that project.

Admins control who can see a group's projects with Manage Access(the group header's ⋯ menu). A project in a group is restricted everywhere — tasks, calendars, the CLI, the API, Claude and Slack alerts all follow the same rule; see Restricted boards. People who have been invited but have not accepted yet appear with an Invited badge and can be granted access in advance; it takes effect the moment they join.

Project Calendar

Click Calendar in a project's header to see its tasks' due dates — and the target date of a linked roadmap project — on a calendar. Add more projects there to see several together, and share the link to send someone the same view. See Calendar. The button appears for people with the Calendar module.

Linking Projects to Roadmap Cards

Projects can be linked to cards on the Roadmap. Open a roadmap project's edit drawer and use the Fishladder Project card to link an existing Projects-app project (or create a new one). Once linked, the roadmap card shows status circles summarizing the project's task statuses — the same way Linear-synced projects do — so roadmap progress reflects task completion. Anyone who can edit the Roadmap can link projects — admins, and members with the Roadmap module; viewers cannot.

Board View

Tasks are organized into columns by status. Each project defines its own set of statuses (by default: To Do, In Progress, Done). Drag cards between columns to update a task's status. You can customize status colors by clicking the color dot next to each status in project settings.

• Click + in a column header (or at the bottom of a column) to add a task.
• Long columns stay compact: only the first 10 cards are shown. Click View all to expand the column and Show less to collapse it again.
• Tasks show their title, priority badge, assignee avatar, due date, and comment count.
• Drag and drop cards within or across columns to reorder and change status.
• Bulk edit — click the checkbox in a column header to select every task in that column (or hover a card to select tasks individually). A toolbar appears at the bottom of the screen where you can set the status, priority, assignee, or due date of all selected tasks at once. Admins also see a Delete button there; it asks you to confirm and shows how many tasks will be removed, since deleting cannot be undone.
• Undo/Redo — the arrows in the project header undo and redo recent task changes, including bulk edits, drags, and field updates.
• Use smart syntax when creating tasks (see below).
• Use the Import button to import tasks from documents (CSV, meeting notes, or other structured text).

Smart Task Creation

When adding a task inline, you can type structured tokens directly in the task name field. Fishladder parses them in real time and shows chips below the input. See Smart Task Creation Syntax for the details.

Example: typing Fix login bug @sarah !high due:friday creates a task titled "Fix login bug" assigned to Sarah, with high priority, due next Friday. A name that matches nobody, or more than one person, shows as an unknown chip and assigns no one. Click the × on any chip to remove it.

List View

Tasks appear in a structured list grouped by category. Each task row shows the title, priority, due date, status, and assignee. Toggle between Board and List using the view switcher in the project header.

• Categories let you organize tasks into groups (e.g., "Sprint 1", "Backlog"). Filter by category using the Category dropdown in the toolbar.
• Click the + button in a category to add a new task inline.
• Collapse categories by clicking the chevron to focus on specific groups.

Task Details

Click any task to open the detail pane on the right side. From there you can edit:

• Title and description
• Status — select from the project's custom statuses
• Priority — None, Low, Medium, High, or Urgent
• Assignee — assign to any team member
• Due date
• Subtasks — break a task into smaller checklist items
• Images — paste, drag-and-drop, or use the toolbar button in the description editor to insert inline images
• Attachments — add documents and files to the task

Attachments

Every task has an Attachments section in the detail pane. Paste an image straight onto the page, drag and drop a file onto it, or click Upload to pick one. Pasting is the quickest way to attach a screenshot you have just taken — no need to save it first. Supported types include PDF, Word, Excel, PowerPoint, Markdown, HTML, plain text, CSV, and images, up to 10MB per file. Anyone on the team can download an attachment; deleting one is limited to the person who uploaded it or an admin.

Images are re-saved when you upload them, which removes embedded metadata such as the location a photo was taken. What you see is kept; what was hidden in the file is not.

The Add Screenshot button attaches the most recent image from your screenshots folder in one click. The first time you use it, your browser asks you to choose the folder where your screenshots are saved (on a Mac this is usually the Desktop or a Screenshots folder); after that, each click grabs the newest screenshot automatically. This feature requires a Chromium-based browser such as Chrome, Edge, or Arc — in other browsers the button is hidden.

Comments and Activity

The task detail pane includes a combined timeline of comments and activity. Team members can leave comments with @mentions to notify others. Activity entries are recorded automatically when fields change (status, assignee, priority, etc.).

Filtering and Sorting

Use the filter toolbar above the task list or board to narrow down tasks:

• Search — filter by task title and description
• Status — show only tasks in a specific status
• Priority — filter by priority level
• Assignee — show tasks assigned to a specific person
• Tag — filter by tag (shown only when the project has tags; tags are created in project settings or come from templates and imports, and cannot be added to a task by hand)
• Due date — filter by overdue, due today, due this week, due this month, or no date
• Sort — sort by manual order, due date, priority, title, created date, or status

My Tasks

The My Tasks page (accessible from the sidebar) shows every task assigned to you across all projects, organized into date-based sections:

• Overdue — tasks past their due date (shown in red)
• Due Today
• Due This Week
• Upcoming & No Date
• Recently Completed — tasks completed in the last 7 days (collapsed by default)