wolfmanfx/capgo

Manage your update and test your capacitor code without xcode or android studio

Capgo - Instant updates for capacitor

Features

• ⚡️ Test webapp direct in your phone with native API

• 😃 Share your dev with your teamate

• ↕️ Manage your channels for auto update system.

Documentation

https://github.com/Cap-go/capacitor-updater/wiki/Capgo-Sandbox-App

Plugins

All official plugin are install and preconfigured

• Action Sheet - Provides access to native Action Sheets.
• App - Handles high level App state and events.
• App Launcher - Allows to check if an app can be opened and open it.
• Browser - Provides the ability to open an in-app browser and subscribe to browser events.
• Camera - Provides the ability to take a photo with the camera or choose an existing one from the photo album.
• Clipboard - Enables copy and pasting to/from the system clipboard.
• Device - Exposes internal information about the device, such as the model and operating system version, along with user information such as unique ids.
• Dialog - Provides methods for triggering native dialog windows for alerts, confirmations, and input prompts.
• Filesystem - Provides a NodeJS-like API for working with files on the device.
• Geolocation - Provides simple methods for getting and tracking the current position of the device using GPS, along with altitude, heading, and speed information if available.
• Haptics - Provides physical feedback to the user through touch or vibration.
• Keyboard - Provides keyboard display and visibility control, along with event tracking when the keyboard shows and hides.
• Local Notifications - Provides a way to schedule device notifications locally (i.e. without a server sending push notifications).
• Motion - Tracks accelerometer and device orientation (compass heading, etc.).
• Network - Provides network and connectivity information.
• Push Notifications - Provides access to native push notifications.
• Screen Reader - Provides access to TalkBack/VoiceOver/etc. and Provides simple text-to-speech capabilities for visual accessibility.
• Share - Provides methods for sharing content in any sharing-enabled apps the user may have installed.
• Splash Screen - Provides methods for showing or hiding a Splash image.
• Status Bar - Provides methods for configuring the style of the Status Bar, along with showing or hiding it.
• Storage - Provides a simple key/value persistent store for lightweight data.
• Text Zoom - Provides the ability to change Web View text size for visual accessibility.
• Toast - Provides a notification pop up for displaying important information to a user. Just like real toast!

Dev contribution

Coding Style

• Use Composition API with <script setup> SFC syntax
• ESLint with @antfu/eslint-config, single quotes, no semi.

Dev tools

• TypeScript
• Cypress - E2E Testing
• pnpm - fast, disk space efficient package manager
  • critters - Critical CSS
• Netlify - zero-config deployment
• VS Code Extensions
  • Vite - Fire up Vite server automatically
  • Volar - Vue 3 <script setup> IDE support
  • Iconify IntelliSense - Icon inline display and autocomplete
  • i18n Ally - All in one i18n support
  • Windi CSS Intellisense - IDE support for Windi CSS
  • ESLint

Usage

Build

To build the App in mobile, run

pnpm mobile

And you will see the generated file in dist that ready to be served.

Deploy on Netlify

Go to Netlify and select your clone, OK along the way, and your App will be live in a minute.

Development

Start each local server in a separate terminal.

Start local Supabase DB

You need to have Docker installed. You need to have Supabase CLI (npm install supabase --save-dev) installed.

supabase start

Replace in configs.json supa_anon.local the key by the one logged in the terminal anon key Run the front with

Start local Supabase db and Functions

You need docker running.

pnpm backend

Start local Front

In the second terminal run this to generate the necessary netlify functions.

pnpm serve

Then start the server

pnpm generate:node_serverless
pnpm serve

Login

Visit http://localhost:8881

Use the demo credentials. Account: test@capgo.app Password: testtest

This account has some demo data in it. If the data is not fresh just reset the db with supabase db reset the seed has been made in the way the data is always fresh.

The admin account is Account: admin@capgo.app Password: adminadmin

This user will be admin so he can impersonate other users. You can find the menu for that in the account section.

Supabase db reset

You need docker running. This will seed the db with the demo data again.

pnpm reset