> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Housing Forms

> Browse, search, and manage form templates owned by the Recovery Housing module. Requires dashboard access.

The `/rh/forms` route renders the `RHFormsPage` component, which displays all form templates with `owning_core = 'rh'` using the shared `ModuleFormsPage` platform component.

## Overview

The route `/rh/forms` is wrapped by the outer `RHViewGuard`, which requires `rh.dashboard.view`. The page delegates entirely to `ModuleFormsPage` with `owningCore="rh"`. It queries the `fw_forms` table (via `useFormList`) filtered to `owning_core = 'rh'` for the current organization, and presents results in a card list sorted by last-updated date. Each row is clickable and navigates to `/fw/forms/:id` for viewing or editing. Users with `fw.forms.create` see a **Create Form** button that navigates to `/fw/forms/new?core=rh`.

## Who it's for

Outer guard: `RH_PERMISSIONS.DASHBOARD_VIEW` (`rh.dashboard.view`), applied by `RHViewGuard` to all routes in the RH module. The **Create Form** action is additionally gated on `fw.forms.create`.

## Before you start

* Hold `rh.dashboard.view` to access the page.
* Hold `fw.forms.create` to create new RH form templates.

## Steps

<Steps>
  <Step title="Open Housing Forms">
    Navigate to `/rh/forms`. The page loads all Recovery Housing form templates for your organization.
  </Step>

  <Step title="Search or filter">
    Use the search box to filter by form name or description. Use the status dropdown to narrow results to **Draft**, **Published**, or **Archived** forms.
  </Step>

  <Step title="Open a form">
    Click any row to navigate to the form detail page at `/fw/forms/:id`.
  </Step>

  <Step title="Create a new form (admin)">
    If you hold `fw.forms.create`, click **Create Form** to navigate to `/fw/forms/new?core=rh` and begin a new Recovery Housing form template.
  </Step>
</Steps>

## Key concepts

| Term          | Meaning                                                                        |
| ------------- | ------------------------------------------------------------------------------ |
| `owning_core` | Tag on a form indicating which module it belongs to (`rh` here)                |
| Form status   | `draft` — not published; `published` — available for use; `archived` — retired |

## Related

<Columns cols={2}>
  <Card title="Recovery Housing" icon="house" href="/rh/references">
    Recovery Housing references and overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/rh.tsx
  * src/cores/rh/pages/RHFormsPage.tsx
  * src/platform/forms/ModuleFormsPage.tsx
</Accordion>