Core concepts

The whole app is built on four things. Once these click, the rest of the app is obvious.

The hierarchy

Your account
 └─ Project
    └─ Time Frame
       └─ Entry

You also maintain a separate list of Taxes that you attach to Time Frames as needed.

Project

A Project is a billable engagement. Usually one per client, or one per distinct piece of work.

Examples: "Acme Corp", "Personal blog redesign", "Bookclub translation gig."

Projects don't have dates, rates, or taxes of their own - those live one level down, on Time Frames. A Project is just a container with a name.

Time Frame

A Time Frame is a billing period inside a Project. This is the most important concept in LogForMe, because a Time Frame is simultaneously what you track against and what becomes the invoice.

Examples:

"March 2026" - a monthly retainer.
"Sprint 7" - a sprint-based billing window.
"Logo concepts" - a one-shot milestone.

A Time Frame has dates, an hourly rate, a currency, and a list of applied Taxes. It has a status:

in_progress - you're actively logging into it.
done - period over, ready to invoice. The Get Invoice button becomes active.
canceled - filed away, no invoice.

When you generate an invoice, it comes from the Time Frame: the total billable time, multiplied by the rate, with the taxes applied.

Entry

An Entry is a single logged unit of work inside a Time Frame. Two kinds:

Time entry - has a start time and end time. Example: "10:00 to 12:30 - wireframing dashboard."
Fixed entry - has a date and a fixed amount (hours or a flat deliverable). Example: "March 15 - 5 hours, landing page copy." Useful when you can't or don't want to track a live timer.

Every entry can be marked billable or non-billable. Non-billable entries still count toward your totals but don't appear on invoices.

If you create a time entry on the same day as an existing one, LogForMe will offer to merge them. Merged entries combine start/end times and descriptions.

Tax

A Tax is a reusable rule you can apply to Time Frames. You set them up once in the Taxes page; LogForMe applies them at invoice time.

Each tax has:

Type - percentage (e.g., 14%) or fixed (e.g., $25 flat).
Compound - does this tax apply on top of other taxes, or just the subtotal?
Inclusive - is this tax already baked into the price, or added on top?
Default - should this tax attach automatically to new Time Frames?

The full breakdown is in taxes.md.

A worked example

Say you're a freelance illustrator. You might have:

Project: Penguin Books
- Time Frame: "Book cover illustrations - Jan 2026" (status: done, rate: $75/hr, currency: USD, taxes: [UK VAT 20%])
  - Entry (time): Jan 4, 09:00–13:00, "Research and mood boards", billable
  - Entry (time): Jan 5, 10:00–16:30, "First cover pass", billable
  - Entry (fixed): Jan 8, 2 hours, "Revisions based on feedback", billable
  - Entry (time): Jan 9, 14:00–15:00, "Quick review call", not billable

When you click Get Invoice on that Time Frame, the PDF shows:

Total billable time: 12.5 hours
Rate: $75/hr → $937.50 subtotal
UK VAT (20%) → $187.50
Total: $1,125.00

The non-billable call doesn't appear. The invoice uses your name, address, and brand color from your Preferences.

That's it

Those four concepts are the entire app. Every feature - the stopwatch, verbal entries, the merge flow, the invoice generator - is just a faster way to do things within that structure.