Skip to content

Capacitor

Capacitor is a free, open-source tool that wraps a browser game or app into an app for Android and iOS, from one codebase.

Filip Kostecki

Published

An app store won’t accept a web page. Capacitor turns it into an app: inside runs the same game, and outside there’s an icon, a name and a package for Google Play or the App Store. It’s developed by the Ionic team.

How does it work?

  1. The game has to be a project in a folder, with the library saved inside and nothing loaded from the internet.
  2. Capacitor adds an Android version and an iOS version to the project.
  3. You build the Android package in Android Studio, and the iOS one in Xcode on a Mac. Capacitor 8 requires Android Studio 2025.2.1 and Xcode 26.0 or newer.
  4. You sign the package and upload it to Google Play Console. A new personal account first goes through a closed test there.

What do you need?

You can’t do this step in a chat in your browser: you need to install tools, run commands in the terminal and build the package. For Android a computer with Windows, macOS or Linux is enough; for iOS you need a Mac. In an app, a game can earn through AdMob. I describe the whole route to Google Play in the article on how to release a game on Android.

What to watch out for

  • A website in a frame. An app that only shows a web page runs into trouble in stores. The App Store rules say plainly that an app must be more than a repackaged website.
  • A game without the internet. The game library, graphics and sounds must be in the project. A game that loads its library from the web won’t start without the internet.
  • Saving and sound. Check that the best score survives closing the app and that sound starts after the first tap on the screen.
  • The keystore. Keep the keystore you sign the package with somewhere safe, and make a copy of it.

I describe the road from the browser to Google Play and the App Store, with the costs and the risk of rejection, in the e-book “Make a Game with AI in a Weekend”.

See the e-book

Questions and answers

Is Capacitor free?

Yes, it's free and open source (MIT). You pay for the store accounts: Google Play $25 once, Apple $99 a year.

Do I need to know how to code to use Capacitor?

You need to run a few commands and build the package in Android Studio. An AI agent on your computer can take you through it, for example Claude Code, which runs commands itself and shows you what it's doing.

See also

Articles that use this term

Filip Kostecki

Founder of FKDRIVE and software developer. Builds and maintains web systems and automation.

Let us talk about your project.

Thirty minutes online about one or two processes that eat the most time. If you would rather write, the contact form is just as good a route.

Book 30 minutes

COOKIES

Without cookies we are working in the dark

We have no way of telling which parts of this site help somebody and which ought to go. Consent switches on visit statistics, session recordings with form content masked automatically, and measurement of how our advertising performs. We do not trade in your data and we do not sell it to anyone.

You can change this at any time with the “Cookie settings” link in the footer. What exactly we collect →