# What is an advisory?

> An advisory flags an app that needs a fix because the platform changed after it was built. Severity runs from info to emergency; fixes from re-push up.

Source: https://docs.applane.dev/builders/advisories/

**Who:** Builder  
**Time:** Usually one click

Most of a deployed app is platform-owned: the manifest, the configuration file and the shared files are rewritten on every push, and only a handful of files carry what makes your app yours. When the platform changes, an app that was built before the change may need a small fix. An advisory is how the panel tells you.

## Where they show up

- On the home screen, a marker on each affected app.
- Inside an app, a strip above the composer with the advisory's name, its severity, and a button for the fix.

The panel checks the app's actual content before it shows an advisory, so it only flags apps that are affected.

## Severity

| Severity | What it means | Deploy | Publish |
|---|---|---|---|
| Info | Good to know. | Allowed | Allowed |
| Warning | Should be fixed soon. | Allowed, with a warning | Asks you to confirm |
| Critical | Must be fixed. | Allowed, with a warning | Blocked until fixed, or dismissed with a reason |
| Emergency | A dependency the app loads was compromised, or similar. | Blocked unless the push itself is the fix | Blocked, no dismissal |

For an emergency the platform may apply the fix on its own, because waiting for a click is not a safe response to an app that is serving hostile code. The fix in that case is always a plain re-push or a swap of a pinned dependency, never something the agent decides.

## Fixes

| Fix | What happens |
|---|---|
| Re-push | Pushes the platform's own files again. One click, nothing of yours changes. |
| Transform | A defined edit to your files, shown in the preview before deploy. |
| Repair prompt | The agent gets a canned instruction as a normal turn; you review the result as usual. |
| Re-publish | The live deployment still serves an old version; re-publish it (from the bot for external and public apps). |
| Config change | A setting or grant needs updating; the panel walks you through it. |
| Regenerate | The old code cannot be carried over; the agent rebuilds it with a review checklist. |

Click the button in the strip. The fix runs through the same validator and preview as any other change.

## Dismissing

Warnings and critical advisories can be dismissed with a reason, which is stored with the app. Emergencies cannot.