micasa

Projects

Track planned and in-progress work on your house.

Projects table

Adding a project#

  1. Switch to the Projects tab (f to cycle forward)
  2. Enter Edit mode (i)
  3. Press a to open the add form
  4. Fill in the fields and save (ctrl+s)

The Title field is required. Everything else is optional or has a default.

Fields#

ColumnTypeDescriptionNotes
IDautoAuto-assigned primary keyRead-only
TypeselectProject categoryPre-seeded types (Renovation, Repair, etc.)
TitletextProject nameRequired
StatusselectLifecycle stageSee status lifecycle below
BudgetmoneyPlanned costDollar amount (e.g., 1250.00)
ActualmoneyReal costOver-budget is highlighted on the dashboard
StartdateStart dateYYYY-MM-DD
EnddateEnd dateYYYY-MM-DD
QuotesdrillNumber of linked quotesPress enter to view linked quotes
DocsdrillNumber of linked documentsPress enter to view linked documents

Status lifecycle#

Projects move through these statuses. Each has a distinct color in the table:

Settled filter#

In Nav mode on the Projects tab, press t to toggle hiding settled projects (completed + abandoned). A triangle appears to the right of the tab when the filter is active.

Description#

The edit form includes a Description textarea (in the “Timeline” group) for longer notes about the project. The description is stored on the project record but doesn’t appear as a table column.

Inline editing#

In Edit mode, press e on any non-ID column to edit just that cell inline. Press e on the ID column (or any read-only column) to open the full edit form, which includes the description field.

Linked quotes#

The Quotes column shows how many quotes are linked to this project. In Nav mode, press enter to drill into a detail view of those quotes.

On the Quotes tab, the Project column links back – press enter to jump to the project.