Compatibility

The React Native, Expo, Node, JDK, Android and iOS versions Lucent supports.

	Supported
React Native	0.88 or later, New Architecture
Expo	SDK 58 or later, in a development build
Node	22.12 or later
JDK, for Android builds	17 to 21
Android	API 24 and later; newer APIs need an `available` check
iOS	React Native's minimum iOS version
Xcode, Android SDK and NDK	the versions your React Native version needs

lucent doctor checks these on your machine, and this table is generated from the same numbers.

Tested on the iOS simulator (Xcode 27) and the Android emulator, in the example apps, bare and Expo. Not yet on physical devices (roadmap).

Start

What is Lucent Install Lucent Your first module

Tutorial: a trip tracker

1. Measure a trip in shared code 2. Keep the trip in native code 3. Simplify the route off the JS thread 4. Throw errors JavaScript can handle 5. Read the position from iOS and Android 6. Send live positions to JavaScript 7. Ask for the location permission 8. Publish the module as a package

How Lucent works

How a module becomes native code How a call reaches native code How an SDK call reaches iOS and Android

Thinking in Lucent

Three places your code runs Design the boundary first Write shared code first, platform code last Which thread your code runs on When memory is freed What changes from JavaScript Coming from Swift or Kotlin

Guides

Call an iOS API Call an Android API Find an SDK class Implement a delegate or listener Send events to JavaScript Accept a JS callback Run work off the JS thread Cancel work Run code on the main thread Present a view controller Throw and handle errors Check the OS version Share code between iOS and Android Add permissions and native config Use a third-party SDK Publish a Lucent library Use a Lucent library Port an Expo Module Port a TurboModule or Nitro module Test a module Debug a crash Measure performance Upgrade Xcode, the Android SDK or Lucent

Reference

Language features Built-ins Types across the boundary SDK types The lucent:* modules CLI lucent.json Metro, Expo and editor options Diagnostics Compatibility

Examples

Examples that call iOS and Android Clipboard Location Network state Local authentication Secure store Haptics

More

Lucent, Expo Modules, Nitro and Turbo Native Modules Frequently asked questions Roadmap