Maximum Efficiency: A Primer on Capacitor


Quick, what is the quickest way to bring your product to the app stores? In today's landscape, trying to get into the app store can mean spending weeks deciding what tool to use and then rewriting your entire app. But the web, and mainly Capacitor, can simplify that. Take your existing web app, add Capacitor to the mix, and you have a native app that's ready for the stores! Let's see what's possible Capacitor and why it can help you ship faster.

12 min
05 Jun, 2023


Sign in or register to post your comment.

AI Generated Video Summary

Building an app can be challenging, but Capacitor allows code sharing across web, iOS, and Android. Packaging an app involves configuring plugins and modifying the project in Xcode. The app can be deployed to an iPhone and access typical dev servers.

1. Introduction to App Building and Capacitor

Short description:

Building an app can be surprisingly challenging. You have to learn the tools and programs, scaffold the app, build the UI, and handle different device sizes and types. Cross-platform solutions can help, but some are limited. Capacitor allows sharing code across web, iOS, and Android by packaging the web app in a native shell.

So, hello. I didn't expect to see you all here. We're—if I'm here, that means we're probably building an app, right? Now, have you ever actually gone ahead and built an app? It's surprisingly challenging. Not only do you have to learn the tools and programs to actually go ahead and build the app, then you've got to go ahead and start scaffolding out the app, figuring out where all your data's coming from, actually build out some of the UI, and then you have to go ahead and build out more UI.

Sometimes some UI is contextual. Sometimes it's only going to be shown on certain device sizes. Sometimes it's only going to be shown on certain device types. You have to build the UI again. Then you have to build some more UI. Even though you are building for mobile, sometimes we have larger form factors, like a tablet that needs adjusted UI to fit that scale and that dimensions that our users are used to working with.

Now, imagine doing this once. Challenges arise. We now need to go ahead and do this two additional times to make three UI designs for our users. This is not ideal. All these platforms, whether it's iOS, Android, and the web, have their own common design patterns and their own tools and techniques for building out an app. There are ways to alleviate this. We could go ahead and use a popular cross-platform solution. The only problem is that some cross-platform solutions are not as cross-platform as they advertise. For instance, some of the ones that people are probably familiar with only focus more or less on iOS and Android. The web, it's kind of an afterthought, and even then, it's still a limited version of the web, not being able to use existing libraries that you may know and love, for the fact that it now needs to exist in this kind of weird pseudo-web context, but also be able to run in native. It's not ideal. The more ideal solution would be have something where you could have your web code, your iOS code, and your Android code, all coexisting and being able to share the components across all of them. I'm here. I'm probably going to be talking about it. So we're going to be talking about Capacitor, which is the cross-platform solution which allows us to share all of our code across all the platforms.

Now how this works is a fascinating technical deep dive, but to kind of summarize it, Capacitor works by taking your existing web app and packaging it up in this native shell. Now this native shell has access to all of the same native features that any of the other cross-platform solutions have, but also allows you to integrate with the native device features and third-party SDKs pretty seamlessly. So if you're deploying to iOS, you can access the native SDKs available there, same way with Android. And on the web, we're able to provide either a fallback or utilize JavaScript SDKs that exist there. Now, the way this is done is through a very complex kind of solution of parsing out JavaScript code, passing it to a native runtime, but that is kind of beyond the point.

2. Packaging and Configuring the App

Short description:

The APIs that you use to target the status bar or the launch image are all done through a unified API. Let's see a real example of packaging an app as an iOS app. Install the necessary packages, create a new capacitor config file, and configure plugins. Add the native platforms and open the iOS project in Xcode. We can modify the project, extend it with a custom third-party view, and mix native and web elements.

The real point is that this is all provided to you through a very simplified TypeScript API. The APIs that you use to say, target the status bar or the launch image are all done through a unified API. So that way, you're not having to deal with the complexities of how is this done in iOS? How is this done on Android? And how is this done on the web?

Now this is all well and good, but let's actually go ahead and see a real example here. So this is an app that I've been working on for a little bit. It is a blue sky client and alternative to Twitter these days. And I want to go ahead and package this up and ship it as an iOS app.

Well, there's a few ways that we can do this. First and foremost, we want to go ahead and install the necessary packages. So we're going to install at capacitor core and at capacitor CLI. This will give us access to the core runtime as well as the CLI needed to execute further commands. Now this I've already installed. So we're not having to wait for npm here, but then we can go ahead and run npx cat init. This is going to go ahead and create us a new capacitor config file, which will be our basis for configuring all of the native projects. In fact, let's take a look at what that looks like. Now, this is just a TypeScript file. You can see we are exporting this config. It has the app ID, the app name, the directory where it should be pulling in your web app and then some server information here and there for how to configure the native projects. In fact, we can go ahead and configure plugins here as well. So that way, if we wanted to just hardcode some information to a plugin, we can do it before it even has to access the native code.

So with this installed, we can then run and add the native platforms. In this case, let's install at Capacitor iOS and at Capacitor Android. So go ahead and like previous commands, install the native packages that we need from here and then we can run npx cap add iOS. Now I've already done this. So let's go ahead and just open up an iOS project. We'll run npx cap open iOS and here we are inside of Xcode. Don't be too intimidated. You can see that we have a native AppDelegate.Swift where we can take a look at some Swift code. If we want to modify this project, we can take a look at the web assets that we have going on here, our launch screen, some of our asset catalogs, and then the main storyboard for actually presenting the app. So if we want to, say, go ahead and extend this with a custom third-party view, we can do that as well and kind of mix and blend what is native and what is web. But for most of our cases, this is just a simple app.

3. Running and Deploying the App

Short description:

We can deploy the app to an iPhone 14 Pro Max and have access to our typical dev servers that we use in the browser.

Let's go ahead and run this. We'll go ahead and we'll hit the play button, which is our way of building and employing. It's going to deploy to an iPhone 14 Pro Max. We'll give it a little second right here. And here we are. We have the iPhone 14 booting up, but let's go ahead and log in. Then we'll sign in and then we have our app. But we know that there's something different going on here. Good thing is, is that because this is still using a web app at the end of the day, we have access to all of our typical dev servers that we're used to doing in the browser.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

React Finland 2021React Finland 2021
27 min
Opensource Documentation—Tales from React and React Native
Documentation is often your community's first point of contact with your project and their daily companion at work. So why is documentation the last thing that gets done, and how can we do it better? This talk shares how important documentation is for React and React Native and how you can invest in or contribute to making your favourite project's docs to build a thriving community

React Advanced Conference 2021React Advanced Conference 2021
21 min
Building Cross-Platform Component Libraries for Web and Native with React
Building products for multiple platforms such as web and mobile often requires separate code-based despite most of the components being identical in look and feel. Is there a way where we could use shared React component library on different platforms and save time? In this presentation I'll demonstrate one way to build truly cross-platform component library with a unique approach of using React
React Native in combination.

React Advanced Conference 2021React Advanced Conference 2021
27 min
Limitless App Development with Expo and React Native
App development is hard, React and Expo make it easy!
It's never been simpler to build and deploy powerful mobile apps with incredible features to both Android and iOS users all over the world.
We’ll discuss building and deploying mobile apps seamlessly from the cloud using EAS, creating powerful dev clients (like browsers but for mobile app development) for testing your app, pushing OTA updates instantly to users, and much more — no native experience required!

Workshops on related topic

React Summit 2022React Summit 2022
118 min
Detox 101: How to write stable end-to-end tests for your React Native application
Workshop Free
Compared to unit testing, end-to-end testing aims to interact with your application just like a real user. And as we all know it can be pretty challenging. Especially when we talk about Mobile applications.
Tests rely on many conditions and are considered to be slow and flaky. On the other hand - end-to-end tests can give the greatest confidence that your app is working. And if done right - can become an amazing tool for boosting developer velocity.
Detox is a gray-box end-to-end testing framework for mobile apps. Developed by Wix to solve the problem of slowness and flakiness and
used by React Native itself
as its E2E testing tool.
Join me on this workshop to learn how to make your mobile end-to-end tests with Detox rock.
- iOS/Android: MacOS Catalina or newer
- Android only: Linux
Install before the workshop
React Advanced Conference 2022React Advanced Conference 2022
81 min
Introducing FlashList: Let's build a performant React Native list all together
Workshop Free
In this workshop you’ll learn why we created FlashList at Shopify and how you can use it in your code today. We will show you how to take a list that is not performant in FlatList and make it performant using FlashList with minimum effort. We will use tools like Flipper, our own benchmarking code, and teach you how the FlashList API can cover more complex use cases and still keep a top-notch performance.
You will know:
- Quick presentation about what FlashList, why we built, etc.
- Migrating from FlatList to FlashList
- Teaching how to write a performant list
- Utilizing the tools provided by FlashList library (mainly the useBenchmark hook)
- Using the Flipper plugins (flame graph, our lists profiler, UI
JS FPS profiler, etc.)
- Optimizing performance of FlashList by using more advanced props like `getType`
- 5-6 sample tasks where we’ll uncover and fix issues together
- Q
A with Shopify team
React Summit Remote Edition 2021React Summit Remote Edition 2021
60 min
How to Build an Interactive “Wheel of Fortune” Animation with React Native
- Intro - Cleo
our mission
- What we want to build, how it fits into our product
purpose, run through designs
- Getting started with environment set up
“hello world”
- Intro to React Native Animation
- Step 1: Spinning the wheel on a button press
- Step 2: Dragging the wheel to give it velocity
- Step 3: Adding friction to the wheel to slow it down
- Step 4 (stretch): Adding haptics for an immersive feel

GraphQL Galaxy 2022GraphQL Galaxy 2022
156 min
Hands-On With SwiftUI, GraphQL, & Neo4j AuraDB
Workshop Free
Bring the power of graphs to iOS mobile app development in this hands-on workshop. We will explore how to use the Neo4j GraphQL Library to build GraphQL APIs backed by Neo4j AuraDB and how to integrate GraphQL into an iOS app using SwiftUI and the Apollo iOS GraphQL library as we build a news reader mobile app.
Table of contents:
- Intro to Neo4j AuraDB
- Building GraphQL APIs with the Neo4j GraphQL Library
- Intro to SwiftUI
- SwiftUI + GraphQL
To follow along during the workshop attendees will need a Mac laptop with a recent version of Xcode installed. Some familiarity with Swift and iOS app development will be helpful, although not required.
JSNation 2023JSNation 2023
111 min
Bringing Your Web App to Native With Capacitor
Workshop Free
So, you have a killer web app you've built and want to take it from your web browser to the App Store. Sure, there are a lot of options here, but most will require you to maintain separate apps for each platform. You want your codebase to be as close as possible across Web, Android, and iOS. Thankfully, with Capacitor, you can take your existing web app and quickly create native iOS and Android apps for distribution on your favorite App Store!
Contents: This workshop is aimed at beginner developers that have an existing web application, or are interested in mobile development. We will go over:
- What is Capacitor
- How does it compare to other cross-platform solutions
- Using Capacitor to build a native application using your existing web code
- Tidying up our application for distribution on mobile app stores with naming conventions, icons, splash screens and more