69
Configure Next.js for cross platform development with Capacitor js
Ever wanted to make an mobile app but never wanted to handle multiple codebases?
Well with Next.js and capacitor you can!
Next.js has gotten really popular over the days, and much of it is justified. It is an absolute joy to work with and provides with an amazing developer experience.
Today I'll be telling you how to build a mobile app with the same codebase as your next.js application and run on in mobile devices as a native app! Also a bonus section on how to use it as a desktop app as well!
Making Android, iOS and desktop apps with Next.js.
If you just want the code, you can visit
github.com/k4u5h4L/next-capacitor-demo
Well, it depends on you... Everythinig is a tradeoff and Next.js + Capacitor isn't perfect either.
- Ease of maintaining just one codebase for both your web and mobile apps.
- You don't have to leave your beloved Next.js and React ecosystem.
- Makes more business sense to use a cross platform app.
- Some features native to Next.js can't be used in a mobile or desktop app. So project changes need to be done.
- Performance may take a hit.
- The project is not yet mature and is still pretty new, although very exciting.
- If you're used to Next.js, you'd have used its server side rendering features, like
getServerSideProps
. Sadly, they won't work with capacitor. Next.js wasn't really meant to be used for mobile development. - For live reload your laptop/desktop and phone need to be connected via WiFi, at least if you're following this article.
Let's get started shall we!
- You need to have Node.js installed.
- Any nodejs package manager. I'm using
yarn
here but you can usenpm
as well. - A physical mobile device with USB debugging turned on connected to your system
- Java installed. Preferably version 8. This is to build your app for android. Check version by running
java -version
- Let's initialize a new Next.js project. Run
yarn create next-app next-capacitor-app
- After everything is downloaded, let's install capacitor in our project.
yarn add @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios
- After installing the dependencies, let's initialize capacitor.
npx cap init next-capacitor-app com.nextcap.app --web-dir=out
# The format as per capacitor docs
# npx cap init [name] [id] --web-dir=build
We're setting the web-dir
as out
because when we export assets it'll be there in the out
directory.
- Install the native platform you're targetting
npx cap add android
npx cap add ios
Now you should be up and running with it. Go to your pages/index.js
and edit it to get a basic page.
import React from 'react'
export default function Home() {
return (
<div>
<h1>
Hey there!
</h1>
</div>
)
}
Now, let's export the static assets from next!
yarn run build && npx next export
pro tip: You can add the next export
command to your scripts
section in your package.json
.
Now, sync your next.js assets with android and ios platforms
npx cap sync
After this, connect your physical device run the app. Check if the phone is recognised by adb
first.
adb devices
# if a device appears, run the next command.
# else accept a pop up if it appears on your device
npx cap run
Now you should see the app installed on your phone and you can interact with it just like any other app!
But wait, we forgot one thing. While development, live changes won't work. You'll need to build, export and run everytime. That's very hectic, so let's start up live reload now!
When you ran npx cap init [***]
, a capacitor.config.json
file will be created in the root of your project. Let's go ahead and edit it so that we can add a server for live reload!
To get the IP address of your system, run
ifconfig
or any other equivalent command depending on your OS. I use Arch Linux btw, so ifconfig
works fine. If you're on windows, you can try running ipconfig
.
![](https://res.cloudinary.com/practicaldev/image/fetch/s--Uo3Mx3t9--/c_limit%2Cf_auto%2Cfl_progressive%2Cq_auto%2Cw_880/https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zebi5g4op4w3vvuksvdh.png)
That will be your local network IP. Mine is 192.168.1.9
. So I'll be using that.
In your capacitor.config.json
, add this:
{
"server": {
"url": "http://192.168.1.9:3000"
}
}
Now with this set up, run
yarn run build
npx next export
npx cap sync
Now you can run the development server given by next.js
yarn dev
And now with the dev server running, run your app on your physical device as well.
npx cap run
Great! You now have live reload with your app! Just remember to remove the server config from capacitor.config.json
before building your release APK.
Congrats if you've made it this far! Now we will build the app to work with electron.js as well for desktop apps!
Add and install electron platform for capacitor
yarn add @capacitor-community/electron
npx cap add electron
npx cap sync
To run your app,
npx cap open electron
Now enjoy life with your Next.js codebase spanning over the Web, Android, iOS, Windows, MacOS and Linux.
Well, that's about it. Hope this article helped y'all. Cheers!
69