Why donate
API Explorer
Upgrade Guide
Creating a New Project
The /quasar.config File
Convert q/app-webpack Project
Browser Compatibility
TypeScript Support
Directory Structure
Commands List
CSS Preprocessors
Page Routing with VueRouter
Lazy Loading - Code Splitting
Handling Assets
Boot Files
Prefetch Feature
API Proxying
Handling Vite
Handling import.meta.env
State Management with Pinia
Lint and Format Code
Testing & Auditing
Developing Mobile Apps
Ajax Requests
Opening Dev Server To Public
Quasar CLI with Vite - @quasar/app-vite v3
Capacitor versions

The officially supported versions of Capacitor are v5+.

Upgrading Capacitor

If you previously used a lower version of Capacitor and you want to upgrade to a newer version, then:

  1. Delete the /src-capacitor/ios and /src-capacitor/android folders, but make sure that you are aware of any changes that you made in those folders as you will have to redo them after step 4.
  2. Change /src-capacitor/package.json to reflect the correct versions of Capacitor dependencies (you can read them in the next appropriate section related to your desired Capacitor version).
  3. Delete yarn.lock/package-lock.json then run yarn / npm install in /src-capacitor.
  4. At this point, you will have Capacitor installed. Now you can run quasar dev -m capacitor -T [ios|android] or quasar build -m capacitor -T [ios|android] and it will add the upgraded iOS/Android platform that corresponds to your Capacitor version.

It would also be wise to check the changelog of Capacitor itself to see what breaking changes it has.

Capacitor v8

Requirements

  • Node v22.21.1+
  • Xcode 16+ (for iOS)
  • Xcode Command Line Tools
  • Homebrew
  • Cocoapods
  • Android Studio 2024.2.1+
  • Android SDK (API 23+)

Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^8.0.0",
  "@capacitor/cli": "^8.0.0",
  "@capacitor/core": "^8.0.0",
  "@capacitor/splash-screen": "^8.0.0"
}

The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

Capacitor v7

Requirements

  • Xcode 16+ (for iOS)
  • Xcode Command Line Tools
  • Homebrew
  • Cocoapods
  • Android Studio 2024.2.1+
  • Android SDK (API 23+)

Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^7.0.0",
  "@capacitor/cli": "^7.0.0",
  "@capacitor/core": "^7.0.0",
  "@capacitor/splash-screen": "^7.0.0"
}

The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

Capacitor v6

Requirements

  • Xcode 15+ (for iOS)
  • Android Studio Jellyfish 2023.3.1.18 or newer (for Android)

Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^6.0.0",
  "@capacitor/cli": "^6.0.0",
  "@capacitor/core": "^6.0.0",
  "@capacitor/splash-screen": "^6.0.0"
}

The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.

Capacitor v5

Requirements

  • Xcode 14.1+ (for iOS)
  • Android Studio Flamingo 2022.2.1 or newer (for Android)

Assuming that you’ve installed Capacitor mode already, this is how your dependencies in /src-capacitor/package.json should look like:

/src-capacitor/package.json

dependencies: {
  "@capacitor/app": "^5.0.0",
  "@capacitor/cli": "^5.0.0",
  "@capacitor/core": "^5.0.0",
  "@capacitor/splash-screen": "^5.0.0"
}

The @capacitor/app and @capacitor/splash-screen are optional, but it helps Quasar with some UI functionality if they are installed.