Ignore

.github/workflows/ci.yml

@@ -2,7 +2,11 @@ name: CI
 
 on:
   push:
+    branches: [ai-test]
   pull_request:
+    branches: [ai-test]
+env:
+  ANDROID_SDK_ROOT: /usr/local/lib/android/sdk
 
 jobs:
   spell-check:
@@ -33,3 +37,58 @@ jobs:
 
       - name: Run Biome
         run: biome ci .
+
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Setup java
+        uses: actions/setup-java@v4
+        with:
+          distribution: "adopt" # See 'Supported distributions' for available options
+          java-version: "21"
+
+#       - name: Workaround for "Build-tool 33.0.0 is missing DX at ..." error
+#         run: |
+#           ln -s $ANDROID_SDK_ROOT/build-tools/33.0.0/d8 $ANDROID_SDK_ROOT/build-tools/33.0.0/dx
+#           ln -s $ANDROID_SDK_ROOT/build-tools/33.0.0/lib/d8.jar $ANDROID_SDK_ROOT/build-tools/33.0.0/lib/dx.jar
+
+      - name: Add android sdk tools to path
+        run: |
+          export PATH=$PATH:$ANDROID_SDK_ROOT/platform-tools/
+          export PATH=$PATH:$ANDROID_SDK_ROOT/cmdline-tools/latest/bin/
+          export PATH=$PATH:$ANDROID_SDK_ROOT/emulator/
+
+      - name: Setup NodeJS
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+
+      - name: Install cordova
+        run: npm install -g cordova
+
+      - name: Install yarn
+        run: npm install -g yarn
+
+      - name: Setup project, install app plugins and deps
+        run: yarn setup
+
+      - name: Configure the platform
+        run: yarn clean
+
+      - name: Build Android prod
+        run: yarn build paid prod
+
+      - name: Sign apk
+        run: |
+          apksigner="$(find $ANDROID_SDK_ROOT/build-tools -name apksigner | sort -r | head -n 1)"
+          ${apksigner} sign --ks public.jks --ks-key-alias public --ks-pass pass:public --key-pass pass:public --in ./platforms/android/app/build/outputs/apk/release/*.apk --out ./platforms/android/app/build/outputs/apk/release/app-release-signed.apk
+
+      - name: Upload apk
+        uses: actions/upload-artifact@v4
+        with:
+          name: app-release-signed
+          path: ./platforms/android/app/build/outputs/apk/release/app-release-signed.apk
+          if-no-files-found: error

.gitignore

@@ -1,15 +1,15 @@
-/node_modules
-/build.json
-/www/build
-/plugins
-/platforms
-/keystore.jks
-/platforms/android/debug-signing.properties
-/platforms/android/release-signing.properties
-**/*/.DS_Store
-.DS_Store
-pnpm-lock.yaml
-.zed
-.idea
-ace-builds
-fdroid.bool
+/node_modules
+/www/build
+/www/js/build
+/www/css/build
+/plugins
+/platforms
+/platforms/android/debug-signing.properties
+/platforms/android/release-signing.properties
+**/*/.DS_Store
+.DS_Store
+pnpm-lock.yaml
+.zed
+.idea
+ace-builds
+fdroid.bool

AGENTS.md

@@ -0,0 +1,40 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+- Source: `src/` (ES modules, SCSS). Key areas: `src/components/`, `src/pages/`, `src/lib/`, `src/plugins/` (Cordova plugins), `src/styles/`.
+- Web assets: `www/` (entry `index.html`, build output in `www/build/`, css/js subfolders).
+- Config: `webpack.config.js`, `.babelrc`, `biome.json`, `config.xml`.
+- Utilities: `utils/` (build, start, setup scripts; language and tooling helpers).
+
+## Build, Test, and Development Commands
+- `pnpm run setup`: Install deps, add Android platform, create build dirs, add plugins.
+- `pnpm run start -- android d`: Build and run on device/emulator (default dev). For release-like: `pnpm run start -- android p`.
+- `pnpm run build`: Build app (defaults to dev). Production example: `pnpm run build -- paid prod`. F-Droid variant: `pnpm run build -- paid prod fdroid`.
+- `pnpm run clean -- android android`: Recreate Android platform.
+- `pnpm run plugin -- <id> [path]`: Reinstall a Cordova plugin.
+- Linting/format: `pnpm run lint`, `pnpm run format`, `pnpm run check` (Biome).
+
+## Coding Style & Naming Conventions
+- Formatting: Biome enforced; indent with tabs (`biome.json`). Run `npm run format` before commits.
+- Language: ESM JavaScript, SCSS; prefer imports from `src` root (webpack `resolve.modules: ["node_modules", "src"]`).
+- Naming: camelCase for files/dirs (e.g., `fileSystem`, `quickTools`), PascalCase for classes/components, kebab-case for SCSS partials when applicable.
+
+## Testing Guidelines
+- No formal test runner configured. Provide clear manual verification steps for Android (device/emulator), including affected screens, repro steps, and expected/actual behavior.
+- Attach logs when relevant (see issue templates mention of `Acode.log`). Screenshots or screen recordings are encouraged for UI changes.
+
+## Commit & Pull Request Guidelines
+- Commits: Follow conventional style when possible (`feat:`, `fix:`, `chore(scope):`, etc.), reference issues (`(#123)`).
+- PRs: Include a concise summary, linked issues, screenshots for UI, and test/verification steps. Note any Cordova plugin or config changes.
+- Keep diffs focused; run `npm run lint` and ensure `www/build/` is generated by the pipeline, not committed.
+
+## Security & Configuration Tips
+- Building for F-Droid: pass `fdroid` as the third arg to `build` to toggle plugin set.
+- Do not commit secrets/keystores. Android signing is handled outside the repo; keep `keystore.jks` private.
+
+# When you need to call tools from the shell, use this rubric:
+
+- Find Files: `fd`
+- Find Text: `rg` (ripgrep)
+- Select among matches: pipe to `fzf`
+- JSON: `jq`