React logo

React & Capacitor

Build native mobile apps with web technology and React


Install Capacitor.

Add Capacitor to your project and create a config for your app

npm install @capacitor/core @capacitor/cli
npx cap init [name] [id] --web-dir=build

Build the Web App.

The compiled web assets will be copied into each Capacitor native platform during the next step.

npm run build

Install the native platforms you want to target.

Apple logoAndroid logo

Capacitor's native projects exist in their own top-level folders and should be considered part of your app (check them into source control).

npm i @capacitor/ios @capacitor/android
npx cap add android
npx cap add ios

Adding calls to Native APIs

With Capacitor installed, adding calls to native device features is as straight forward as calling other JavaScript methods

import React, {useState, useCallback} from 'react';
import { Geolocation } from '@capacitor/geolocation';
export default function GeolocationPage() {
const [loc, setLoc] = useState(null);
const getCurrentPosition = useCallback(async () => {
const coordinates = await Geolocation.getCurrentPosition();
}, [coordinates]);
return (
<p>Your location is:</p>
<p>Latitude: {loc?.coords.latitude}</p>
<p>Longitude: {loc?.coords.longitude}</p>
<button onClick={getCurrentPosition}>
Get Current Location

Continue your Capacitor Journey.

This is only the beginning. Learn more about the Capacitor development workflow or using more native APIs .