Upgrading
Upgrade PanelUI deliberately — current package versions, copied-source updates and the migrations that require code changes.
An upgrade has two parts: taking the new files, then changing any code whose contract moved. This page is the short index for the second part. The changelog remains the complete release record; the entries here only point out releases that ask you to edit an existing app.
Current packages
| Package | Current | Release | Source |
|---|---|---|---|
panelui-native | 0.68.0 | npm | package.json |
panelui-cli | 0.4.2 | npm | package.json |
create-panelui-app | 0.2.0 | npm | package.json |
These are checked against the package manifests. A release that changes one without updating this page fails the docs tests rather than leaving an old “current” version here.
Upgrade workflow
-
Read every migration entry between the version you have and the version you want. The index below is oldest first so the edits can be applied in release order.
-
If you import the package, update it normally:
npm install panelui-native@latest npx expo install --check -
If the CLI copied source into your app, those files are yours. Preview the registry version first, then overwrite only after preserving local edits:
npx panelui-cli@latest add button --dry-run npx panelui-cli@latest add button --overwrite -
Restart Metro after changing
extraThemes, Metro configuration or the CSS entry, then run the app and its typecheck. A reload does not make Metro reread its configuration.
Migration index
v0.44.0 — remove Card.Wash
Card.Wash and CardWashProps were removed. Replace the wash with a decorative first child
inside a clipping card, and install only the native dependency that decorative layer actually
uses.
v0.46.0 — rename KpiChart to Kpi
Rename KpiChart and its KpiChart*Props types to Kpi and Kpi*Props. Copied-source projects
must also replace the registry item: add kpi-chart no longer resolves, so install kpi.
v0.59.0 — update FunnelChart geometry props
Rename stageHeight to optional stageSize and crossSize to height. Remove align,
cornerRadius and orientation; the chart is now a horizontal ribbon. layers, edges and
staggerDelay control the replacement presentation.
v0.60.0 — size swipeable Tabs and place Fab.Group at the screen root
Give swipeable Tabs a layout height, such as className="flex-1". Treat
keepMounted="measured" as true. Place Fab.Group in the screen root because that parent owns
its offset and scrim bounds.
For everything else — additions, fixes and changes that require no migration — continue in the full changelog or browse all releases.