Time Frames

A Time Frame is the billing period - the thing that ultimately becomes an invoice. Read core-concepts.md first if you haven't.

Anatomy of a Time Frame

Field	What it does
Name (optional)	A label like "March 2026" or "Sprint 7". Shown on the invoice header.
Start date (required)	First day of the period.
End date (required)	Last day. Must be on or after the start date.
Status	in_progress, done, or canceled. Invoices are only available when status is done.
Hourly rate	Overrides your account default for this Time Frame. Applied to all billable time entries.
Currency	ISO code (USD, EUR, etc.). Appears on the invoice.
Notes	Free-form text for your own reference. Not shown to the client.
Taxes	Any saved Taxes to apply. Taxes flagged "Default" are pre-checked.

Creating a Time Frame

Inside a Project, click Create Time Frame. Fill in the fields above. Save.

Keyboard shortcut: Ctrl/Cmd+Alt+C while on a Project page.

Changing status

The status flow is:

in_progress ──→ done ──→ (invoice available)
            ╲
             ╲─→ canceled

Once you mark a Time Frame done:

• The Get Invoice button becomes active.
• You can still add, edit, and delete entries - marking done doesn't lock the data.
• If you regenerate the invoice later, the new one reflects any changes.

canceled is for Time Frames you're abandoning (scope cut, client ghosted, whatever).

You can move a Time Frame between any statuses freely - nothing is one-way.

Adding and removing taxes

Edit the Time Frame and toggle the tax checkboxes. Saving updates what will appear on the next generated invoice.

• Taxes applied in order of their sort value (configurable on the Taxes page).
• Order only matters if you have compound taxes - see taxes.md.

What you see on a Time Frame detail page

• Summary cards: total duration tracked, total billable, days active, average per day.
• The list of attached taxes as badges.
• Status badge.
• The list of Entries, paginated.
• Action buttons: Edit, Delete, Get Invoice (if done).

Deleting and restoring

Soft-delete behavior same as Projects:

• Delete → moves to Trashed tab.
• Restore → back to active.
• Force delete → permanent.

Entries inside a deleted Time Frame are preserved but hidden until restoration.

Soft limits by plan

All plans: unlimited Time Frames per Project. We don't throttle billing periods.

Tips

• Name your Time Frames. "March 2026" is easier to scan than a date range. This pays off on invoice headers too.
• Use a status of in_progress only for one Time Frame per Project at a time - otherwise it's easy to log into the wrong period.
• Don't mark done too early. If you still have edits coming, leave it in_progress. Invoices can be regenerated but you'll confuse yourself.
• The "canceled" status is your friend - better than deleting work you might want to reference later.