# Health indicators

The Home light, and the green or yellow mark on each project Settings section.

## Prerequisites

- You are signed in to the dashboard. The light is on **Home** in the sidebar and again at the top of the Home page.

## Steps

### Home

The light is green, yellow, or red. Red wins over yellow. The headline counts only the items of that color.

- Green, and no items: "All clear. Nothing to do."
- Red: "1 problem to fix", or the count plus "problems to fix".
- Yellow, with no red item: "1 thing to check", or the count plus "things to check".

Up to three lines are links. After that the rest is a plus sign, the number of remaining lines, and "more". That link opens the **Inbox**.

Red lines:

- A **Failed** request. The line is the project name, then "Agent run failed", unless the failure is **Build failed**, **Pull request conflict**, or **Repository access**. Those three use that exact label after the project name.
- The project name, then "preview check failed".
- "GitHub disconnected", when the workspace has no GitHub App installation.
- "Vercel disconnected", when the workspace has Vercel connections and every one of them is revoked.
- "No credits left this period", on Free and Beta, when included credits plus rollover are below 1.
- "Spend cap reached", when overage spend is at or over **Monthly spend cap (USD)**.

Yellow lines:

- A request that is in **Needs you** and is not **Failed**. The line starts with the project name, then "Quote to send", "Needs your merge", "Quote expired", "Quote awaiting response (3 days)", "Needs you", or the status label (**No preview**, **Waiting on client**, **Quote sent**).
- "Finish setting up" and the project name, when a Settings section is still yellow.
- "Credits are running low", when included credits plus rollover are 20% or less of the plan's included credits, and the red "no credits" case does not apply.
- "Spend cap is nearly reached", when overage spend is at least 80% of the cap and still under it.

### Settings marks

Each project Settings section has a mark beside the title. Green means **Complete**. Yellow is an exclamation mark. Hover it, or use the button's name, to read the reason. Clicking it focuses the field. There is no red mark on a section.

- **Connection**. Yellow: "No repository is linked" or "Site URL must be a valid https address".
- **Client access**. Yellow: "No authorized email". On **App with login**, also "Link a Vercel project so the HMAC secret can be pushed" or "HMAC secret is not on Vercel yet".
- **Widget install**. Yellow: "Widget not found on the site".
- **Previews**. See below.
- **Autopilot and limits**. Yellow when a limit is outside its range. The messages are in [Autopilot and limits](https://www.modifee.com/docs/agency/autopilot-and-limits).
- **General**. Yellow: "Project name is required".
- **Guardrails**. Always green.

### Why Previews stays green before the first preview

**Previews** is green when previews are turned off (**Show previews to clients** is off).

It is also green when a host is known, the last preview check did not fail, and protected Vercel previews have a bypass secret if they need one. The line "Waiting for the first request to confirm." is only the detection note. It does not turn the mark yellow. No preview has been opened yet, and that is not a failure.

The mark turns yellow only for these reasons:

- "Previews are protected. Connect Vercel or add a bypass secret so clients can open them."
- "No preview host detected. Add where this site is hosted."
- "The last preview check failed. Run it again from the project."

## Verify

With no failed requests, no waiting work, finished project setup, and credits above the low line, Home says "All clear. Nothing to do." A project that has never had a preview still shows a green **Previews** mark when the host line is filled in and the three yellow reasons above do not apply.

## Troubleshooting

- Home is red and the inbox looks quiet. Open the red line. **Failed** requests are listed on Home even though they are not in the yellow **Needs you** wait. They are under the **Failed** filter.
- **Previews** is yellow on a site that has not had a request yet. Read the tooltip. "Waiting for the first request to confirm." is not the cause. The usual cause is an unknown host, a failed check, or a protected Vercel preview with no bypass. See [Protected previews](https://www.modifee.com/docs/vercel/protected-previews).
- "Finish setting up" stays after you saved. Another section on that project is still yellow. Open **Settings** and read each exclamation mark.