Skip to content

Latest commit

 

History

History
92 lines (63 loc) · 2.65 KB

README.md

File metadata and controls

92 lines (63 loc) · 2.65 KB
Raw

core_app

A base repo for an Angular Ionic + Supabase App that uses Tailwind as a UI Kit

Quick Start

  1. Open using the devcontainer with VS Code
  2. cd app && npm install
  3. supabase start
  4. supabase migration up
  5. just serve
  6. Visit localhost:4200

Note: At the moment this flow requires:

  1. the 1Password CLI
  2. a set of values configured in a vault.
  3. An env var of APP_ENV that maps to the 1Password Vault

Distributing

Mobile

  1. just mo-init on first run
  2. just mo-build
  3. Open the Ionic build in Android Studio
  4. Update version in build.gradle
    1. https://developer.android.com/studio/publish/versioning
  5. Generate Signed APK
    1. The jks is saved at op://core_app_android_jks
    2. https://support.1password.com/files/#work-with-files-on-1passwordcom
  6. Release
    1. Go to Google Play Store Developer Console
      1. Currently setup for personal email
    2. Select "Internal Testing"
    3. Select "Create new release"

Vendor Docs

Contributing

Environmental Variables

Many of the commands assume a .env file. This file is generated using update_env, which updates .env.tpl. The best practice for this repo is to update the value of .env.tpl on a per project basis.

This file can be configured with git update-index --assume-unchanged to support local changes.

See this SO answer for more details.

Setting up dev container for Github SSH Access with 1Password

  1. eval $(op signin)
  2. just add_github

Running locally

  1. just serve

Prereqs without the dev container

  1. homebrew
  2. npm
  3. just
  4. 1Password cli
  5. just install

Updating devcontainer

  1. just docker-build

Testing

Mobile

Debugging

  1. Setup Developer Mode on an Android Device
  2. Use the "Pair Devices Using Wifi" option in Android Studio
    1. https://developer.android.com/tools/adb#connect-to-a-device-over-wi-fi
  3. chrome://inspect/#devices should bring up the console

Mobile Deep Linking

  1. Set "Redirect URLs" in supabase
    1. https://app.supabase.com/project/ssaoxpnmbdcjdpvrtdsq/auth/url-configuration
  2. Configure AndroidManifest.xml
    1. https://ionicframework.com/docs/native/app#android
  3. Configure Supabase to return to the app
    1. https://supabase.com/docs/guides/auth#mobile-deep-linking-uris