Basalt LogoBasalthelp
Getting Started
Projects
Tasks
Files
Team & Roles
Client Portal
Integrations
MCP
AI Features
Settings & Billing
Resources
Changelog
HelpTasks

Tasks

Manage tasks across four views: list, kanban, calendar, and Gantt chart.

Task Management

Creating a Task

Open the Tasks page and click + New Task. The quick creation form includes:

  • Title — required field (up to 200 characters)
  • Description — details and requirements (up to 2,000 characters)
  • Type — Personal or Team task
  • Status — initial status (defaults to "Pending")
  • Priority — Low, Medium, High, or Urgent
  • Due Date — deadline with calendar picker
  • Due Time — exact deadline time (HH:MM format)
  • Assignee — select a team member with name and email search
  • Project — link to a project with search

When creating a task you can also add draft subtasks (up to 20) — they will be created along with the main task.

Task Types

The system has two task types:

  • Personal — belong only to you, not linked to a company. Visible only to the creator. Ideal for personal reminders and notes
  • Team — linked to a company, visible to team members based on their role. Can be assigned to a team member and linked to a project

Switch between personal and team tasks using the tabs at the top of the page. Each tab shows a task count.

Task Statuses

Each task has one of four statuses:

  • Pending — task created, work not started (default)
  • In Progress — task is being actively worked on
  • Completed — work is done. The completion date and time are recorded automatically
  • Cancelled — task cancelled or no longer relevant

You can change the status in several ways:

  • Via the status indicator on the task card (click cycles through statuses)
  • Via the card's context menu (right-click on desktop)
  • On mobile — via the "⋮" button and action submenu
  • By dragging the card between columns on the kanban board

When a task is moved to "Completed", completed_at is automatically set. When moved back to another status, this field is cleared.

Priority Levels

Priority helps your team focus on what matters most:

  • Urgent — requires immediate attention, shown with a red glow indicator
  • High — important, complete soon (orange indicator)
  • Medium — standard priority (blue indicator, default)
  • Low — can be deferred (gray indicator)

Priority can be changed via the card's context menu or in the task edit form.

Views & Filters

Display Modes

The tasks page supports four display modes, toggled via icons in the filter bar:

  • List — vertical list of task cards with compact information
  • Kanban — board with status columns and drag-and-drop
  • Calendar — monthly view with tasks on specific dates
  • Gantt — timeline chart for planning

The selected mode is preserved between sessions in local storage.

Kanban Board

The kanban board displays tasks in four columns: Pending, In Progress, Completed, Cancelled. Drag a card to another column to instantly change its status.

Mouse sensors (10px movement threshold) and touch sensors (250ms delay) are supported. During drag, the card appears as a semi-transparent ghost under the cursor.

Status changes are applied optimistically — the card instantly appears in the new column while the update is sent to the server. On error, the card returns to its original position.

Drag-and-drop is only available to users with full editing permissions (owner, admin, manager).

Calendar

The calendar view displays tasks in a daily grid for the current month. Navigate with "Back", "Forward", and "Today" buttons.

Each day cell shows up to 3 tasks with colored priority dots. If there are more tasks, a "+N more..." counter is displayed.

Context menu:

  • On a day cell (right-click or long press) — "Create Task" and "Show All Tasks" for that day
  • On a task chip — Open, Edit, Toggle Status, Delete

Clicking a day opens a panel with the full task list, stats (total, completed, in progress, pending), and completion percentage.

Gantt Chart

The Gantt chart visualizes tasks on a timeline:

  • Each task is a horizontal bar from the start date (or due date if no start date) to the due date
  • Bar color depends on task status
  • An inner fill indicator shows progress percentage (based on completed subtasks)
  • Tasks without dates are excluded — an info message shows their count

The project-level Gantt chart also offers: zoom in/out, assignee avatars, detail tooltips on hover, a "Today" marker line, and a context menu.

Filters & Sorting

The filter bar is located above the task list. On desktop, filters open in a popover; on mobile — in a bottom sheet.

Available filters:

  • Search — by task title (client-side filtering)
  • Status — All / Pending / In Progress / Completed / Cancelled
  • Priority — All / Low / Medium / High / Urgent
  • Date — All / Overdue / Today / This Week / This Month / Custom range
  • Assignee — select a specific team member
  • Project — select a specific project
  • Only My Tasks — show only tasks assigned to me (enabled by default)

Sorting: by due date (default), priority, creation date, or title — ascending or descending.

Active filters appear as badge chips, each removable individually. The active filter count is shown on the filter button.

Filter Presets

The system includes five built-in presets for quick access:

  • Overdue — tasks past their deadline
  • Today — tasks due today
  • Urgent — tasks with "Urgent" priority only
  • In Progress — tasks with "In Progress" status
  • This Week — tasks due this week

In addition to built-in presets, you can create custom presets: set up your filters, click "Save as Preset", and enter a name. Custom presets can be deleted. All presets are saved in local storage.

Statistics

The tasks page provides summary statistics:

  • Total — total number of tasks
  • Pending — tasks awaiting work
  • In Progress — active tasks
  • Completed — finished tasks
  • Cancelled — cancelled tasks
  • High Priority — tasks with "High" or "Urgent" priority

Details & Subtasks

Task Page

Open a task to see full details. The page includes:

  • Header — title with status, priority, and type (team) badges
  • Description — detailed task description
  • Sidebar — due date with time, start date, assignee, company, project, notification settings, created and updated timestamps
  • Action buttons — Edit and Delete (with confirmation dialog)

For users with the "Editor" role, instead of full editing, a "Complete" / "Resume" button is available for quick status changes.

Progress & Time Tracking

The progress card shows:

  • Progress bar — completion percentage (0–100%), calculated automatically from the ratio of completed subtasks to total
  • Subtask counter — how many completed out of total
  • Estimated time — planned hours for the task
  • Actual time — hours spent, with an overtime indicator when exceeding the estimate

Subtasks

Each task can contain subtasks for breaking work into smaller pieces. Subtask features:

  • Creation — add a subtask via an inline form with title, description, due date, and assignee
  • Statuses — the same four statuses as main tasks (Pending, In Progress, Completed, Cancelled)
  • Assignment — each subtask can have its own assignee
  • Ordering — subtasks are displayed in a defined order that can be rearranged
  • Progress — completing subtasks automatically recalculates the main task's progress

The subtask section header shows a counter of completed out of total. Editing and deleting subtasks is available via a dropdown menu.

Comments

You can leave comments on each task (up to 1,000 characters). Comments are shown chronologically with the author's avatar and name. Available actions: add and delete. When a comment is added, the task creator and assignee receive a notification.

Assignments & Notifications

Assigning Tasks

When creating or editing a task, select an assignee from the team members list. The list supports search by name and email and displays user avatars.

You can reassign a task at any time — the new assignee will receive a notification. The task card displays the assignee's avatar and name with a link to their profile.

Role-Based Access

Task capabilities depend on the user's role in the company:

  • Owner and Admin — full access to all team tasks: create, edit, delete, assign to any member
  • Manager — full access, but can only assign tasks to members with a lower role (editors)
  • Editor — can only see tasks assigned to them or created by them. Cannot create team tasks or assign others. Can only change task status (if assigned to the task — full editing is available)

Personal tasks are available to all roles without restrictions.

In-App Notifications

The system automatically sends in-app notifications for the following events:

  • Task assigned — assignee is notified
  • Status changed — creator and assignee are notified
  • Task completed — creator and assignee are notified
  • New comment — creator and assignee are notified
  • Subtask created — main task creator is notified
  • Subtask assigned — subtask assignee is notified
  • Subtask completed — main task creator is notified

The author of an action does not receive a notification about their own changes.

Browser Notifications

In addition to in-app notifications, the system supports browser push notifications for approaching deadlines:

  • Enable notifications in task settings and grant browser permission
  • For each task, you can enable a reminder and choose the lead time before the deadline: 0, 5, 15, 30, 60 minutes, or 2, 24 hours
  • The system checks deadlines every 60 seconds and shows a notification at the right time
  • Clicking a notification opens the task page

You can send a test notification to verify everything works.

Real-Time Updates

The tasks page connects to Supabase Realtime and automatically updates the list when any changes occur. If another team member creates, updates, or deletes a task, your list refreshes without reloading the page. A connection indicator shows the current status: connecting, connected, disconnected, or error.

Previous
Projects
Next
Files