feat(client): Added Capacitor Apps for iOS & Android

[ayush-teon]

No description provided.

[fortuna]

What is husky being used for?

[ayush-teon]

Husky is only added as a dev dependency right now; there’s no .husky config or hook scripts wired up in this repo, so it isn’t actively used yet.

[fortuna]

If it's not being used, please don't add. No dead code.

[ayush-teon]

Its has been removed now..

[fortuna]

What's the source for these?
Is there any actual transformation, or do we use the sources unmodified?

[asad-kodx]

Here's the source for Capacitor generated assets.
https://github.com/nthlink/outline-apps/tree/master/client/capacitor/assets
these sources are modified using following capacitor assets plugin in https://github.com/nthlink/outline-apps/blob/master/client/capacitor/build.action.mjs at line# 74.
await spawnStream('npx', 'capacitor-assets', 'generate');

[fortuna]

Do we also generate this?

[asad-kodx]

Yes, these are auto generated during build.

[fortuna]

When and how is this generated in the development workflow?

[asad-kodx]

similar to above here is the source for Capacitor generated assets.
https://github.com/nthlink/outline-apps/tree/master/client/capacitor/assets
these sources are modified using following capacitor assets plugin in https://github.com/nthlink/outline-apps/blob/master/client/capacitor/build.action.mjs at line# 74.
await spawnStream('npx', 'capacitor-assets', 'generate');

[Copilot]

Pull request overview

Adds Capacitor-based iOS/Android builds for the client, including native plugin bindings and build tooling to support mobile runtime behavior.

Changes:

• Introduces Capacitor workspace/package, native iOS/Android projects, and build/start actions for Capacitor targets
• Adds a Capacitor-native plugin interface (VPN/error reporting) plus webpack entry/config for Capacitor builds
• Updates web UI/layout to handle mobile safe-area insets and migrates ContactView select to Material Web components

Reviewed changes

Copilot reviewed 88 out of 98 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
package.json	Adds client/capacitor workspace and Husky dev dependency
infrastructure/platforms.ts	Adds Capacitor runtime/platform detection helpers
client/web/webpack_capacitor.mjs	Adds webpack config for Capacitor web build/dev server
client/web/views/root_view/root_header/index.ts	Adds safe-area inset handling for header
client/web/views/root_view/privacy_acknowledgement_dialog/index.ts	Fixes formatting/indentation (no logic change)
client/web/views/licenses_view/index.ts	Adds safe-area inset handling for licenses view
client/web/views/language_view/index.ts	Adds safe-area inset handling for language view
client/web/views/contact_view/index.ts	Migrates select UI to Material Web + safe-area padding updates
client/web/views/about_view/index.ts	Adds safe-area inset handling for about view
client/web/ui_components/app-root.js	Adjusts root path when running under Capacitor
client/web/index_capacitor.html	Adds Capacitor-specific HTML entrypoint
client/web/get_browser_webpack_config.mjs	Routes Capacitor platforms to webpack_capacitor config
client/web/app/url_interceptor.ts	Guards Cordova webintent usage for non-Cordova runtimes
client/web/app/plugin.cordova.ts	Adds runtime checks + listener registration helper for Cordova plugin
client/web/app/plugin.capacitor.ts	Adds Capacitor plugin exec + listener registration helpers
client/web/app/outline_server_repository/vpn.cordova.ts	Switches status listener registration to shared helper
client/web/app/outline_server_repository/vpn.capacitor.ts	Adds Capacitor VPN API implementation
client/web/app/main.cordova.ts	Uses pluginExec wrapper for quit flow
client/web/app/main.capacitor.ts	Adds Capacitor main entry: splash, browser, method channel, platform impl
client/web/app/browser.ts	Adds Capacitor in-app browser link interception
client/package.json	Adds Capacitor deps; updates clean script; removes old Husky
client/capacitor/www/manifest.json	Adds Capacitor web manifest (icons)
client/capacitor/www/mainfest.json	Adds duplicate manifest file with misspelled name
client/capacitor/webpack.config.js	Adds local webpack config (Capacitor package)
client/capacitor/tsconfig.json	Adds TS config for Capacitor package tooling
client/capacitor/start.action.mjs	Adds dev-server/hot-reload action that patches Capacitor config
client/capacitor/src/index.js	Adds sample entry file (device info)
client/capacitor/plugins/capacitor-plugin-outline/tsconfig.json	Adds TS config for Capacitor Outline plugin
client/capacitor/plugins/capacitor-plugin-outline/src/web.ts	Adds web stub implementation for Capacitor plugin
client/capacitor/plugins/capacitor-plugin-outline/src/index.ts	Registers Capacitor plugin entrypoint
client/capacitor/plugins/capacitor-plugin-outline/src/definitions.ts	Adds TypeScript definitions for plugin API
client/capacitor/plugins/capacitor-plugin-outline/package.json	Adds plugin package metadata/build script
client/capacitor/plugins/capacitor-plugin-outline/ios/Sources/CapacitorPluginOutline/CapacitorPluginOutlineImplementation.swift	Adds iOS native implementation for VPN/error reporting
client/capacitor/plugins/capacitor-plugin-outline/ios/Sources/CapacitorPluginOutline/CapacitorPluginOutline.swift	Adds Capacitor bridged plugin wrapper
client/capacitor/plugins/capacitor-plugin-outline/ios/Package.swift	Adds SwiftPM package for iOS plugin
client/capacitor/plugins/capacitor-plugin-outline/android/src/main/res/values/bypass_subnets.xml	Adds Android resource reference (currently not valid XML content)
client/capacitor/plugins/capacitor-plugin-outline/android/src/main/java/org/outline/CapacitorPluginOutline.kt	Adds Android native plugin implementation
client/capacitor/plugins/capacitor-plugin-outline/android/build.gradle	Adds Android library build for plugin
client/capacitor/package.json	Adds Capacitor app package + sync scripts
client/capacitor/ios/debug.xcconfig	Adds placeholder xcconfig
client/capacitor/ios/App/VpnExtension/VpnExtension.entitlements	Adds VpnExtension entitlements link/reference
client/capacitor/ios/App/VpnExtension/Sources	Adds VpnExtension sources link/reference
client/capacitor/ios/App/VpnExtension/Info.plist	Adds VpnExtension Info.plist link/reference
client/capacitor/ios/App/CapApp-SPM/Sources/CapApp-SPM/Empty.swift	Adds SwiftPM placeholder source
client/capacitor/ios/App/CapApp-SPM/Package.swift	Adds pinned SwiftPM dependencies for Capacitor iOS app
client/capacitor/ios/App/App/OutlineViewController.swift	Adds custom bridge view controller + debugging helpers
client/capacitor/ios/App/App/Info.plist	Adds iOS app Info.plist for Capacitor target
client/capacitor/ios/App/App/Base.lproj/LaunchScreen.storyboard	Adds iOS launch screen storyboard
client/capacitor/ios/App/App/Assets.xcassets/Splash.imageset/Contents.json	Adds splash asset catalog metadata
client/capacitor/ios/App/App/Assets.xcassets/AppIcon.appiconset/Contents.json	Adds app icon asset catalog metadata
client/capacitor/ios/App/App/AppDelegate.swift	Adds iOS app delegate with webview recovery + URL handling
client/capacitor/ios/App/App/App.entitlements	Adds iOS app entitlements for VPN/app groups
client/capacitor/ios/App/App.xcodeproj/xcshareddata/xcschemes/VpnExtension.xcscheme	Adds shared scheme for VPN extension
client/capacitor/ios/App/App.xcodeproj/xcshareddata/xcschemes/Outline.xcscheme	Adds shared scheme for app
client/capacitor/ios/App/App.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved	Adds SwiftPM resolved pins
client/capacitor/ios/App/App.xcodeproj/project.pbxproj	Adds Xcode project wiring for app + extension
client/capacitor/ios/.gitignore	Adds iOS project ignores for generated artifacts
client/capacitor/capacitor.config.json	Adds Capacitor config (splash/server/ios settings)
client/capacitor/build/templates/ios/CapApp-SPM.Package.swift.template	Adds template used to restore overwritten SwiftPM config
client/capacitor/build/templates/android/settings.gradle.template	Adds template used to restore Android settings.gradle
client/capacitor/build/templates/android/capacitor.build.gradle.template	Adds template used to restore capacitor.build.gradle
client/capacitor/build/cap-sync-ios.mjs	Adds wrapper to sync iOS + reapply templates + resize splash images
client/capacitor/build/cap-sync-android.mjs	Adds wrapper to sync Android + reapply templates
client/capacitor/build.action.mjs	Adds Capacitor build action for iOS/Android (debug/release)
client/capacitor/android/variables.gradle	Adds Android build variables/versions
client/capacitor/android/settings.gradle	Adds Android settings.gradle (template-based)
client/capacitor/android/gradlew.bat	Adds Windows Gradle wrapper script
client/capacitor/android/gradlew	Adds POSIX Gradle wrapper script
client/capacitor/android/gradle/wrapper/gradle-wrapper.properties	Pins Gradle distribution
client/capacitor/android/gradle.properties	Adds Gradle properties
client/capacitor/android/capacitor.settings.gradle	Adds Capacitor-generated module includes
client/capacitor/android/build.gradle	Adds Android top-level build config (template-based)
client/capacitor/android/app/src/test/java/com/getcapacitor/myapp/ExampleUnitTest.java	Adds example unit test (currently mismatched package)
client/capacitor/android/app/src/main/res/xml/file_paths.xml	Adds FileProvider paths
client/capacitor/android/app/src/main/res/values/styles.xml	Adds Android styles (theme/splash theme)
client/capacitor/android/app/src/main/res/values/strings.xml	Adds Android string resources
client/capacitor/android/app/src/main/res/values/ic_launcher_background.xml	Adds launcher background color
client/capacitor/android/app/src/main/res/layout/activity_main.xml	Adds main activity layout
client/capacitor/android/app/src/main/java/org/outline/client/MainActivity.java	Adds Capacitor BridgeActivity
client/capacitor/android/app/src/main/AndroidManifest.xml	Adds Android manifest with VPN service + receiver wiring
client/capacitor/android/app/src/androidTest/java/com/getcapacitor/myapp/ExampleInstrumentedTest.java	Adds example instrumented test (assert currently incorrect)
client/capacitor/android/app/proguard-rules.pro	Adds ProGuard rules file
client/capacitor/android/app/capacitor.build.gradle	Adds capacitor.build.gradle (template-based)
client/capacitor/android/app/build.gradle	Adds app build.gradle with Outline deps + Java 17 config
client/capacitor/android/app/.gitignore	Adds ignore rules for Android app build dir
client/capacitor/android/.gitignore	Adds Android project ignores
client/capacitor/README.md	Adds developer instructions for Capacitor builds
client/build/get_build_parameters.mjs	Adds Capacitor platforms to allowed build parameters
client/.gitignore	Expands ignores (IDE, node_modules, outputs, icons)
.gitignore	Ignores generated Capacitor icon/splash assets and plugin build outputs

Comments suppressed due to low confidence (5)

client/capacitor/www/mainfest.json:1

• This file appears to be a duplicate of manifest.json with a misspelled filename (mainfest.json). Keeping both risks shipping or referencing the wrong manifest; remove this file or rename it to manifest.json and ensure only one source of truth is referenced.
  client/capacitor/www/manifest.json:1
• The manifest icon src uses .webp files, but the declared MIME type is image/png. This mismatch can cause the icons to be ignored by user agents. Update the type to image/webp (preferred) or switch the icon files to .png to match the declared type.
  client/web/app/plugin.capacitor.ts:1
• The default: case declares const variables without wrapping the case body in braces. In TS/JS, lexical declarations in switch cases must be scoped (e.g., default: { ... }) to avoid compile errors and/or case-leakage. Wrap the default body in a block and ensure the control flow exits the switch cleanly.
  client/web/app/plugin.capacitor.ts:1
• This import reaches into another package’s src/ path, which couples the web app to that package’s internal layout and bypasses its published entrypoints/build output. Prefer importing from the plugin package entry (e.g., the package name) or a stable, exported module path so refactors/build output changes won’t break consumers.
  client/capacitor/plugins/capacitor-plugin-outline/android/src/main/res/values/bypass_subnets.xml:1
• This file is not valid Android XML resource content; AAPT will fail to parse it if it’s treated as a normal resource file. If the intent is to reference a shared resource via symlink, ensure it is committed as an actual symlink (mode 120000) in git; otherwise copy/generate the real XML into this path as part of the build.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

You can also share your feedback on Copilot code review. Take the survey.

[fortuna]

We should probably use Java 21, not 17.

[ayush-teon]

Updated

[ayush-teon]

Updated

[ayush-teon]

Updated

[fortuna]

If it's not being used, please don't add. No dead code.

[fortuna]

Remove the example files

[ayush-teon]

Removed

[fortuna]

Remove the example files

[ayush-teon]

Removed

[fortuna]

This package shouldn't be needed. We can edit the app project directly, and add the Swift dependencies to the XC workspace.

[ayush-teon]

No — that package is wired into the iOS Xcode project as a local Swift package dependency. The project references CapApp-SPM explicitly, so removing Package.swift would break the workspace unless we also rewrite the Xcode project and maintain those dependencies manually after any Capacitor update.

[fortuna]

We shouldn't need this if we are putting the dependencies in the right place.

[ayush-teon]

Updated

[fortuna]

Same here, we shouldn't need this because we can edit the XC workspace directly.

[ayush-teon]

Updated