@sigx/lynx

SignalX for Lynx lets you build native iOS and Android apps with SignalX's signal/effect reactivity model on top of ByteDance's Lynx runtime — with cross-thread gestures and animations that run on the device's main UI thread.

@sigx/lynx is the package you import from in app code. It bundles @sigx/reactivity (state), @sigx/runtime-core (components, lifecycle), and @sigx/lynx-runtime (the dual-thread renderer) behind one import path, so app code says import { signal, component, useSharedValue } from '@sigx/lynx' and nothing else.

📚 Documentation

Full guides, the complete module catalog, API reference and live examples → sigx.dev/lynx

Why it's interesting

• Native, not WebView. Real UIView / View trees. Video maps to AVPlayer / ExoPlayer, maps to MKMapView / Google Maps, gestures hit the actual touch system — no DOM wrapper, no JS bridge in the hot path.
• Zero-config native modules. pnpm add @sigx/lynx-camera → sigx prebuild → done. The autolinker wires Podfile, Gradle, Info.plist, AndroidManifest.xml, and the native module registry from each package's signalx-module.json.
• Main-thread gestures & animations. Press, drag, swipe, scroll offsets, and spring + tween animations all run on Lepus (the platform's main thread), so your finger tracks at the display's refresh rate even when JS is busy.
• SharedValue — cross-thread state for free. Mutate from a 'main thread' worklet; read reactively from a SignalX effect on the background thread. Powers gestures, scroll, animation, and any custom "fast state lives on MT" use case.
• fetch is just there. Importing @sigx/lynx installs a global WHATWG fetch backed by native URLSession / OkHttp, plus a built-in leveled, namespaced logger that streams to the sigx dev terminal.
• A real native-module catalog. Camera, audio, video, maps, webview, biometric, secure storage, file system, location, notifications, share, clipboard, haptics, image picker, websocket, and more — all auto-linked.

Quick start

npm create @sigx@latest my-app
# pick: lynx (or lynx-tailwind)
cd my-app
pnpm install
pnpm dev

Then in another terminal:

pnpm run:ios       # or run:android

A minimal component:

// src/App.tsx
import { component, signal } from '@sigx/lynx';

const App = component(() => {
    const count = signal(0);
    return () => (
        <view>
            <text>count = {count.value}</text>
            <view bindtap={() => { count.value++; }}>
                <text>tap me</text>
            </view>
        </view>
    );
});

export default App;

The template wires the build plugin, the CLI, and a starter app for you.

The rest of the ecosystem

This package is the framework entry point. For the full list of native modules, UI packages, gestures, animation, navigation, icons, and dev tooling — see the module catalog on sigx.dev.

License

MIT — © Andreas Ekdahl