Get started with Ionic by building a photo gallery app that runs on iOS, Android, and the web - with just one codebase. This is the complete project referenced in the "Your First App: Vue" guide. Follow along to create a complete CRUD (create-read-update-delete) experience.
Powered by Ionic Vue (web app) and Capacitor (native app runtime).
After the user navigates to Tab 2 (Photos), they can tap/click on the camera button to open up the device's camera. After taking or selecting a photo, it's stored permanently into the device's filesystem. When the user reopens the app at a later time, the photo images are loaded from the filesystem and displayed again in the gallery. The user can tap on a photo to be presented with the option to remove the photo.
- App framework: Vue
- UI components: Ionic Framework
- Camera button: Floating Action Button (FAB)
- Photo Gallery display: Grid
- Delete Photo dialog: Action Sheet
- Native runtime: Capacitor
- Taking photos: Camera API
- Writing photo to the filesystem: Filesystem API
- Storing photo gallery metadata: Preferences API
- Tab2 (Photos) (
src/views/Tab2.vue): Photo Gallery UI and basic logic. - usePhotoGallery Hook (
src/composables/usePhotoGallery.ts): Logic encapsulating Capacitor APIs, including Camera, Filesystem, and Preferences.
Note: It's highly recommended to follow along with the tutorial guide, which goes into more depth, but this is the fastest way to run the app.
- Install Ionic if needed:
npm install -g @ionic/cli. - Clone this repository.
- In a terminal, change directory into the repo:
cd photo-gallery-capacitor-vue. - Install all packages:
npm install. - Run on the web:
ionic serve. - Run on iOS or Android: See here.
- Add android if needed:
ionic capacitor add androidorionic capacitor add ios. - With each change Ionic apps must be built into web assets:
ionic capacitor copy androidorionic capacitor copy ios. - With each change Ionic apps must be built into web assets:
ionic capacitor build androidorionic capacitor build ios.
If you have Android Studio installed, step 2 will open it up to debug your app.