Pro 1.7 + public uniwind in a pnpm monorepo: Metro cannot resolve uniwind/index, then uniwind/components recurses #682

Activity

1. antoinerousseau commented on Sep 21, 2026

   

   antoinerousseau

   on Sep 21, 2026

   ContributorAuthor

   More actions

   Workaround

   We pinned Metro to the app’s own node_modules/uniwind (the Pro copy) instead of letting Node/require("uniwind/metro") walk up to a hoisted public uniwind. Drop this next to metro.config.js and wrap your Expo config with it.

   metro.uniwind-pro.js:

   const { execFileSync } = require("node:child_process");
   const fs = require("node:fs");
   const path = require("node:path");
   
   function readPackage(uniwindRoot) {
     return JSON.parse(
       fs.readFileSync(path.join(uniwindRoot, "package.json"), "utf8"),
     );
   }
   
   function ensureUniwindPro(projectRoot) {
     const uniwindDir = path.resolve(projectRoot, "node_modules/uniwind");
     if (!fs.existsSync(uniwindDir)) {
       throw new Error(
         `Uniwind Pro is not linked at ${uniwindDir}. Run your package manager from the workspace root.`,
       );
     }
   
     const uniwindRoot = fs.realpathSync(uniwindDir);
   
     // Installer stub has no `exports` until postinstall (`npx uniwind-pro` / UNIWIND_AUTH_TOKEN).
     if (!readPackage(uniwindRoot).exports) {
       execFileSync(
         process.execPath,
         [path.join(uniwindRoot, "pre/postinstall/index.js")],
         { cwd: uniwindRoot, stdio: "inherit" },
       );
     }
   
     const uniwindPackage = readPackage(uniwindRoot);
     if (!uniwindPackage.exports) {
       throw new Error(
         `Uniwind Pro is not installed in ${uniwindRoot}. Run \`npx uniwind-pro\` or set UNIWIND_AUTH_TOKEN.`,
       );
     }
   
     return { uniwindRoot, uniwindPackage };
   }
   
   function pickExportTarget(target, condition) {
     while (target && typeof target === "object") {
       target =
         target[condition] ??
         target["react-native"] ??
         target.default ??
         target.import;
     }
     return typeof target === "string" ? target : null;
   }
   
   function resolveExportPath(uniwindRoot, uniwindPackage, subpath, condition) {
     const target = pickExportTarget(uniwindPackage.exports[subpath], condition);
     if (target == null) {
       throw new Error(
         `Uniwind Pro has no "${condition}" export for ${subpath} in ${uniwindRoot}.`,
       );
     }
     return path.join(uniwindRoot, target);
   }
   
   function existingFile(filePath) {
     const withoutExt = filePath.replace(/\.(tsx|ts|jsx|js|cjs|mjs)$/, "");
     for (const candidate of [
       filePath,
       `${withoutExt}.tsx`,
       `${withoutExt}.ts`,
       `${withoutExt}.js`,
       path.join(filePath, "index.ts"),
       path.join(filePath, "index.tsx"),
       path.join(filePath, "index.js"),
     ]) {
       try {
         if (fs.statSync(candidate).isFile()) {
           return fs.realpathSync(candidate);
         }
       } catch {
         // try next
       }
     }
     return null;
   }
   
   function resolveFromDisk(uniwindRoot, uniwindPackage, moduleName, platform) {
     if (moduleName !== "uniwind" && !moduleName.startsWith("uniwind/")) {
       return null;
     }
   
     const condition = platform === "web" ? "browser" : "react-native";
     const subpath =
       moduleName === "uniwind" ? "." : `./${moduleName.slice("uniwind/".length)}`;
     const exportsField = uniwindPackage.exports;
   
     let target = pickExportTarget(exportsField[subpath], condition);
     if (target == null) {
       for (const [key, value] of Object.entries(exportsField)) {
         if (!key.includes("*")) continue;
         const [prefix, suffix = ""] = key.split("*");
         if (!subpath.startsWith(prefix) || !subpath.endsWith(suffix)) continue;
         const matched = subpath.slice(
           prefix.length,
           suffix ? subpath.length - suffix.length : undefined,
         );
         const picked = pickExportTarget(value, condition);
         if (picked) {
           target = picked.replaceAll("*", matched);
           break;
         }
       }
     }
   
     if (target == null) return null;
     const filePath = existingFile(path.join(uniwindRoot, target));
     if (filePath == null) return null;
     return { type: "sourceFile", filePath };
   }
   
   function withUniwindResolve(
     resolveRequest,
     { uniwindRoot, uniwindPackage, uniwindOrigin },
   ) {
     return (context, moduleName, platform) => {
       const fromDisk = resolveFromDisk(
         uniwindRoot,
         uniwindPackage,
         moduleName,
         platform,
       );
       if (fromDisk) return fromDisk;
   
       const resolve = resolveRequest ?? context.resolveRequest;
       if (moduleName === "uniwind" || moduleName.startsWith("uniwind/")) {
         return resolve(
           { ...context, originModulePath: uniwindOrigin },
           moduleName,
           platform,
         );
       }
       return resolve(context, moduleName, platform);
     };
   }
   
   /**
    * Pin Metro to this app's uniwind-pro copy so a hoisted public `uniwind`
    * (same package name) cannot be loaded instead.
    *
    * - Loads `withUniwindConfig` from this copy's `exports["./metro"]`
    * - Maps `uniwind` / `uniwind/*` to that copy's `exports` targets on disk
    *   (avoids Metro's missing `main` → `index` fallback)
    * - Pins `originModulePath` as a fallback so `uniwind/components` redirects
    *   from files outside this app never hit the public copy (#353 / #570)
    */
   function withPinnedUniwind(config, uniwindOptions = {}) {
     const projectRoot =
       uniwindOptions.projectRoot ??
       config.projectRoot ??
       path.dirname(__filename);
     const { uniwindRoot, uniwindPackage } = ensureUniwindPro(projectRoot);
     const uniwindOrigin = path.join(projectRoot, "package.json");
     const pin = { uniwindRoot, uniwindPackage, uniwindOrigin };
   
     const { withUniwindConfig } = require(
       resolveExportPath(uniwindRoot, uniwindPackage, "./metro", "require"),
     );
   
     config.watchFolders = [
       ...new Set([...(config.watchFolders ?? []), uniwindRoot]),
     ];
   
     config.resolver.resolveRequest = withUniwindResolve(
       config.resolver.resolveRequest,
       pin,
     );
   
     const { projectRoot: _projectRoot, ...pluginOptions } = uniwindOptions;
     const uniwindConfig = withUniwindConfig(config, pluginOptions);
     uniwindConfig.resolver.resolveRequest = withUniwindResolve(
       uniwindConfig.resolver.resolveRequest,
       pin,
     );
   
     return uniwindConfig;
   }
   
   module.exports = { withPinnedUniwind };

   metro.config.js:

   const { getDefaultConfig } = require("expo/metro-config");
   const { withPinnedUniwind } = require("./metro.uniwind-pro");
   
   const config = getDefaultConfig(__dirname);
   
   module.exports = withPinnedUniwind(config, {
     cssEntryFile: "./global.css", // relative to the app root
     projectRoot: __dirname,       // required if this helper is not next to metro.config.js
   });

   Restart Metro with a cache reset after adding it (expo start -c).
2. antoinerousseau commented on Sep 21, 2026

   

   antoinerousseau

   on Sep 21, 2026

   ContributorAuthor

   More actions

   Opened an OSS PR for the missing main / react-native fallbacks: #683

   That covers the Metro …/uniwind/index error when exports is skipped. The origin pin for uniwind/components is already on OSS main via #570 — Pro 1.7 still needs that backport on the Pro payload (not in this repo).
3. Brentlok

   added

   triage

   uniwind-pro

   priority

   on Sep 21, 2026
4. Brentlok commented on Sep 24, 2026

   

   Brentlok

   on Sep 24, 2026

   Contributor

   More actions

   The origin pin for uniwind/components is already on OSS main via #570 — Pro 1.7 still needs that backport on the Pro payload (not in this repo).

   The origin pin is applied for both oss and pro versions. I wasn't able to reproduce the issue from your instructions alone, please extract minimal reproduction repo.
5. Brentlok

   added

   bugSomething isn't workingSomething isn't working

   and removed

   triage

   on Sep 24, 2026
6. jpudysz commented on Sep 28, 2026

   

   jpudysz

   on Sep 28, 2026

   Collaborator

   More actions

   I was able to reproduce this.

   

   Expo enables autolinking module resolution by default in monorepos, and it resolves native packages by name from inside the package's own folder. pnpm stores the aliased package in a folder named uniwind-pro, so looking up uniwind from there walks up to the hoisted public copy. The Pro app then bundles the public uniwind instead of Pro, and its react-native imports get rewritten back to itself. That's the Maximum call stack size exceeded and "main" has not been registered crash on launch.

   I have a fix that will be published with next pro version, until then you can:

   • Set "experiments": { "autolinkingModuleResolution": false } in app.json
   • Keep the public uniwind from being hoisted to the workspace root

   👍React with 👍1Reacted by Antoine Rousseau
7. jpudysz

   added

   pending-releaseFixed, waiting for new version to be releasedFixed, waiting for new version to be released

   on Sep 28, 2026
8. Brentlok

   assigned

   jpudysz

   on Sep 28, 2026
9. github-actions

   removed

   pending-releaseFixed, waiting for new version to be releasedFixed, waiting for new version to be released

   on Oct 1, 2026
10. github-actions commented on Oct 1, 2026

    

    github-actionsbot

    on Oct 1, 2026 – with GitHub Actions

    Contributor

    More actions

    New release is published: https://docs.uniwind.dev/pro/changelog

    ❤️React with ❤️1Reacted by Antoine Rousseau
11. github-actions

    closed this as completedon Oct 1, 2026