# Leases

> Leases of units (assets) to parties with rent in bigint minor units and a frequency, rent charges posted on the ledger once per period, deposits held through ledger holds, renewals, terminations and maintenance requests on the unit.

- Category: Billing & commerce
- Module: `leases`
- Modes: `managed`, `custom`
- Docs: https://bettersupabase.com/docs/blocks/leases
- Page: https://bettersupabase.com/blocks/leases

## Install

```bash
npx better-supabase add leases
```

The command also installs `updated-at`, `tenant`, `access`, `subjects`, `ledger`, `assets`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by leases; add installs them too.
    "updated-at": {},
    tenant: {},
    access: {},
    subjects: {},
    ledger: {},
    assets: {},
    // Modes: "managed", "custom". The default is "managed".
    leases: { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/leases`.

## Events

- `lease.activated`
- `lease.charged`
- `lease.created`
- `lease.paid`
- `lease.renewed`
- `lease.terminated`
- `maintenance_request.filed`
- `maintenance_request.updated`

## Related blocks

Requires: [tenant](https://bettersupabase.com/blocks/tenant.md), [access](https://bettersupabase.com/blocks/access.md), [subjects](https://bettersupabase.com/blocks/subjects.md), [assets](https://bettersupabase.com/blocks/assets.md), [ledger](https://bettersupabase.com/blocks/ledger.md)

Works with: [outbox](https://bettersupabase.com/blocks/outbox.md), [audit](https://bettersupabase.com/blocks/audit.md)