Capacitor TestApp

The Capacitor TestApp is used to develop new features and verify bug fixes in Capacitor and the official plugins. It is built with Ionic React.

Setup

• Fork and clone this repo.
• Install the dependencies.

npm install

The TestApp is just like any other Ionic React app. See the docs to learn what you can do.

• ionic build to build web assets
• ionic serve to run web version in your browser
• ionic cap sync
• ionic cap run <platform> (also w/ livereload: just add -l --external flags)

You can also opt-out of the Ionic CLI and use npm scripts and the Capacitor CLI directly:

• npm run build
• npm start
• npx cap sync
• npx cap run <platform> (no automatic livereload)

Developing Capacitor

New to Capacitor development? Start here.

To use the TestApp to develop Capacitor and official plugins, make sure you have set up the sibling repositories. Clone Capacitor and the plugins repo into the same parent directory.

cd ../
git clone git@github.com:ionic-team/capacitor.git
git clone git@github.com:ionic-team/capacitor-plugins.git

Follow the setup instructions for each repo:

• capacitor
• capacitor-plugins (make sure to run npm run toggle-local)

Then, back in this repo, run the following to link the packages in both repos to this app:

npm install
npm run toggle-local