Uniwind Pro cannot be installed with Bun following the official guide

[ciacka]

What happened?

Can't install Uniwind Pro with Bun following the official installation guide.
I have an active Individual license.

Environment

• macOS
• Package manager: Bun
• Bun version: 1.3.3
• Expo: newly created project

Steps to Reproduce

1. Create a new expo project: bun create expo-app my-app

2. Navigate to the project directory

3. Run the command from the installation guide:
   bun add uniwind@npm:uniwind-pro.

   It fails with the following error

   error: No version matching "npm:uniwind-pro" found for specifier "uniwind-pro" (but package exists)
   
   error: GET https://registry.npmjs.org/uniwind@npm:uniwind-pro - 404
   error: uniwind@npm:uniwind-pro failed to resolve
   error: uniwind@npm:uniwind-pro@^1.0.0 failed to resolve
   

4. Run bunx uniwind-pro

   • login
   • select install
   • no errors reported

5. Repeat step 2 → same error.

6. Run bunx uniwind-pro again → new error

   npm error Missing script: "postinstall"
   

7. Create bunfig.toml (both in project and home directory) and repeat step 6 → same error.

Snack or Repository Link (Optional)

No response

Uniwind version

1.0.0

React Native Version

0.81.5

Platforms

Android

Expo

Yes

Additional information

• I've searched for similar issues in this repository and found none
• I am a Uniwind Pro user

[jpudysz]

Hey, thanks for the report!

Can you confirm if you see iOS Android, cxx folders in node_modules/uniwind?

It looks like npm error Missing script: "postinstall" means it was already installed!

[ciacka]

There's no node_modules/uniwind at all in the project.

[DavoCg]

Hello everyone,

I have exactly the same issue as @ciacka.
Unfortunately i did not keep the log of the first initial successful install after running bunx uniwind-pro.
I'm now also stuck in a loop where I can't reinstall Uniwind pro and bun add uniwind@npm:uniwind-pro results in

error: No version matching "npm:uniwind-pro" found for specifier "uniwind-pro" (but package exists)
error: uniwind@npm:uniwind-pro failed to resolve

Happy to share more if needed !

[ciacka]

I've created another fresh Expo project using npm this time – Uniwind has been installed without issues:

• "uniwind": "npm:uniwind-pro@^1.0.0-beta.5" has been added to the package.json file
• the uniwind directory exists in the project's node_modules

[jpudysz]

Thank you guys for the confirmation.

@DavoCg please use valid and explicit version number eg. beta.5

[DavoCg]

Hey @jpudysz, it works with npm as @ciacka mentioned and also with bun with explicit version.

We will now try to setup our CI/CD with appropriate license to verify everything works.

I'll update this comment once done

Edit : For some reason it only installed correctly once with bun, not hitting the same issue with explicit version, we will use npm for now and debug later

[ciacka]

Here is a working setup using Bun where Uniwind Pro installs and runs correctly from a fresh Expo project.

Working steps (Bun)

Assuming you've created Expo project with bun create expo-app my-app

1. Install Uniwind Pro with explicit version and alias. This must result in a package.json entry with the uniwind key. If installed as uniwind-pro, things will break later.

   bun add uniwind@npm:uniwind-pro@^1.0.0-beta.5
   

2. Install Tailwind: bun add tailwindcss

3. Install required Expo dependencies: bun expo install react-native-nitro-modules expo-dev-client

4. Run Uniwind Pro installer: bunx uniwind-pro → Select Install Uniwind Pro

5. Create global.css and import it in _layout.tsx (if using Expo Router), according to the docs.

6. Generate and configure Babel config: bun expo customize babel.config.js → customize according to the docs

7. Generate and configure Metro config: bun expo customize metro.config.js→ customize according to the docs

8. Prebuild (Android only in my case): bun expo prebuild -p android

9. Run the app: bun android

Known issue & fix

If, when starting the app, you hit:

Error loading Metro config at .../metro.config.js
Cannot find module 'uniwind/metro'

running the bunx uniwind-pro and selecting Install Uniwind Pro again fixes it.

Docs feedback

@jpudysz it would be helpful if the Uniwind Pro installation docs explicitly listed all required setup steps, including those already described in the standard Uniwind documentation, or at least clearly referenced them. If someone starts directly with Uniwind Pro (without prior experience with the free version), it may not be obvious that the standard Uniwind setup steps still apply.

Hope this helps others who might run into similar Bun-related issues.

[jpudysz]

Just to confirm - have you see dedicated page with all installation steps?

https://docs.uniwind.dev/pro/installation

[jpudysz]

We're working on docs update. Thank you for your report 🙏🏼

[Brentlok]

We're working on docs update. Thank you for your report 🙏🏼

Installation of pro version with bun was updated. We've noticed that bun is able to install package with alias and without specific version, for example: bun add my-custom-name@npm:react-native. I'm not really sure why it doesn't work for uniwind-pro... Maybe because we don't have stable version, not really sure right now. Other package managers are working fine