Initial version of the mobile app

.github/workflows/main.yml

@@ -40,6 +40,7 @@ env:
     desktop
     desktop-package
     foundations
+    mobile
     qms-desktop-package
     dev
     models

.github/workflows/mobile.yml

@@ -0,0 +1,95 @@
+# Builds the Capacitor mobile app and publishes test artifacts (Android debug APK).
+# iOS is intentionally not built here yet: it needs a macOS runner and Apple signing
+# credentials to produce an installable artifact.
+
+name: Mobile
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+on:
+  push:
+    branches: [develop, main, mobile-app, 'claude/**']
+    paths:
+      - 'mobile/**'
+      - '.github/workflows/mobile.yml'
+  pull_request:
+    paths:
+      - 'mobile/**'
+      - '.github/workflows/mobile.yml'
+
+  # Manual run: build an APK for testing from any branch
+  workflow_dispatch:
+    inputs:
+      config:
+        description: 'Config file from dev/prod/public to bundle into the app as config.json'
+        required: false
+        default: 'config-mobile-huly.json'
+
+jobs:
+  android:
+    runs-on: ubuntu-latest
+    timeout-minutes: 90
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          filter: tree:0
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: '.nvmrc'
+
+      - uses: actions/setup-java@v5
+        with:
+          distribution: 'temurin'
+          java-version: '21'
+
+      - name: Cache node modules
+        uses: actions/cache@v5
+        env:
+          cache-name: cache-node-platform
+        with:
+          path: |
+            common/temp
+          key: ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-build-${{ env.cache-name }}-${{ hashFiles('**/pnpm-lock.yaml') }}
+
+      - name: Installing...
+        run: node common/scripts/install-run-rush.js install
+
+      - name: Building web app bundle...
+        run: node common/scripts/install-run-rush.js package --to @hcengineering/prod
+
+      - name: Install mobile dependencies
+        working-directory: mobile
+        run: npm ci
+
+      - name: Copy web assets and sync native project
+        working-directory: mobile
+        env:
+          MOBILE_CONFIG: ${{ github.event.inputs.config || 'config-mobile-huly.json' }}
+        run: |
+          npm run build:web
+          npx cap sync android
+
+      - name: Build Android debug APK
+        working-directory: mobile/android
+        env:
+          MOBILE_VERSION_CODE: ${{ github.run_number }}
+          MOBILE_VERSION_NAME: 1.0.${{ github.run_number }}
+        run: |
+          chmod +x ./gradlew
+          ./gradlew assembleDebug
+
+      - name: Upload APK
+        uses: actions/upload-artifact@v6
+        with:
+          name: huly-android-debug-apk
+          path: mobile/android/app/build/outputs/apk/debug/app-debug.apk
+          retention-days: 14

.gitignore

@@ -87,6 +87,7 @@ tsconfig.tsbuildinfo
 ingest-attachment-*.zip
 tsdoc-metadata.json
 pods/front/dist
+mobile/www
 *.cpuprofile
 *.pyc
 metrics.txt

README.md

@@ -82,6 +82,7 @@ For detailed information about the platform architecture, services, and their in
   - [Installation](#installation)
   - [Build and run](#build-and-run)
   - [Run in development mode](#run-in-development-mode)
+  - [Mobile (iOS and Android)](#mobile-ios-and-android)
   - [Update project structure and database](#update-project-structure-and-database)
   - [Troubleshooting](#troubleshooting)
   - [Build \& Watch](#build--watch)
@@ -253,6 +254,32 @@ Then go to <http://localhost:8080>
 
 Select "Sign up" on the right panel and click the "Sign up with password" link at the bottom. Enter the new user's credentials, then proceed to create a workspace for them.
 
+## Mobile (iOS and Android)
+
+The Platform includes a Capacitor-based mobile app that wraps the same web frontend. Prerequisites: Node.js, Rush, and for native builds **Xcode** (macOS) and/or **Android Studio**.
+
+1. Build the web app once (from the repo root):
+
+   ```bash
+   rush build --to @hcengineering/prod
+   ```
+
+2. Copy web assets into the mobile project and sync native projects:
+
+   ```bash
+   cd mobile
+   npm run sync
+   ```
+
+3. Open and run the app:
+
+   ```bash
+   npm run open:ios     # Opens Xcode (macOS only)
+   npm run open:android # Opens Android Studio
+   ```
+
+For development, you can point the app at the webpack dev server by keeping `server.url` in `mobile/capacitor.config.ts` (e.g. `http://localhost:8080`). For production builds, remove or override the `server` setting so the app loads bundled content from `www/`. See [mobile/README.md](mobile/README.md) for details.
+
 ## Update project structure and database
 
 If the project's structure is updated, it may be necessary to relink and rebuild the projects.