Lynx Capacitor

Run Capacitor v8 plugins on Lynx (ReactLynx). The adapter reimplements the Capacitor bridge over Lynx's NativeModule API, so existing Capacitor plugin packages can keep their JavaScript and native implementations.

This repository integrates all 37 plugin APIs listed in the Capacitor v8 documentation. The packages use their official Android and iOS implementations where available.

• Drop-in replacement for @capacitor/core
• Implements registerPlugin() exactly as Capacitor does
• Handles promise/callback/event listener dispatch over Lynx
• Re-exports all type definitions from Capacitor
• Provides built-in implementations for:
  • CapacitorHttp (native HTTP client)
  • CapacitorCookies (cookie access)
  • SystemBars + SystemBarsStyle + SystemBarType (system bar styling)
• Routes unmodified @capacitor/* packages from npm — no plugin JS fork needed

• Ships as a Lynx native library — a lynx.lib.json manifest plus an iOS podspec, so Lynx Autolink links and registers it from node_modules
• Implements CAPBridgeProtocol for installed Capacitor iOS plugin implementations
• Uses the real @capacitor/ios framework and official native plugin CocoaPods
• Bridges Lynx NativeModule JS calls into the official Capacitor plugin infrastructure
• Discovers plugins at runtime — every CAPPlugin subclass linked into the app is registered, with no class list to maintain
• Handles result serialization back to JS
• Supports native UI presentation (view controllers, action sheets, alerts)
• Motion plugin provided natively (official npm doesn't ship iOS native yet)

• Hosts Capacitor 8.4.2 without constructing a WebView; plugin calls and results use Lynx NativeModule callbacks
• Keeps an AppCompatActivity for Activity Result and runtime-permission dispatch, so Camera and other UI plugins use their unchanged Android implementations
• Scans node_modules packages containing capacitor.android, includes their Gradle projects, and generates both plugin and Lynx-module registries
• Supports pnpm symlinks plus explicit include/exclude filters
• Delivers retained listener results through Lynx GlobalEventEmitter; Motion uses the runtime's native Android SensorManager implementation

The runtime is shared by both Android and iOS; it is not Android-specific. A native Lynx host installs both packages: Rspeedy bundles core, while native Autolink consumes runtime.

1. Install the official Capacitor plugins you want:

npm install @capacitor/device @capacitor/preferences @capacitor/filesystem

2. Install this adapter — the JS shim, native runtime, and target platform:

# Android
npm install @lynx-capacitor/core @lynx-capacitor/runtime @capacitor/android

# iOS
npm install @lynx-capacitor/core @lynx-capacitor/runtime @capacitor/ios

3. Add an alias in your Lynx build config:

// lynx.config.ts (rspeedy)
export default defineConfig({
  resolve: {
    alias: {
      '@capacitor/core': require.resolve('@lynx-capacitor/core'),
    },
  },
});

The host app performs the native Autolink setup once per target platform. After that, Android refreshes installed plugins during Gradle sync/build and iOS does so during pod install; there is no per-plugin Java/Kotlin, Swift/Objective-C, Gradle dependency, or Podfile registration list to maintain.

Load the settings plugin included in @lynx-capacitor/runtime and point it at the app's node_modules:

// settings.gradle.kts
pluginManagement {
  includeBuild("../node_modules/@lynx-capacitor/runtime/gradle-plugin")
}
plugins {
  id("org.lynxcapacitor.settings")
}

include(":app")
lynxCapacitor { nodeModulesPath = "../node_modules" }

Apply autolink to the Android application:

// app/build.gradle.kts
plugins {
  id("com.android.application")
  id("org.lynxcapacitor.autolink")
}

Register the generated Lynx module before building the view:

val builder = LynxViewBuilder()
LynxGeneratedLibraryRegistry.setup(builder)
val lynxView = builder.build(this)
setContentView(lynxView)
LynxCapacitorRuntime.attach(this)

The complete host is in android/Demo. Installed Capacitor packages are the only plugin list; no manual Java/Kotlin registration is needed. Adding a plugin later is npm install + Gradle sync/build. The Demo uses minSdk 28 because its installed @capacitor/local-llm package requires it, while the runtime itself supports minSdk 24.

For Deep Links, add the usual Android VIEW intent filter and forward warm intents from your Activity. The cold-start URL is available through App.getLaunchUrl(); warm links emit appUrlOpen:

override fun onNewIntent(intent: Intent) {
  super.onNewIntent(intent)
  LynxCapacitorRuntime.onNewIntent(intent)
}

4. Turn on both autolink plugins in your Podfile:

plugin 'cocoapods-lynx-library'    # gem 'cocoapods-lynx-library', '~> 4.0'
plugin 'cocoapods-lynx-capacitor'  # gem 'cocoapods-lynx-capacitor'

target 'YourApp' do
  use_lynx_library!        # the Capacitor bridge, as a Lynx native library
  use_capacitor_plugins!   # the Capacitor plugins it dispatches to
end

No plugin is named anywhere. use_lynx_library! finds @lynx-capacitor/runtime in node_modules, adds the LynxCapacitorRuntime pod, and generates a registry that registers the CapacitorBridge native module. use_capacitor_plugins! finds every package with a capacitor key in its package.json and adds its pod.

5. Invoke the generated registry when you build your LynxConfig:

#import <LynxLibraryRegistry/LynxGeneratedLibraryRegistry.h>

LynxConfig *config = [[LynxConfig alloc] initWithProvider:provider];
[[LynxGeneratedLibraryRegistry new] setup:config];
[[LynxEnv sharedInstance] prepareConfig:config];

Deep Links also keep Capacitor's usual App API. Forward both AppDelegate URL entry points to the runtime (and keep the normal URL scheme / Associated Domains configuration in your host):

#import <LynxCapacitorRuntime/LynxCapacitorRuntime-Swift.h>

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
  return [LynxCapacitorRuntime handleOpenURL:url options:options];
}

- (BOOL)application:(UIApplication *)application
    continueUserActivity:(NSUserActivity *)activity
      restorationHandler:
          (void (^)(NSArray<id<UIUserActivityRestoring>> *))handler {
  return [LynxCapacitorRuntime handleContinueUserActivity:activity
                                       restorationHandler:handler];
}

That's it! Your existing Capacitor plugin code will just work on Lynx. Adding another plugin later is npm install + pod install — no Podfile edit, no Swift or ObjC, no registration code.

Nothing is generated into your source tree, and no Podfile section is rewritten behind your back.

• Node.js 18+
• pnpm or npm
• Android Studio / Android SDK 36, JDK 21 (Android runtime minSdk 24)
• Xcode 15+
• iOS 15+ deployment target (required by Capacitor 8)
• Lynx SDK 4.1+
• CocoaPods

pnpm install
pnpm android:run

Use a specific device:

ANDROID_SERIAL=emulator-5554 pnpm android:run

For iOS:

pnpm ios:run

Override the simulator:

SIMULATOR='iPhone 17 Pro' pnpm ios:run

Override Lynx location if it's not at ../lynx:

LYNX_ROOT=/path/to/lynx pnpm ios:run

The current Capacitor v8 API list contains 37 official plugin APIs. This repository integrates all of them:

pnpm verify
pnpm verify:android
pnpm ios:test

The demo exposes globalThis.runCapacitorSmokeMatrix() for DevTool automation. The original Android cloud-device run passed 29/29 automatic actions across 28 gallery entries: 25 official plugins and 3 Community plugins. A follow-up run verified Calendar with a create/find/delete round-trip and Contacts with a save/find/remove round-trip. All eight official interactive entries were also exercised manually: Dialog, Action Sheet, Share, Camera, File Viewer, Browser, InAppBrowser, and Motion. These results do not claim end-to-end coverage for the partial/config-gated entries. See the cloud-device verification report.

lynx-capacitor/
├── packages/core/          # npm package - drop-in @capacitor/core adapter
├── packages/runtime/       # Native runtime + included Gradle Android autolink plugin
├── gems/                   # cocoapods-lynx-capacitor - links plugin pods from node_modules
├── demo/                   # ReactLynx gallery for 37 official + 3 Community plugins
├── ios/Demo/               # Standalone iOS host (XcodeGen + CocoaPods)
├── android/Demo/           # Standalone Android Lynx host
├── plugins.json            # Plugin coverage reference (documentation only)
├── scripts/                # Build/run/generate scripts
└── VERIFICATION.md         # Detailed plugin-by-plugin verification

MIT