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

# Update a published app

> Change metadata or ship a new immutable source revision without rewriting history.

Public metadata and app source follow different paths.

## Metadata-only change

Use the developer dashboard or MCP `app_update` to change the public name, summary, or description. The stable app ID and prior revisions remain intact.

## Source or asset change

Edit the local project, then create a new revision:

```sh theme={null}
niblet apps validate .
niblet apps preview . -o preview.webp
niblet apps push .
niblet apps submit <NEW_REVISION_ID>
```

Never try to replace an old uploaded revision. Immutability keeps the reviewed source, preview, decision, and digest auditable.

## Compatibility changes

Treat schema field removal, changed identifiers, new required credentials, or a different external provider as a migration. Preserve defaults for existing installations and explain any user action in release notes.

<Warning>
  Do not silently change what a credential or OAuth grant is used for. New purposes require a new field or renewed authorization and policy review.
</Warning>