Skip to content

designervoid/spline-react-native

Repository files navigation

Spline for React Native (iOS Native & Cross-Platform via WebView)

Integrate Spline, a 3D scene tool — into your React Native app.
Native support is currently available for iOS only.
For cross-platform (iOS + Android), use spline-web with react-native-webview.

Platform Android iOS
Preview
Platform Native Support WebView Support
iOS SplnView.swift react-native-webview
Android ❌ Not yet supported react-native-webview

Getting Started

Make sure your React Native environment is set up. If not, follow the official guide.

1. Install Dependencies

npm install
# or
yarn install

2. Run the App

Start the Metro bundler:

npm start
# or
yarn start

Launch the iOS app:

npm run ios
# or
yarn ios

Native iOS Setup with SplnView

To use native Spline integration on iOS:

  1. Add SplnView.swift to your Xcode project.
  2. Make sure it's included in your build target.
  3. Add a bridging header if needed (for Swift + Objective-C).

Customization

You can extend or modify SplnView.swift as needed — update properties, methods, or embed additional functionality.

Troubleshooting

  • Ensure Xcode is properly configured for Swift and React Native.
  • Verify the Spline runtime and your scene URL.
  • Check your WebView permissions and links if using the cross-platform approach.

Resources

About

spline-ios library (https://github.com/splinetool/spline-ios) in RN 0.73.1 & React 18.2.0 Legacy Native Components

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published