Skip to main content

​
Prerequisites

Before installing Uniwind Pro, ensure you have an active Uniwind Pro license.

​
Install Dependencies

Install Uniwind Pro along with its required dependencies: 
bun add uniwind-pro react-native-nitro-modules react-native-reanimated react-native-worklets
Check the Compatibility page for supported React Native, Expo, and Nitro Modules versions.

​
Authenticate with GitHub

Run the CLI to authenticate: 
bunx uniwind-pro
You’ll see the following menu: 
  _   _       _          _           _   ____
 | | | |_ __ (_)_      _(_)_ __   __| | |  _ \ _ __ ___
 | | | | '_ \| \ \ /\ / / | '_ \ / _` | | |_) | '__/ _ \
 | |_| | | | | |\ V  V /| | | | | (_| | |  __/| | | (_) |
  \___/|_| |_|_| \_/\_/ |_|_| |_|\__,d| |_|   |_|  \___/


? What would you like to do?
❯ Login with Github
  Buy Uniwind Pro
  Exit
Select “Login with Github”:
  1. A browser tab will automatically open
  2. Sign in with your GitHub account
  3. Authorize the application
  4. Wait for the success message: “You can close this tab and return to the terminal.”
After successful authentication, you’ll see: 
? Hello @your-username, what would you like to do?
  Your session is valid for the next 179 days
────────────────────────────────────────────
❯ Manage your account
  Install Uniwind Pro
  Logout
  Exit
Your authentication session is valid for 180 days. After expiration, you’ll need to re-authenticate.

​
Install Uniwind Pro Package

From the CLI menu, select “Install Uniwind Pro”: 
? Hello @your-username, what would you like to do?
  Your session is valid for the next 179 days
────────────────────────────────────────────
  Manage your account
❯ Install Uniwind Pro
  Logout
  Exit
The CLI will automatically fetch and install the Uniwind Pro package from the CDN.
The installation process automatically handles version compatibility, ensuring you get the correct Pro version for your CLI.

​
Configure Babel

Add the react-native-worklets/plugin to your babel.config.js:
babel.config.js
module.exports = {
  // your presets and other configs
  plugins: [
    // other plugins
    'react-native-worklets/plugin',   
  ],
};
The react-native-worklets/plugin must be listed in the plugins array to work correctly.
If you’re already using Reanimated, you may already have react-native-reanimated/worklets in your config.

​
Whitelisting Postinstall Scripts

Some package managers block postinstall scripts by default for security reasons. If the Uniwind Pro installation fails or the package doesn’t work correctly, you may need to whitelist the postinstall script.
Bun runs postinstall scripts by default. If you’ve disabled them, add to your bunfig.toml:
bunfig.toml
[install]
# Allow postinstall scripts for uniwind-pro
trustedDependencies = ["uniwind-pro"]
If postinstall scripts don’t run, Uniwind Pro may fail to initialize correctly. You’ll see errors about missing native modules or configuration.

​
Rebuild Your App

After installation, rebuild your native app: 
npx expo prebuild --clean
Then run your app:
npx expo run:ios
# or
npx expo run:android
A native rebuild is required for Uniwind Pro to work correctly. Simply restarting Metro is not enough. Uniwind Pro doesn’t work with Expo Go.

​
Verify Installation

After rebuilding, verify that Uniwind Pro is working:
  1. Check that your app starts without errors
  2. Try using a Pro-only feature like Theme Transitions
  3. Verify the CLI shows your license status:
bunx uniwind-pro
You should see your username and session validity.
You can verify that the CLI stub was replaced with the actual Uniwind Pro code by checking if node_modules/uniwind-pro contains native modules (.cpp, .mm files) instead of just the CLI placeholder.

​
Troubleshooting

Try running the CLI with elevated permissions or check that your package manager has write access to node_modules.
See the Whitelisting Postinstall Scripts section above. Most issues are caused by package managers blocking scripts.
Ensure you’ve rebuilt the native app after installation. Delete ios/build and android/build folders, then rebuild.
Run uniwind-pro again and select “Login with Github” to re-authenticate. Sessions are valid for 180 days.
Each license type has monthly download limits. Check your dashboard for current usage. Limits reset at the start of each month.

Still having issues?

Open an issue on GitHub and we’ll help you out. Pro users receive priority support.