southseact-3d/shopify-ai-backup

Files

southseact-3d d6e2af3a29 Rename to Plugin Compass, add mobile onboarding/signin, implement self-update for desktop, and fix workflow paths

2026-02-16 12:05:30 +00:00

1.8 KiB

Raw Permalink Blame History

Plugin Compass Android (Capacitor)

This folder contains the Android app build for Plugin Compass. The app provides a native mobile experience with sign-in, onboarding, and plugin building features.

Features

Native sign-in screen with email and OAuth options.
Full onboarding flow with step-by-step guidance.
Quick start prompts to help users get started.
Reuses the existing web UI for builder and apps pages.
Build via GitHub Actions.

How it works

Sign-in: Custom mobile-first sign-in screen with email/password and OAuth buttons.
Onboarding: 4-step onboarding flow introducing key features and quick start prompts.
UI reuse: After onboarding, users access the builder and apps from the web UI.
Local storage: Apps and preferences are saved using Capacitor Preferences.

Setup

Install prerequisites (Node 18+, Android SDK).
From this folder: npm install.
Pull UI assets: npm run prepare-ui.
Add Android platform: npx cap add android.
Sync: npx cap sync android.

Development

npm run build prepares UI and syncs with Android.
npx cap open android opens Android Studio for development.

CI build

GitHub Actions workflow: .github/workflows/build-android-app.yml.
The action runs on ubuntu-latest, sets up Java/Android SDK, and builds the APK.

Custom Mobile Index

The build script creates a custom index.html for mobile with:

Loading screen with branded animation
Sign-in screen (email/password + OAuth)
Onboarding flow (4 steps with quick start prompts)
Main dashboard with quick actions

Security notes

User credentials are stored securely using Capacitor Preferences.
API keys are never exposed to the web layer.
OpenCode execution is not supported on mobile (desktop app only).