Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nyumbazetu.com/llms.txt

Use this file to discover all available pages before exploring further.

Units

Units are the physical spaces you rent—apartments, rooms, or other properties. You manage them under Units and link each unit to a lease when it’s occupied.

Where to find units

  1. Sign in to the app.
  2. In the sidebar, open Units (under the main app group or under Leases, depending on your layout).
  3. You’ll see a list of units. Use filters by property or search to find a specific unit.

Adding a unit

1

Open the units list

Go to Units from the sidebar.
2

Create a new unit

Click Add (or New unit). The unit form opens.
3

Enter unit details

Fill in at least: name or number (e.g. “A101”), property, and any required fields (e.g. type, floor). Save.

Editing or deactivating a unit

Open the unit from the list and update the fields. If your app supports it, you can mark a unit as inactive when it’s no longer available (e.g. under renovation) without deleting it.

Units and leases

  • When creating a lease, you select the unit being rented. One unit typically has one active lease at a time.
  • After a lease ends, the unit becomes available for a new lease. Use Leases to create the next tenancy.

Lease status on units

Units can include a Lease Status value (for example Active, Notice, Expired, or similar status labels configured in your organization):
  • Set or update lease status from the unit edit form.
  • View lease status directly on the unit detail view.
  • Use list filters to find units by lease status.

Full lease-status reference

The app uses a lifecycle lookup with the following statuses:
  1. Draft – Lease is being prepared and is not yet effective.
  2. Pending – Lease is awaiting signature, approval, or initial payment/deposit.
  3. Active – Lease is in force and billing is ongoing.
  4. Under Notice – Lease is still active, but a future vacate/termination notice has been issued.
  5. Suspended – Lease is temporarily paused (for example due to disputes or special conditions).
  6. Defaulted (TPS) – Tenant Purchase Scheme contract is formally in default.
  7. Repossessed (TPS) – TPS property has been repossessed by the owner.
  8. Ended – Lease reached its natural end and concluded normally.
  9. Terminated – Lease ended early due to breach, agreement, or enforcement.
  10. Completed (TPS) – TPS contract fully completed with ownership transfer.
  11. Expired – End date has passed but formal closure/renewal has not been completed.
  12. Cancelled – Lease was voided before becoming active.
TPS statuses are used in Tenant Purchase Scheme workflows. Non-TPS leases typically use Draft, Pending, Active, Under Notice, Suspended, Ended, Terminated, Expired, and Cancelled.

Next steps