ctrlaltdylan · fazlulkabir34 · Mar 24, 2026 · Mar 24, 2026 · Mar 24, 2026 · Mar 24, 2026
diff --git a/.gitignore b/.gitignore
@@ -6,8 +6,8 @@ yarn-error.log*
 .pnpm-debug.log*
 
 # Build outputs
-dist/
-build/
+# dist/
+# build/
 *.tsbuildinfo
 
 # Environment files

diff --git a/CLAUDE.md b/CLAUDE.md
@@ -3,6 +3,9 @@
 Shopify embedded app testing solution - test locally without real credentials.
 
 ## Quick Start
+Requires Node.js `^20.19.0 || >=22.12.0` to build (Vite 7, used by admin-frame). The
+published package itself runs on Node 18+, which is what `engines.node` declares.
+
 - `npm install` - Install dependencies
 - `npm run build` - Build TypeScript
 - `npx ts-node src/cli/index.ts <app-url>` - Run dev server

diff --git a/README.md b/README.md
@@ -58,7 +58,7 @@
 | `shopify.environment` | ✅ Supported | `embedded`, `mobile`, `pos` |
 | `shopify.user` | ✅ Supported | Returns mock user object |
 | `shopify.scopes` | 🔶 Stub | Returns mock data |
-| `shopify.resourcePicker` | 🔶 Stub | Returns empty array |
+| `shopify.resourcePicker` | ✅ Mock UI | Opens a mock admin modal; catalog from [`/api/resource-picker-catalog`](docs/RESOURCE_PICKER.md) (customizable via `resourcePickerCatalog` on the server) |
 | `shopify.picker` | 🔶 Stub | Returns empty selection |
 | `shopify.scanner` | 🔶 Stub | Returns mock scan data |
 | `shopify.pos` | 🔶 Stub | Cart API with mock data |
@@ -85,6 +85,10 @@
 
 ## 📦 Installation
 
+> **Node.js requirements**
+> - **Using the package:** Node.js **18+**. The published package ships prebuilt, so you never run the build toolchain.
+> - **Building from source:** Node.js **^20.19.0 || >=22.12.0**, required by Vite 7 (the admin frame's bundler). This also applies when installing from a git ref, since `prepare` runs the full build. CI builds and publishes on Node 22.
+
 ```bash
 npm install @getverdict/mock-bridge --save-dev
 # or
@@ -307,6 +311,7 @@ export async function authenticate(token: string) {
 
 #### Framework-Specific Examples
 
+**Shopify App React Router** (`authenticate.admin(request)`): see the dedicated guide **[docs/SHOPIFY_APP_REACT_ROUTER.md](./docs/SHOPIFY_APP_REACT_ROUTER.md)**.
 **Next.js API Routes:**
 
 ```typescript
@@ -565,6 +570,11 @@ const server = new MockShopifyAdminServer({
   ],
   debug: true, // Enable debug logging
 
+  // Session token lifetime in seconds (default 60, matching real Shopify).
+  // Raise it for E2E runs — a test that outlives the token starts sending requests
+  // the app rejects, which looks like an unexplained mid-test redirect.
+  sessionTokenTtlSeconds: 3600,
+
   // Admin API handling (see below)
   adminApi: "mock",
 });

diff --git a/admin-frame/.gitignore b/admin-frame/.gitignore
@@ -8,7 +8,10 @@ pnpm-debug.log*
 lerna-debug.log*
 
 node_modules
-dist
+# `dist` is committed on purpose. Consumers install this package straight from git, and yarn
+# (unlike npm) does not run a git dependency's `prepare` script — so without the build output
+# in the repo the mock admin UI is never built and the embedded iframe renders blank.
+# dist
 dist-ssr
 *.local
 

diff --git a/admin-frame/dist/assets/index-CVLqddYM.css b/admin-frame/dist/assets/index-CVLqddYM.css
diff --git a/admin-frame/dist/assets/index-CqrXvEdF.js b/admin-frame/dist/assets/index-CqrXvEdF.js
diff --git a/admin-frame/dist/index.html b/admin-frame/dist/index.html
@@ -0,0 +1,15 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Mock Bridge</title>
+    <script src="https://cdn.shopify.com/shopifycloud/polaris.js"></script>
+    <script type="module" crossorigin src="/assets/index-CqrXvEdF.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CVLqddYM.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>
diff --git a/admin-frame/dist/vite.svg b/admin-frame/dist/vite.svg
diff --git a/admin-frame/package-lock.json b/admin-frame/package-lock.json
diff --git a/admin-frame/package.json b/admin-frame/package.json
@@ -3,6 +3,9 @@
   "private": true,
   "version": "0.0.0",
   "type": "module",
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",

diff --git a/admin-frame/src/App.tsx b/admin-frame/src/App.tsx
@@ -2,6 +2,7 @@ import { EmbeddedApp } from "./components/EmbeddedApp"
 import { Modal } from "./components/features/Modal"
 import { Loading } from "./components/features/Loading"
 import { SaveBar } from "./components/features/SaveBar"
+import { ResourcePicker } from "./components/features/ResourcePicker"
 import { Frame } from "./components/Frame"
 
 function App() {
@@ -10,6 +11,7 @@ function App() {
       <Loading />
       <Modal />
       <SaveBar />
+      <ResourcePicker />
 
       <EmbeddedApp />
     </Frame>