Skip to content

About

CSS/JavaScript Library for Ionic Framework

Resources

Code of conduct

Contributing

Security policy

Stars

181 stars

Watchers

5 watching

Forks

Repository files navigation

Ionic Theme iOS27

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.

Ionic 9 demo · Setup guide

The setup guide shows Ionic 9. On Ionic 8 (8.8.1 or later), Angular apps import provideIonicAngular from @ionic/angular/standalone.

iOS 27 theme: Settings in light mode with a Liquid Glass search bar iOS 27 theme: Settings in dark mode iOS 27 theme: Library with Liquid Glass buttons and tab bar

What would you like to do?

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

Customize your app

Repository boundaries

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 --e2e

This 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.

Maintenance

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.

About

CSS/JavaScript Library for Ionic Framework

Resources

Code of conduct

Contributing

Security policy

Stars

181 stars

Watchers

5 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages