Apply iOS 27 Liquid Glass styling and animations to Ionic components in the browser or a WebView. For native iOS controls, add Capacitor Native UI.
The setup guide shows Ionic 9. On Ionic 8 (8.8.1 or later), Angular apps import provideIonicAngular from @ionic/angular/standalone.
| Goal | Guide |
|---|---|
| Style an existing Ionic app | Get started |
| Select iOS 26/27 styles and optionally use MD3 | Adaptive themes |
| Add native iOS controls to a Capacitor app | Add Native UI |
| Add a side rail to Ionic while keeping your own theme | Vertical Bars step by step |
| Optional: use the theme and Native UI with Cordova | Configure Ionic, then connect Cordova |
| Configure styles, dark mode and animations individually | Configuration |
| Upgrade an existing installation | Migration |
- Features: CSS variables, Liquid Glass, and selective component imports.
- Special markup and classes: opt-in component behavior.
- Using ion-item-group: inset list markup.
- Animation: tab, segment, and search effects.
- ESLint: catch unsupported list structure.
- Vertical Bars layout: spacing, RTL, device placement, posture, and split panes.
The Capacitor plugin is maintained in webview-native-ui/capacitor-plugin. This repository owns the Ionic theme, the combined demo, browser screenshots, and simulator integration tests. The demo installs @rdlabo/capacitor-native-ui from npm; theme releases do not publish or change the plugin version.
The Cordova plugin provides the native integration. Install this theme separately in the Web project.
To verify an unpublished plugin archive against the real demo, run:
npm run test:native-candidate -- /absolute/path/rdlabo-capacitor-native-ui-VERSION.tgz --e2eThis creates an isolated temporary checkout and leaves your manifests and lockfiles unchanged. Add --shard=1/2 alongside --e2e to run one Playwright shard; run every shard to cover the full suite. Each shard retains package checks, unit tests, and the production build. Add --simulator=UDID for native UI, search, and edge simulator suites. Diagnostics and the temporary demo are retained at the printed path. Plugin-only unit and native library tests live in the plugin repository. Its CI tests each candidate archive against this repository’s main branch.
For 1.x installations, see the v1.2.1 guide.
Release the root theme package with npm run release from a clean, up-to-date main. The ios27-v… tag workflow publishes only the theme, using next for prereleases and latest for stable releases.
Theme and plugin versions are independent. For the standalone @rdlabo/ionic-theme-ios27 package, Capacitor Native UI is a required peer dependency so the theme and application share one plugin instance. npm 7+ installs it automatically for theme-only apps; other package managers must install required peers. Apps using native controls must also declare the plugin directly for Capacitor discovery. A published npm version cannot be overwritten.


