Projects

Projects lets you plan client and internal work, break it into tasks and milestones, log the hours people spend, approve them, and turn approved time or completed milestones into invoices. You can see every task on a board, a timeline and a calendar, and check whether each project is making money. Project managers, team members and the person who invoices clients use it. Everything is in the Projects group of the sidebar: Projects, Board, Timeline, Calendar and Timesheets.

Note: Permissions: projects.view to see projects and log your own time, projects.manage to create and change projects and tasks (and move cards on the board), projects.timesheets.approve to approve or reject other people's time and see everyone's timesheets, and projects.invoice to create invoices from a project (the Invoicing module must be on). Set these under Settings → Roles.

How a project flows

  1. Create the project with its customer and how it is billed.
  2. Add tasks (with dates, people and estimates) and milestones.
  3. The team logs time against the project and its tasks. New time is Submitted for approval.
  4. A manager approves (or rejects) the time.
  5. You invoice: approved hours (hourly projects), the fixed price, or completed milestones. A draft invoice opens for you to check and send.
  6. Watch progress on the board and timeline, and the margin on the project list.

Create a project

  1. In the menu, open Projects → Projects.
  2. Click New project (marker 1).
Projects list with New project, the Tasks and Margin columns and the Filter button marked
Projects list with New project, the Tasks and Margin columns and the Filter button marked

The list shows each project's number (for example PRJ-0001), name and customer, Manager, Tasks done out of total (marker 2), Hours logged against the budget ("20.5 of 120"), Billing, Margin (marker 3: billed minus staff cost, with "billed … · cost …" under it; red when negative), Deadline and Status. The Status: Active filter is on by default; use the filter button (marker 4) to see projects on hold, done or cancelled.

  1. Fill in the form and click Create. The project opens so you can add tasks.
Create Project form with Customer, the portal switch, Billed and Hourly rate marked
Create Project form with Customer, the portal switch, Billed and Hourly rate marked

Project section

Field What to enter
Company Required. The company doing the work. It sets the currency.
Name Required. For example "Website redesign – Kilimanjaro Tours".
Customer Optional (marker 1). The client. Leave empty for internal work. Needed to invoice. Click + to add a new customer without leaving the form.
Project manager Defaults to you. The person responsible.
Status Active (default), On hold, Done or Cancelled. Only active projects appear on the board, timeline, calendar and in the time entry project list.
Customer can follow progress in the portal On by default (marker 2). The customer sees the project, its progress and milestones in the customer portal. Turn off for sensitive work.
Starts Defaults to today.
Deadline Optional. Shown on the list and as "Project ends" on the calendar.
Description Optional. Scope, goals or notes.

Billing section

Field What to enter
Billed Required (marker 3). By the hour (invoice approved time), Fixed price (one agreed amount), Per milestone (each milestone has its own price) or Not billed (internal).
Currency Required. Starts with the company currency, for example KES.
Hourly rate For By the hour (marker 4). The rate charged to the client, for example 3,500. It is frozen on each time entry when it is logged, so changing it later does not reprice old time.
Fixed price For Fixed price. The total agreed.
Milestones For Per milestone, a reminder: give each milestone task a price; completed milestones are invoiced from the project page.
Budget (hours) Optional. The hours you expect; shown as "of 120" next to hours logged on the list.

The project number is given automatically when you save.

Work on a project

Open a project from the list (click Open). The top of the page is the same form as above; change anything and click Save changes. The header buttons are:

Project page with Invoice time and Profitability marked
Project page with Invoice time and Profitability marked
Button Shown when What it does
Invoice time (KES …) (marker 1) Billed By the hour Turns all approved, billable time not yet invoiced into a draft invoice. The amount waiting is in the label.
Create invoice Billed Fixed price Makes a draft invoice for the fixed price.
Invoice milestones (KES …) Billed Per milestone Makes a draft invoice for every completed milestone with a price not yet invoiced.
Profitability (marker 2) Always Shows billed, staff cost and margin.
Delete Always Deletes the project. Asks you to confirm. Use Status: Cancelled instead if there is history to keep.

The invoice buttons need the Invoicing module and the projects.invoice permission.

Below the form are tabs: Tasks, Time, Notes (messages and a log of changes; you can log a note and follow the project) and Planned (scheduled activities such as calls and meetings).

Add tasks and milestones

  1. On the project, stay on the Tasks tab and click Add task (marker 1).
Project Tasks tab with Add task, a status list, the Done button and the Time tab marked
Project Tasks tab with Add task, a status list, the Done button and the Time tab marked
  1. Fill in the task and click Create (or Create & create another).
Create Project Task form with Assigned to, Due, Part of and Milestone marked
Create Project Task form with Assigned to, Due, Part of and Milestone marked
Field What to enter
Title Required. A short action, for example "Build home and catalogue pages".
Status To do (default), In progress, Review or Done.
Priority Low, Normal (default), High or Urgent. Shown as a coloured badge.
Assigned to Optional (marker 1). The person doing it. They can filter the board to their own tasks.
Starts Optional. Needed, with Due, to show the task as a bar on the timeline.
Due Optional (marker 2). Must be on or after Starts. Overdue open tasks show the date in red.
Estimate (hours) Optional. Shown as "est. 12.0" under hours logged.
Part of Optional (marker 3). Makes this a sub-task of another task; its parent shows under the title.
Milestone Turn on for a key point such as "Design approved" or "Go live" (marker 4). Milestones show a flag in the list, a diamond on the timeline and a 🏁 on the board.
Billed when reached Shown for milestones. The amount invoiced once the milestone is done, for example 50,000. Used by Per milestone projects.
Description Optional detail, acceptance criteria or links.

In the task list:

Log time

Anyone with access to a project can log their own hours, from the project or from Timesheets.

From the project:

  1. On the project, click the Time tab, then Log time (marker 1).
Project Time tab with Log time, the Status column and the Approve and Reject buttons marked
Project Time tab with Log time, the Status column and the Approve and Reject buttons marked
  1. Fill in the entry and click Submit.
Log time window with Hours, Task and Billable marked
Log time window with Hours, Task and Billable marked
Field What to enter
Date Required. Defaults to today.
Hours Required (marker 1). In quarter hours, from 0.25 to 24. For example 1.5 for an hour and a half.
Task Optional (marker 2). Only open tasks of this project. Time against a task shows on the task and as its own line on the invoice.
Description Optional. What you did, for example "STK push integration". It can appear on the invoice, so write it for the client.
Billable On by default for hourly projects (marker 3). Turn off for internal time such as travel or rework you will not charge.

From Timesheets:

  1. In the menu, open Projects → Timesheets (headed Time Entries) and click Log time (marker 1).
  2. Choose the Project (marker 1; active projects only), then the Task (marker 2), the Date, Hours (marker 3), Description and Billable (marker 4). Click Create.
Create Time Entry window with Project, Task, Hours and Billable marked
Create Time Entry window with Project, Task, Hours and Billable marked

Tip: Log time daily. It is easier to remember what you did, and managers can approve a week at a time.

Approve or reject time

New time is Submitted straight away. Someone with projects.timesheets.approve reviews it.

  1. In the menu, open Projects → Timesheets. Approvers see everyone's time; others see only their own.
  2. Use the filter button (marker 3) to show Status: Submitted, one person (Who) or This week.
  3. Click Approve on each entry (marker 2), or tick several and choose Approve selected from the bulk actions.
Time Entries list with Log time, Approve and the Filter button marked
Time Entries list with Log time, Approve and the Filter button marked

On the project's Time tab you can also Approve and Reject each entry (markers 3 and 4 on the project Time tab picture). The total of the hours shows at the foot of the list.

Time statuses

Status Meaning What moves it on
Draft Not yet sent for approval (rare; time logged in the app is submitted at once). Approve.
Submitted Waiting for a manager. Cannot be edited. Approve or Reject.
Approved Accepted and, if billable, ready to invoice. Invoice time, or Reject to send back.
Rejected Sent back. The person can Edit or Delete it. Not counted in profitability. Approve after it is corrected.
Invoiced On a draft or issued invoice. Cannot be changed or rejected. —

Invoice time, a fixed price or milestones

The project must have a Customer.

Hourly projects:

  1. On the project, click Invoice time (KES …).
  2. Read the message ("All approved, billable time not yet invoiced becomes a draft invoice, one line per task.") and click Confirm (marker 1).
Invoice time confirmation with the Confirm button marked
Invoice time confirmation with the Confirm button marked

A draft invoice opens with one line per task (hours × the rate frozen on the time). The time becomes Invoiced so it is never billed twice. If nothing is waiting you see "There is no approved, billable time waiting to be invoiced."

Fixed-price projects: click Create invoice and confirm. A draft invoice for the fixed price opens, with one line named after the project.

Milestone projects:

  1. Mark the milestone Done on the Tasks tab when it is reached.
  2. Click Invoice milestones (KES …) and confirm. A draft invoice opens with a line per completed milestone ("Website redesign – Design approved"). Each milestone shows Invoiced under its amount and is billed only once. If none is ready you see "No completed milestone with a price is waiting to be invoiced. Mark the milestone done first."

In every case, check the draft invoice, add tax if needed, then Issue and send it from Finance → Invoices. See Invoices and payments.

Check profitability

Click Profitability on the project.

Profitability window with Billed, Staff cost and Margin marked
Profitability window with Billed, Staff cost and Margin marked

To set the working hours, open Settings → Preferences, click the Projects tab (marker 1) and fill in Working hours per month (for staff cost on projects) (marker 2), then Save preferences.

Preferences on the Projects tab with the working hours per month field marked
Preferences on the Projects tab with the working hours per month field marked

Tip: For staff cost to work, link each team member's user to their employee record and give them a contract with a basic salary in HRM → Employees.

The task board

Projects → Board shows tasks from all active projects in four columns: To do, In progress, Review and Done.

Task board with the project list, Only my tasks and a button to move a card marked
Task board with the project list, Only my tasks and a button to move a card marked
  1. Choose one project (marker 1) or leave All active projects.
  2. Tick Only my tasks (marker 2) to see just yours.
  3. Each card shows the project, the title (🏁 for milestones), the person (or Unassigned) and the due date (red when overdue).
  4. Click the coloured button (marker 3), for example In progress →, to move a card to the next column, or ← To do to move it back. Moving needs projects.manage.

The timeline

Projects → Timeline is a Gantt chart of dated tasks, grouped by project.

Timeline with the project list and the Earlier, Today and Later buttons marked
Timeline with the project list and the Earlier, Today and Later buttons marked

The calendar

Projects → Calendar shows a month with each task on its due date and "Project ends: …" on each project's deadline.

Project calendar with the project list and the Today button marked
Project calendar with the project list and the Today button marked

Choose a project (marker 1), use ← and → to change month, and Today (marker 2) to come back to this month.

What the customer sees

When Customer can follow progress in the portal is on and the customer has portal access, the portal's Projects page shows each of their projects with its manager ("Managed by …"), deadline, a progress bar (tasks done out of total), and the milestones marked Done, In progress or Overdue. They do not see time, rates or internal notes. Give customers portal access from Sales → Portal access; see Customer and vendor portal.

Common questions

Why can I not edit my time entry? Submitted, approved and invoiced time is locked. Ask a manager to Reject it; you can then edit or delete it.

Why is the Invoice time button missing? The project is not billed By the hour, the Invoicing module is off, or you do not have projects.invoice.

I changed the hourly rate. Why did the invoice use the old one? The rate is frozen on each entry when it is logged. Entries logged after the change use the new rate.

Why is my project not on the board or in the time entry list? Only Active projects appear there. Check its Status.

Why is the margin zero? Nothing has been invoiced yet, and staff cost needs employee contracts. Invoice the approved time and link users to employees.

Can I bill time and milestones on the same project? A project has one billing method. Use Per milestone for staged payments, and log time anyway (non-billable) to track effort and cost.