From 8371e06867a2e52395d73d883cc9ddbb19f8db84 Mon Sep 17 00:00:00 2001
From: broody <broody@gmail.com>
Date: Mon, 2 Feb 2026 11:17:51 -1000
Subject: [PATCH 1/4] feat: unified open entrypoint with auto-login and
 standalone support

---
 examples/next/src/components/Header.tsx |   2 +-
 packages/connector/src/controller.ts    |  22 +++
 packages/controller/src/controller.ts   | 184 +++++++++++++-----------
 packages/controller/src/types.ts        |   7 +
 4 files changed, 132 insertions(+), 83 deletions(-)

diff --git a/examples/next/src/components/Header.tsx b/examples/next/src/components/Header.tsx
index b712eb976e..5d4c58181c 100644
--- a/examples/next/src/components/Header.tsx
+++ b/examples/next/src/components/Header.tsx
@@ -180,7 +180,7 @@ const Header = () => {
         <div className="flex gap-2">
           <Button
             onClick={() => {
-              controllerConnector.controller.open({
+              controllerConnector.controller.openStandalone({
                 redirectUrl: window.location.href,
               });
             }}
diff --git a/packages/connector/src/controller.ts b/packages/connector/src/controller.ts
index a221a8341e..1a6597fbd8 100644
--- a/packages/connector/src/controller.ts
+++ b/packages/connector/src/controller.ts
@@ -1,6 +1,8 @@
 import ControllerProvider, {
   AuthOptions,
   ControllerOptions,
+  OpenOptions,
+  OpenPageTarget,
 } from "@cartridge/controller";
 import { Connector, InjectedConnector } from "@starknet-react/core";
 
@@ -47,6 +49,26 @@ export default class ControllerConnector extends InjectedConnector {
     return super.connect({ chainIdHint: args?.chainIdHint });
   }
 
+  async open(args: OpenPageTarget | "standalone", options?: any) {
+    return this.controller.open(args, options);
+  }
+
+  openStandalone(options?: OpenOptions) {
+    return this.controller.openStandalone(options);
+  }
+
+  async openProfile() {
+    return this.controller.openProfile();
+  }
+
+  async openSettings() {
+    return this.controller.openSettings();
+  }
+
+  async openStarterPack(id: string | number) {
+    return this.controller.openStarterPack(id);
+  }
+
   static fromConnectors(connectors: Connector[]): ControllerConnector {
     const connector = connectors.find((c) => c.id === "controller");
     if (!connector) {
diff --git a/packages/controller/src/controller.ts b/packages/controller/src/controller.ts
index 5f587e27f4..c0c5e53b9d 100644
--- a/packages/controller/src/controller.ts
+++ b/packages/controller/src/controller.ts
@@ -25,6 +25,7 @@ import {
   ProfileContextTypeVariant,
   ResponseCodes,
   OpenOptions,
+  OpenPageTarget,
   StarterpackOptions,
 } from "./types";
 import { validateRedirectUrl } from "./url-validator";
@@ -227,6 +228,7 @@ export default class ControllerProvider extends BaseProvider {
 
   async connect(
     signupOptions?: AuthOptions,
+    skipClose = false,
   ): Promise<WalletAccount | undefined> {
     if (!this.iframes) {
       return;
@@ -272,7 +274,9 @@ export default class ControllerProvider extends BaseProvider {
     } catch (e) {
       console.log(e);
     } finally {
-      this.iframes.keychain.close();
+      if (!skipClose || !this.account) {
+        this.iframes.keychain.close();
+      }
     }
   }
 
@@ -316,47 +320,18 @@ export default class ControllerProvider extends BaseProvider {
   }
 
   async openProfile(tab: ProfileContextTypeVariant = "inventory") {
-    if (!this.iframes) {
-      return;
-    }
-
-    // Profile functionality is now integrated into keychain
-    // Navigate keychain iframe to profile page
-    if (!this.keychain || !this.iframes.keychain) {
-      console.error(new NotReadyToConnect().message);
-      return;
-    }
-    if (!this.account) {
-      console.error("Account is not ready");
-      return;
-    }
-    const username = await this.keychain.username();
-
-    // Navigate first, then open to avoid flash
-    const options = [];
-    if (this.options.slot) {
-      options.push(`ps=${this.options.slot}`);
-    }
-    await this.keychain.navigate(
-      `/account/${username}/${tab}?${options.join("&")}`,
-    );
-    this.iframes.keychain.open();
+    return this.open({ target: "profile", tab });
   }
 
   async openProfileTo(to: string) {
-    if (!this.iframes) {
+    if (!(await this.ensureConnected())) {
       return;
     }
 
-    // Profile functionality is now integrated into keychain
-    if (!this.keychain || !this.iframes.keychain) {
+    if (!this.keychain || !this.iframes?.keychain) {
       console.error(new NotReadyToConnect().message);
       return;
     }
-    if (!this.account) {
-      console.error("Account is not ready");
-      return;
-    }
 
     const username = await this.keychain.username();
     const options = [];
@@ -370,35 +345,21 @@ export default class ControllerProvider extends BaseProvider {
   }
 
   async openProfileAt(at: string) {
-    if (!this.iframes) {
+    if (!(await this.ensureConnected())) {
       return;
     }
 
-    // Profile functionality is now integrated into keychain
-    if (!this.keychain || !this.iframes.keychain) {
+    if (!this.keychain || !this.iframes?.keychain) {
       console.error(new NotReadyToConnect().message);
       return;
     }
-    if (!this.account) {
-      console.error("Account is not ready");
-      return;
-    }
 
     await this.keychain.navigate(at);
     this.iframes.keychain.open();
   }
 
-  openSettings() {
-    if (!this.iframes) {
-      return;
-    }
-
-    if (!this.keychain || !this.iframes.keychain) {
-      console.error(new NotReadyToConnect().message);
-      return;
-    }
-    this.iframes.keychain.open();
-    this.keychain.openSettings();
+  async openSettings() {
+    return this.open({ target: "settings" });
   }
 
   revoke(origin: string, _policy: Policy[]) {
@@ -432,50 +393,31 @@ export default class ControllerProvider extends BaseProvider {
     return this.keychain.username();
   }
 
-  openPurchaseCredits() {
-    if (!this.iframes) {
-      return;
-    }
-
-    if (!this.keychain || !this.iframes.keychain) {
-      console.error(new NotReadyToConnect().message);
-      return;
-    }
-    this.keychain.navigate("/purchase/credits").then(() => {
-      this.iframes!.keychain?.open();
-    });
+  async openPurchaseCredits() {
+    return this.open({ target: "purchase-credits" });
   }
 
   async openStarterPack(
     id: string | number,
     options?: StarterpackOptions,
   ): Promise<void> {
-    if (!this.iframes) {
-      return;
-    }
-
-    if (!this.keychain || !this.iframes.keychain) {
-      console.error(new NotReadyToConnect().message);
-      return;
-    }
-
-    await this.keychain.openStarterPack(id, options);
-    this.iframes.keychain?.open();
+    return this.open({ target: "starterpack", id, options });
   }
 
   async openExecute(calls: any, chainId?: string) {
-    if (!this.iframes) {
-      return;
+    if (!(await this.ensureConnected())) {
+      return { status: false };
     }
 
-    if (!this.keychain || !this.iframes.keychain) {
+    if (!this.keychain || !this.iframes?.keychain) {
       console.error(new NotReadyToConnect().message);
-      return;
+      return { status: false };
     }
+
     // Switch to the chain if provided
     let currentChainId = this.selectedChain;
     if (chainId) {
-      this.switchStarknetChain(chainId);
+      await this.switchStarknetChain(chainId);
     }
     // Open keychain
     this.iframes.keychain.open();
@@ -485,7 +427,7 @@ export default class ControllerProvider extends BaseProvider {
     this.iframes.keychain.close();
     // Switch back to the original chain
     if (chainId) {
-      this.switchStarknetChain(currentChainId);
+      await this.switchStarknetChain(currentChainId);
     }
     const status = !(
       res &&
@@ -507,14 +449,92 @@ export default class ControllerProvider extends BaseProvider {
     return await this.keychain.delegateAccount();
   }
 
+  private async ensureConnected(signupOptions?: AuthOptions): Promise<boolean> {
+    if (this.account) {
+      return true;
+    }
+    const account = await this.connect(signupOptions, true);
+    return !!account;
+  }
+
+  /**
+   * Opens the keychain UI to a specific page or location.
+   * If the user is not connected, it will trigger the connection flow first.
+   * @param args - The target page and its parameters
+   */
+  async open(
+    args: OpenPageTarget | "standalone",
+    options?: any,
+  ): Promise<void> {
+    if (args === "standalone") {
+      return this.openStandalone(options);
+    }
+
+    if (!this.iframes) {
+      return;
+    }
+
+    if (!(await this.ensureConnected())) {
+      return;
+    }
+
+    if (!this.keychain || !this.iframes.keychain) {
+      console.error(new NotReadyToConnect().message);
+      return;
+    }
+
+    switch (args.target) {
+      case "settings":
+        this.iframes.keychain.open();
+        await this.keychain.openSettings();
+        return;
+      case "starterpack":
+        await this.keychain.openStarterPack(args.id, args.options);
+        this.iframes.keychain.open();
+        return;
+      case "profile":
+        const username = await this.keychain.username();
+        const profileOptions = [];
+        if (this.options.slot) {
+          profileOptions.push(`ps=${this.options.slot}`);
+        }
+        await this.keychain.navigate(
+          `/account/${username}/${args.tab ?? "inventory"}?${profileOptions.join("&")}`,
+        );
+        this.iframes.keychain.open();
+        return;
+      case "purchase-credits":
+        await this.keychain.navigate("/purchase/credits");
+        this.iframes.keychain.open();
+        return;
+      case "execute":
+        // Switch to the chain if provided
+        let currentChainId = this.selectedChain;
+        if (args.chainId) {
+          await this.switchStarknetChain(args.chainId);
+        }
+        // Open keychain
+        this.iframes.keychain.open();
+        // Invoke execute
+        await this.keychain.execute(args.calls, undefined, undefined, true);
+        // Close keychain
+        this.iframes.keychain.close();
+        // Switch back to the original chain
+        if (args.chainId) {
+          await this.switchStarknetChain(currentChainId);
+        }
+        return;
+    }
+  }
+
   /**
    * Opens the keychain in standalone mode (first-party context) for authentication.
    * This establishes first-party storage, enabling seamless iframe access across all games.
    * @param options - Configuration for redirect after authentication
    */
-  open(options: OpenOptions = {}) {
+  openStandalone(options: OpenOptions = {}) {
     if (typeof window === "undefined") {
-      console.error("open can only be called in browser context");
+      console.error("openStandalone can only be called in browser context");
       return;
     }
 
diff --git a/packages/controller/src/types.ts b/packages/controller/src/types.ts
index 2cb544a896..9d31d8e3db 100644
--- a/packages/controller/src/types.ts
+++ b/packages/controller/src/types.ts
@@ -270,6 +270,13 @@ export type OpenOptions = {
   redirectUrl?: string;
 };
 
+export type OpenPageTarget =
+  | { target: "starterpack"; id: string | number; options?: StarterpackOptions }
+  | { target: "settings" }
+  | { target: "profile"; tab?: ProfileContextTypeVariant }
+  | { target: "purchase-credits" }
+  | { target: "execute"; calls: Call[]; chainId?: string };
+
 export type StarterpackOptions = {
   /** The preimage to use */
   preimage?: string;

From 71b669a860cf770b2b34ee61a792582714862714 Mon Sep 17 00:00:00 2001
From: broody <broody@gmail.com>
Date: Wed, 4 Feb 2026 15:02:44 -1000
Subject: [PATCH 2/4] refactor: unify open entrypoint by moving standalone to a
 target

---
 examples/next/src/components/Header.tsx |  5 +++--
 packages/connector/src/controller.ts    |  8 ++------
 packages/controller/src/controller.ts   | 11 ++++-------
 packages/controller/src/types.ts        |  3 ++-
 4 files changed, 11 insertions(+), 16 deletions(-)

diff --git a/examples/next/src/components/Header.tsx b/examples/next/src/components/Header.tsx
index 5d4c58181c..0d7abc4dc4 100644
--- a/examples/next/src/components/Header.tsx
+++ b/examples/next/src/components/Header.tsx
@@ -180,8 +180,9 @@ const Header = () => {
         <div className="flex gap-2">
           <Button
             onClick={() => {
-              controllerConnector.controller.openStandalone({
-                redirectUrl: window.location.href,
+              controllerConnector.controller.open({
+                target: "standalone",
+                options: { redirectUrl: window.location.href },
               });
             }}
             disabled={!isControllerReady}
diff --git a/packages/connector/src/controller.ts b/packages/connector/src/controller.ts
index 1a6597fbd8..d63f3be46d 100644
--- a/packages/connector/src/controller.ts
+++ b/packages/connector/src/controller.ts
@@ -49,12 +49,8 @@ export default class ControllerConnector extends InjectedConnector {
     return super.connect({ chainIdHint: args?.chainIdHint });
   }
 
-  async open(args: OpenPageTarget | "standalone", options?: any) {
-    return this.controller.open(args, options);
-  }
-
-  openStandalone(options?: OpenOptions) {
-    return this.controller.openStandalone(options);
+  async open(args: OpenPageTarget) {
+    return this.controller.open(args);
   }
 
   async openProfile() {
diff --git a/packages/controller/src/controller.ts b/packages/controller/src/controller.ts
index c0c5e53b9d..030a3761f0 100644
--- a/packages/controller/src/controller.ts
+++ b/packages/controller/src/controller.ts
@@ -462,12 +462,9 @@ export default class ControllerProvider extends BaseProvider {
    * If the user is not connected, it will trigger the connection flow first.
    * @param args - The target page and its parameters
    */
-  async open(
-    args: OpenPageTarget | "standalone",
-    options?: any,
-  ): Promise<void> {
-    if (args === "standalone") {
-      return this.openStandalone(options);
+  async open(args: OpenPageTarget): Promise<void> {
+    if (args.target === "standalone") {
+      return this.openStandalone(args.options);
     }
 
     if (!this.iframes) {
@@ -532,7 +529,7 @@ export default class ControllerProvider extends BaseProvider {
    * This establishes first-party storage, enabling seamless iframe access across all games.
    * @param options - Configuration for redirect after authentication
    */
-  openStandalone(options: OpenOptions = {}) {
+  private openStandalone(options: OpenOptions = {}) {
     if (typeof window === "undefined") {
       console.error("openStandalone can only be called in browser context");
       return;
diff --git a/packages/controller/src/types.ts b/packages/controller/src/types.ts
index 9d31d8e3db..06b7a7fac6 100644
--- a/packages/controller/src/types.ts
+++ b/packages/controller/src/types.ts
@@ -275,7 +275,8 @@ export type OpenPageTarget =
   | { target: "settings" }
   | { target: "profile"; tab?: ProfileContextTypeVariant }
   | { target: "purchase-credits" }
-  | { target: "execute"; calls: Call[]; chainId?: string };
+  | { target: "execute"; calls: Call[]; chainId?: string }
+  | { target: "standalone"; options?: OpenOptions };
 
 export type StarterpackOptions = {
   /** The preimage to use */

From f5f52dddd5ec8539a5c4e445f33ed36f8b7f7ec9 Mon Sep 17 00:00:00 2001
From: broody <broody@gmail.com>
Date: Wed, 4 Feb 2026 15:40:37 -1000
Subject: [PATCH 3/4] docs: update examples to use unified open api

---
 examples/next/src/components/Header.tsx      |  4 +-
 examples/next/src/components/Profile.tsx     | 80 +++++++++++++++-----
 examples/next/src/components/Settings.tsx    |  3 +-
 examples/next/src/components/Starterpack.tsx | 16 ++--
 packages/controller/src/controller.ts        | 19 +++--
 packages/controller/src/types.ts             |  7 +-
 6 files changed, 90 insertions(+), 39 deletions(-)

diff --git a/examples/next/src/components/Header.tsx b/examples/next/src/components/Header.tsx
index 0d7abc4dc4..481965d87c 100644
--- a/examples/next/src/components/Header.tsx
+++ b/examples/next/src/components/Header.tsx
@@ -157,13 +157,13 @@ const Header = () => {
             <div className="absolute right-0 top-full mt-1 bg-background shadow-lg rounded-md min-w-[160px] py-1 z-10 border border-gray-600">
               <button
                 className="block w-full px-4 py-2 text-left hover:bg-gray-600 transition-colors border-b border-gray-600"
-                onClick={() => controllerConnector.controller.openProfile()}
+                onClick={() => controllerConnector.controller.open({ target: "profile" })}
               >
                 Profile
               </button>
               <button
                 className="block w-full px-4 py-2 text-left hover:bg-gray-600 transition-colors border-b border-gray-600"
-                onClick={() => controllerConnector.controller.openSettings()}
+                onClick={() => controllerConnector.controller.open({ target: "settings" })}
               >
                 Settings
               </button>
diff --git a/examples/next/src/components/Profile.tsx b/examples/next/src/components/Profile.tsx
index a288f64444..3b16e2d009 100644
--- a/examples/next/src/components/Profile.tsx
+++ b/examples/next/src/components/Profile.tsx
@@ -74,7 +74,11 @@ export function Profile() {
       <h2>Open Starterpack</h2>
       <div className="flex flex-col gap-1">
         <div className="flex flex-wrap gap-1">
-          <Button onClick={() => ctrlConnector.controller.openStarterPack(0)}>
+          <Button
+            onClick={() =>
+              ctrlConnector.controller.open({ target: "starterpack", id: 0 })
+            }
+          >
             Nums
           </Button>
         </div>
@@ -91,37 +95,69 @@ export function Profile() {
       <div className="flex flex-col gap-1">
         <div className="flex flex-wrap gap-1">
           <Button
-            onClick={() => ctrlConnector.controller.openProfile("inventory")}
+            onClick={() =>
+              ctrlConnector.controller.open({
+                target: "profile",
+                tab: "inventory",
+              })
+            }
           >
             Inventory
           </Button>
           <Button
-            onClick={() => ctrlConnector.controller.openProfile("achievements")}
+            onClick={() =>
+              ctrlConnector.controller.open({
+                target: "profile",
+                tab: "achievements",
+              })
+            }
           >
             Achievements
           </Button>
           <Button
-            onClick={() => ctrlConnector.controller.openProfile("leaderboard")}
+            onClick={() =>
+              ctrlConnector.controller.open({
+                target: "profile",
+                tab: "leaderboard",
+              })
+            }
           >
             Leaderboard
           </Button>
           <Button
-            onClick={() => ctrlConnector.controller.openProfile("activity")}
+            onClick={() =>
+              ctrlConnector.controller.open({
+                target: "profile",
+                tab: "activity",
+              })
+            }
           >
             Activity
           </Button>
           <Button
-            onClick={() => ctrlConnector.controller.openProfileTo("followers")}
+            onClick={() =>
+              ctrlConnector.controller.open({
+                target: "profile",
+                to: "followers",
+              })
+            }
           >
             Followers
           </Button>
           <Button
-            onClick={() => ctrlConnector.controller.openProfileTo("following")}
+            onClick={() =>
+              ctrlConnector.controller.open({
+                target: "profile",
+                to: "following",
+              })
+            }
           >
             Following
           </Button>
           <Button
-            onClick={() => ctrlConnector.controller.openProfileAt("/funding")}
+            onClick={() =>
+              ctrlConnector.controller.open({ target: "profile", at: "/funding" })
+            }
           >
             Funding
           </Button>
@@ -129,27 +165,30 @@ export function Profile() {
         <div className="flex flex-wrap gap-1">
           <Button
             onClick={() =>
-              ctrlConnector.controller.openProfileTo(
-                `inventory/token/${STRK_CONTRACT_ADDRESS}?preset=cartridge`,
-              )
+              ctrlConnector.controller.open({
+                target: "profile",
+                to: `inventory/token/${STRK_CONTRACT_ADDRESS}?preset=cartridge`,
+              })
             }
           >
             Open to Token STRK
           </Button>
           <Button
             onClick={() =>
-              ctrlConnector.controller.openProfileTo(
-                `inventory/token/${ETH_CONTRACT_ADDRESS}?preset=cartridge`,
-              )
+              ctrlConnector.controller.open({
+                target: "profile",
+                to: `inventory/token/${ETH_CONTRACT_ADDRESS}?preset=cartridge`,
+              })
             }
           >
             Open to Token ETH
           </Button>
           <Button
             onClick={() =>
-              ctrlConnector.controller.openProfileTo(
-                `inventory/token/${STRK_CONTRACT_ADDRESS}/send?preset=cartridge`,
-              )
+              ctrlConnector.controller.open({
+                target: "profile",
+                to: `inventory/token/${STRK_CONTRACT_ADDRESS}/send?preset=cartridge`,
+              })
             }
           >
             Open to Token STRK Send
@@ -158,9 +197,10 @@ export function Profile() {
         <div className="flex flex-wrap gap-1">
           <Button
             onClick={() =>
-              ctrlConnector.controller.openProfileAt(
-                "account/bal7hazar/inventory/collection/0x046dA8955829ADF2bDa310099A0063451923f02E648cF25A1203aac6335CF0e4/token/0x000000000000000000000000000000000000000000000000000000000000c527?ps=arcade-main&preset=arcade&address=0x027917d3084dC0dcd3C4ED5189733d14b0c4C13E762829BD3D1D761aa36201AB&purchaseView=true&tokenIds=0x000000000000000000000000000000000000000000000000000000000000c527",
-              )
+              ctrlConnector.controller.open({
+                target: "profile",
+                at: "account/bal7hazar/inventory/collection/0x046dA8955829ADF2bDa310099A0063451923f02E648cF25A1203aac6335CF0e4/token/0x000000000000000000000000000000000000000000000000000000000000c527?ps=arcade-main&preset=arcade&address=0x027917d3084dC0dcd3C4ED5189733d14b0c4C13E762829BD3D1D761aa36201AB&purchaseView=true&tokenIds=0x000000000000000000000000000000000000000000000000000000000000c527",
+              })
             }
           >
             Open at Purchase
diff --git a/examples/next/src/components/Settings.tsx b/examples/next/src/components/Settings.tsx
index d8a90ea2fa..28ca2c6ab7 100644
--- a/examples/next/src/components/Settings.tsx
+++ b/examples/next/src/components/Settings.tsx
@@ -9,8 +9,7 @@ export function Settings() {
   const cartridgeConnector = connector as unknown as ControllerConnector;
 
   const onOpenSettings = async () => {
-    if (!account) return;
-    cartridgeConnector.controller.openSettings();
+    cartridgeConnector.controller.open({ target: "settings" });
   };
 
   if (!account) {
diff --git a/examples/next/src/components/Starterpack.tsx b/examples/next/src/components/Starterpack.tsx
index d1693e3da9..224d464241 100644
--- a/examples/next/src/components/Starterpack.tsx
+++ b/examples/next/src/components/Starterpack.tsx
@@ -82,9 +82,10 @@ export const Starterpack = () => {
             />
             <Button
               onClick={() => {
-                controllerConnector.controller.openStarterPack(
-                  purchaseOnchainSpId,
-                );
+                controllerConnector.controller.open({
+                  target: "starterpack",
+                  id: purchaseOnchainSpId,
+                });
               }}
             >
               Purchase
@@ -106,12 +107,13 @@ export const Starterpack = () => {
               <Button
                 onClick={() => {
                   if (claimSpId.trim()) {
-                    controllerConnector.controller.openStarterPack(
-                      claimSpId.trim(),
-                      {
+                    controllerConnector.controller.open({
+                      target: "starterpack",
+                      id: claimSpId.trim(),
+                      options: {
                         preimage: claimPreimage.trim(),
                       },
-                    );
+                    });
                   }
                 }}
               >
diff --git a/packages/controller/src/controller.ts b/packages/controller/src/controller.ts
index 030a3761f0..6cfb09fe75 100644
--- a/packages/controller/src/controller.ts
+++ b/packages/controller/src/controller.ts
@@ -490,14 +490,19 @@ export default class ControllerProvider extends BaseProvider {
         this.iframes.keychain.open();
         return;
       case "profile":
-        const username = await this.keychain.username();
-        const profileOptions = [];
-        if (this.options.slot) {
-          profileOptions.push(`ps=${this.options.slot}`);
+        if (args.at) {
+          await this.keychain.navigate(args.at);
+        } else {
+          const username = await this.keychain.username();
+          const profileOptions = [];
+          if (this.options.slot) {
+            profileOptions.push(`ps=${this.options.slot}`);
+          }
+          const path = args.to ? args.to : args.tab ?? "inventory";
+          await this.keychain.navigate(
+            `/account/${username}/${path}?${profileOptions.join("&")}`,
+          );
         }
-        await this.keychain.navigate(
-          `/account/${username}/${args.tab ?? "inventory"}?${profileOptions.join("&")}`,
-        );
         this.iframes.keychain.open();
         return;
       case "purchase-credits":
diff --git a/packages/controller/src/types.ts b/packages/controller/src/types.ts
index 06b7a7fac6..022c3f4ed6 100644
--- a/packages/controller/src/types.ts
+++ b/packages/controller/src/types.ts
@@ -273,7 +273,12 @@ export type OpenOptions = {
 export type OpenPageTarget =
   | { target: "starterpack"; id: string | number; options?: StarterpackOptions }
   | { target: "settings" }
-  | { target: "profile"; tab?: ProfileContextTypeVariant }
+  | {
+      target: "profile";
+      tab?: ProfileContextTypeVariant;
+      to?: string;
+      at?: string;
+    }
   | { target: "purchase-credits" }
   | { target: "execute"; calls: Call[]; chainId?: string }
   | { target: "standalone"; options?: OpenOptions };

From a23e46f86a7e5112454897d623dfcaa051f69b39 Mon Sep 17 00:00:00 2001
From: broody <broody@gmail.com>
Date: Wed, 4 Feb 2026 15:44:59 -1000
Subject: [PATCH 4/4] refactor: unify open entrypoint and update examples

---
 examples/next/src/components/Header.tsx  | 8 ++++++--
 examples/next/src/components/Profile.tsx | 5 ++++-
 packages/connector/src/controller.ts     | 1 -
 packages/controller/src/controller.ts    | 2 +-
 4 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/examples/next/src/components/Header.tsx b/examples/next/src/components/Header.tsx
index 481965d87c..6914bc54b0 100644
--- a/examples/next/src/components/Header.tsx
+++ b/examples/next/src/components/Header.tsx
@@ -157,13 +157,17 @@ const Header = () => {
             <div className="absolute right-0 top-full mt-1 bg-background shadow-lg rounded-md min-w-[160px] py-1 z-10 border border-gray-600">
               <button
                 className="block w-full px-4 py-2 text-left hover:bg-gray-600 transition-colors border-b border-gray-600"
-                onClick={() => controllerConnector.controller.open({ target: "profile" })}
+                onClick={() =>
+                  controllerConnector.controller.open({ target: "profile" })
+                }
               >
                 Profile
               </button>
               <button
                 className="block w-full px-4 py-2 text-left hover:bg-gray-600 transition-colors border-b border-gray-600"
-                onClick={() => controllerConnector.controller.open({ target: "settings" })}
+                onClick={() =>
+                  controllerConnector.controller.open({ target: "settings" })
+                }
               >
                 Settings
               </button>
diff --git a/examples/next/src/components/Profile.tsx b/examples/next/src/components/Profile.tsx
index 3b16e2d009..ad71eb4fff 100644
--- a/examples/next/src/components/Profile.tsx
+++ b/examples/next/src/components/Profile.tsx
@@ -156,7 +156,10 @@ export function Profile() {
           </Button>
           <Button
             onClick={() =>
-              ctrlConnector.controller.open({ target: "profile", at: "/funding" })
+              ctrlConnector.controller.open({
+                target: "profile",
+                at: "/funding",
+              })
             }
           >
             Funding
diff --git a/packages/connector/src/controller.ts b/packages/connector/src/controller.ts
index d63f3be46d..d279da9bac 100644
--- a/packages/connector/src/controller.ts
+++ b/packages/connector/src/controller.ts
@@ -1,7 +1,6 @@
 import ControllerProvider, {
   AuthOptions,
   ControllerOptions,
-  OpenOptions,
   OpenPageTarget,
 } from "@cartridge/controller";
 import { Connector, InjectedConnector } from "@starknet-react/core";
diff --git a/packages/controller/src/controller.ts b/packages/controller/src/controller.ts
index 6cfb09fe75..cdeee30c1c 100644
--- a/packages/controller/src/controller.ts
+++ b/packages/controller/src/controller.ts
@@ -498,7 +498,7 @@ export default class ControllerProvider extends BaseProvider {
           if (this.options.slot) {
             profileOptions.push(`ps=${this.options.slot}`);
           }
-          const path = args.to ? args.to : args.tab ?? "inventory";
+          const path = args.to ? args.to : (args.tab ?? "inventory");
           await this.keychain.navigate(
             `/account/${username}/${path}?${profileOptions.join("&")}`,
           );