Skip to main content
Version: v2

Building your App

Capacitor works on a three-step build process: First, your web code is built (if necessary). Next, the built web code is copied to each platform. Finally, the app is compiled using the platform-specific tooling.

1. Building web code

Capacitor does not have any built-in feature to build web code. Instead, you will use your framework's build process of choice.

Regardless of your build process, we recommend adding a build script to your package.json to enable the standard frontend build command:

"scripts": {
"build": "command-to-build (ex: webpack, tsc, babel, etc.)"
npm run build

This builds your Progressive Web App if you've configured Progressive Web App support already.

2. Copying Web Code

Once your web code is built, it needs to be copied into each native project:

npx cap copy

Run this command each time you perform a build and consider adding it to the end of your build script in package.json.

3. Building Native Project


iOS relies on Xcode to do the final app compile:

npx cap copy ios
npx cap open ios

Once Xcode launches, you can build your app binary through the standard Xcode workflow.


Android relies on Android Studio (or, optionally, the Android CLI tools) to build the app:

npx cap copy android
npx cap open android

Once Android Studio launches, you can build your app through the standard Android Studio workflow.