# react-native-live-widgets > The All-in-One declarative TypeScript engine for iOS Live Activities, Dynamic Island, and interactive Home Screen Widgets in React Native & Expo (iOS 16.1+ & Android 16). Write 100% Declarative TypeScript (`UI.*`) in your React Native code. Automatically renders to native SwiftUI (WidgetKit) and Android High-DPI 2D Canvas without manually touching Xcode or Android Studio. ## Quick Reference for LLMs & AI Agents ### Core Modules - `LiveActivity`: Start, update, end, and inspect lock screen Live Activities & Dynamic Island on iOS, and Promoted Live Updates (`Notification.ProgressStyle`) on Android. - `Widget`: Set dynamic multi-page layouts (`pages`), configure background API polling (`setRemoteConfig`), trigger reload, and request in-app widget pinning (`requestPin` on Android). - `SharedStorage`: Fast synchronous App Group (iOS) and SharedPreferences (Android) key-value bridge. - `UI`: Declarative DSL builder (`UI.VStack`, `UI.HStack`, `UI.ZStack`, `UI.Text`, `UI.Button`, `UI.Progress`, `UI.Timer`, `UI.Equalizer`, `UI.Image`, `UI.Gauge`, `UI.Chart`). ### Installation & Scaffolding (Essential Commands) - **Expo (SDK 50, 51, 52, 58+ CNG & EAS Build)**: ```bash npx expo install react-native-live-widgets npx react-native-live-widgets init # 1-command: auto updates app.json, creates widgets.config.ts, syncs icons & Swift npx expo run:ios # or: npx expo run:android ``` - **Bare React Native CLI**: ```bash npm install react-native-live-widgets npx react-native-live-widgets init # 1-command: auto links Xcode target, Podfile, pod install, Android permissions, codegen npx react-native run-ios # or: npx react-native run-android ``` - **Updating widgets.config.ts**: ```bash npx react-native-live-widgets codegen # Re-syncs Swift bundle, iOS xcstrings, Android strings.xml & icon types ``` ### Dual UI Authoring Syntax: JSX Components & Functional DSL Widgets can be built with **EITHER** JSX elements or Functional DSL: - **JSX / TSX Elements**: ``, ``, ``, ``, ``, `