https://github.com/mgcrea/react-native-swiftui
SwiftUI components for React Native
https://github.com/mgcrea/react-native-swiftui
react-native swiftui
Last synced: 5 months ago
JSON representation
SwiftUI components for React Native
- Host: GitHub
- URL: https://github.com/mgcrea/react-native-swiftui
- Owner: mgcrea
- Created: 2025-03-06T16:10:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-01T10:41:57.000Z (5 months ago)
- Last Synced: 2026-02-01T16:08:03.952Z (5 months ago)
- Topics: react-native, swiftui
- Language: Swift
- Homepage: https://mgcrea.github.io/react-native-swiftui/
- Size: 1.95 MB
- Stars: 20
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Overview
Native SwiftUI components for React Native using the Fabric renderer. Build iOS forms and interfaces with SwiftUI's declarative syntax while maintaining a familiar React workflow.
## Features
- **🍎 Native SwiftUI** - Real SwiftUI components, not web views or custom drawings
- **🔧 No Dependencies** - Safe from supply chain attacks
- **⚡ Fabric Renderer** - Built on React Native's modern architecture
- **📝 TypeScript-first** - Full type safety and autocomplete support
- **🔄 Two-Way Binding** - State syncs between JavaScript and SwiftUI
- **📋 Form Components** - TextField, Picker, DatePicker, Toggle, Stepper, Slider
- **📐 Layout Components** - Form, Section, HStack, VStack, ZStack, Spacer
- **🎨 SF Symbols** - Full SF Symbol support with rendering modes and variable values
- **📱 Sheet Presentation** - Native modal sheets with detent support
- **🔌 Form Libraries** - Works with react-hook-form, TanStack Form, and more
> **Note:** This library is iOS-only. For Android, check out [@mgcrea/react-native-jetpack-compose](https://github.com/mgcrea/react-native-jetpack-compose).
## Demo
Try it yourself with the [Rxd AppStore application](https://apps.apple.com/fr/app/rxd/id6745904823?l=en-GB)
## Quick Start
### Installation
```bash
npm install @mgcrea/react-native-swiftui
# or
pnpm add @mgcrea/react-native-swiftui
# or
yarn add @mgcrea/react-native-swiftui
```
### Requirements
- React Native 0.78.0+ (New Architecture required)
- iOS 15.1+
### Basic Usage
```tsx
import { SwiftUI } from "@mgcrea/react-native-swiftui";
import { useState } from "react";
import { View } from "react-native";
export function ProfileForm() {
const [name, setName] = useState("");
const [active, setActive] = useState(false);
return (
);
}
```
## How It Works
SwiftUI components register themselves in a virtual tree that's rendered natively:
1. **React renders JSX** - Components return `null`, registering nodes in a tree
2. **Tree serialization** - The view tree is passed to native code as JSON
3. **SwiftUI renders** - Native SwiftUI renders the entire tree
4. **Events bridge back** - User interactions trigger React callbacks
This means 60fps native performance with no JavaScript layout overhead.
## Documentation
📚 **[Full Documentation](https://mgcrea.github.io/react-native-swiftui/)**
- **[Getting Started](https://mgcrea.github.io/react-native-swiftui/getting-started/installation/)** - Installation and setup
- **[Components](https://mgcrea.github.io/react-native-swiftui/components/overview/)** - SwiftUI tree components
- **[Standalone](https://mgcrea.github.io/react-native-swiftui/standalone/sfsymbol/)** - Native components like SFSymbol
- **[Guides](https://mgcrea.github.io/react-native-swiftui/guides/styling/)** - Styling, events, and form integration
- **[Examples](https://mgcrea.github.io/react-native-swiftui/examples/basic-form/)** - Complete working examples
## Contributing
Contributions are welcome! To run the example project:
```bash
git clone https://github.com/mgcrea/react-native-swiftui.git
cd react-native-swiftui
pnpm install
pnpm run codegen:ios
cd example
pnpm install
pnpm run install:ios
pnpm run ios
```
## Credits
- [SwiftUI](https://developer.apple.com/xcode/swiftui/) - Apple's declarative UI framework
- [React Native](https://reactnative.dev/) - Build native apps using React
## Authors
- [Olivier Louvignes](https://github.com/mgcrea) - [@mgcrea](https://twitter.com/mgcrea)
```text
MIT License
Copyright (c) 2025 Olivier Louvignes
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```