Cover image for Announcing the Ionic React Release Candidate!

Announcing the Ionic React Release Candidate!

elylucas profile image Ely Lucas Originally published at ionicframework.com on ・4 min read

Today we are excited to announce that the Release Candidate for Ionic React has launched and is now available!

We released the first Beta of Ionic React in February, and since then, we have received a ton of feedback and contributions from the community. Based on this feedback, we have been working to make Ionic React a great experience not only for React developers but for anyone looking to jump into web development.

Ionic React RC marks the first major release of our vision to bring Ionic development to more developers on other frameworks. This was made possible by Ionic v4.0, which was completely re-written from the ground up focusing on web standards and not dependent on a particular framework. Ionic v4.0 makes it possible for us to target many frameworks while still having our core components be a single code base shared across all these frameworks.

Why Ionic React?

If you can use Ionic with any framework, why are there specialized packages like @ionic/react? This is a good and fair question.

While you could import the core Ionic components directly into your React project, the developer experience is not where we think it should be when working with Ionic. While working with web components is possible in React, there is some boilerplate code you would have to write to properly communicate with the web components.

Ionic React is a thin wrapper around our core components, exporting them as native React components and handling this boilerplate code for you. Thus using @ionic/react feels natural when working in React, and offers many React paradigms that aren't there in the core components.

There are also a few features that were still required to be written in the native framework, such as page lifetime management and lifecycle methods. To accomplish this, we extend the popular react-router package with @ionic/react-router. It is important to note that we are not creating a new router, but just extending React Router to provide a better experience when working with Ionic apps.

Getting Started

If you haven't already done so, grab the latest v5 release of the Ionic CLI:

npm i ionic -g

And create an Ionic React project by specifying the type of "react":

ionic start MyReactApp --type=react

You will see that all of our standard starter templates are there, choose your favorite (I'll choose tabs).

The Ionic CLI will create your project for you and install dependencies. Under the hood, the CLI uses Create React App (CRA) to initialize the React bits of the project. If you are familiar with CRA then all the functionality provided by the CRA scripts are available to you in Ionic React.

Next, go into the new folder (MyReactApp), and run ionic serve. Your app will be compiled and launched into a new browser window:

For a more in-depth getting started tutorial, check out our Build your First App guide for Ionic React in the docs.

Whats Next?

Now that Ionic React RC is out, we want you to test it out and send us your feedback. To report an issue or comment, head over to the GitHub repo and tag the issue with "package react". You can also head over to the forums to ask questions or start a discussion.

For the Ionic Team, our focus is set on releasing Ionic React final "soon". We will be looking closely at any issues that pop up during the RC phase and working on some final code stabilization and minor bug fixes. We don't expect any of the APIs to have any more significant changes.

We also plan on creating some more content and guides in the docs to help with some best practices we've found when working with Ionic React.

Until then, keep sending us your feedback and happy coding!

P.S. If you are heading out to React Rally on August 22nd - 23rd, stop by our booth and say Hi! Several members of the core team will be out there and we would love to chat! We might even have something new to talk about then...

Resources linked above in one convenient little place:

Build Your First Ionic React App
Ionic React Project on Github
Ionic Forums
Create React App

Posted on by:

elylucas profile

Ely Lucas


Web and Mobile Dev in Denver, CO. I work at Ionic as a software engineer and dev advocate.


The open source UI toolkit for developing high-quality cross-platform apps for native iOS, Android, and the web — all from a single codebase.


markdown guide

This sounds super useful! Any chance of this being generalized/extracted for use in Stencil? I'm guessing the issues you're running into with Ionic would most likely apply to the broader Stencil community as well.


You can use the core Ionic components in Stencil now. When you start a new Stencil project, select the ionic-pwa and it will get everything set up for you.


Thanks for the reply! We're actually building our own design system components, and would be hoping to use these React tools with those, and are not currently using Ionic. I'm specifically wondering if this might be extracted so people using Stencil (but not Ionic) could also take advantage of it:

Ionic React is a thin wrapper around our core components, exporting them as native React components and handling this boilerplate code for you. Thus using @ionic/react feels natural when working in React, and offers many React paradigms that aren't there in the core components.

Oh, gotcha. Yes, this is available as a part of our Stencil DS product: stenciljs.com/design-systems