A framework for building native iOS, Android and visionOS apps with JavaScript or TypeScript, using native UI and APIs directly.
ionic-team/ionic-framework
An open source UI toolkit built on Web Components for creating cross-platform iOS, Android, and PWA apps from one JavaScript/TypeScript codebase.
- Stars
- 52,715
- Forks
- 13,297
- Open issues
- 516
- Last commit
- 5 hours ago
What is it?
Ionic is an open source toolkit for building cross-platform native and Progressive Web Apps from a single codebase using JavaScript and the Web. Its UI components are built on Web Components, so they can be used with Angular, React, and Vue, and the project is distributed as @ionic/core plus framework-specific packages for each of those three.
The framework provides a set of prebuilt interface components that aim to look and behave like native mobile UI, with Material Design styling available alongside platform-specific appearance. Apps are typically packaged for iOS and Android with Capacitor, the native runtime that Ionic pairs with, and can also be deployed as web apps.
The project is MIT licensed and includes a CLI-based quickstart, documentation, and migration guides from earlier major versions. Ionic 1, 2 and 3 live in separate repositories.
Key features
- 01Cross-platform UI components for iOS, Android, and the web from one codebase.
- 02Built on Web Components, usable with Angular, React, and Vue.
- 03Material Design and platform-specific styling options.
- 04Integrates with Capacitor for packaging native iOS and Android apps.
- 05Includes a CLI quickstart and official migration guides between major versions.
Use cases
- Building a mobile app for iOS and Android with web technologies and one codebase.
- Creating a Progressive Web App with native-style navigation and components.
- Adding Ionic UI components to an existing Angular, React, or Vue project.
Quick start
- 1
Read the quickstart guide in the documentation
- 2
Install the core package from npm
npm install @ionic/core - 3
Choose a framework package (Angular, React, or Vue) and follow its README
Things to know
- Ionic 3 and earlier versions live in separate repositories and are not maintained here.
- Getting started relies on the external documentation rather than a complete setup in this README.
Topics
FAQ
- What is ionic-framework?
- An open source UI toolkit built on Web Components for creating cross-platform iOS, Android, and PWA apps from one JavaScript/TypeScript codebase. Ionic is an open source toolkit for building cross-platform native and Progressive Web Apps from a single codebase using JavaScript and the Web. Its UI components are built on Web Components, so they can be used with Angular, React, and Vue, and the project is distributed as @ionic/core plus framework-specific packages for each of those three.
- Is ionic-framework free to use? What license does it have?
- ionic-framework is open source under the MIT license. Check the license terms before using it in commercial products.
- Is ionic-framework still maintained?
- Actively maintained. The last commit to ionic-framework was on Oct 20, 2026.
- What can I use ionic-framework for?
- Building a mobile app for iOS and Android with web technologies and one codebase. Creating a Progressive Web App with native-style navigation and components. Adding Ionic UI components to an existing Angular, React, or Vue project.
- How do I install ionic-framework?
- Read the quickstart guide in the documentation Install the core package from npm: npm install @ionic/core Choose a framework package (Angular, React, or Vue) and follow its README
- Where can I get ionic-framework?
- The source code and installation instructions are on GitHub: https://github.com/ionic-team/ionic-framework
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Angular is a TypeScript-based platform for building web applications, with a CLI, routing, forms, SSR and Material components.
TypeScript, Ruby and Python SDKs for building interactive UI resources that MCP tools can return and hosts can render.
A Go framework for building cross-platform desktop apps with a web frontend (React, Vue, Svelte, etc.) using native rendering engines.
A Vue.js framework for building SPAs, SSR/SSG sites, PWAs, browser extensions, mobile and Electron apps from one codebase.
Zero-dependency semantic HTML, CSS and JS UI library of about 10KB, styling native elements without classes.