@tanstack/create 0.65.0 → 0.67.0

package/dist/frameworks/react/examples/shopify-storefront/assets/src/routes/index.tsx

@@ -0,0 +1,65 @@
+import { Link, createFileRoute } from '@tanstack/react-router'
+
+import '#/components/shop/shop.css'
+import { ProductGrid } from '#/components/shop/product-grid'
+import { FeaturedCollections } from '#/components/FeaturedCollections'
+import { ShopHero } from '#/components/ShopHero'
+import {
+  getCollections,
+  getProducts,
+  getShop,
+} from '#/server/shopify/catalog.functions'
+
+export const Route = createFileRoute('/')({
+  loader: async () => {
+    const [shop, collections, products] = await Promise.all([
+      getShop(),
+      getCollections(),
+      getProducts({ data: { first: 8, sortKey: 'BEST_SELLING' } }),
+    ])
+    return { shop, collections, featured: products.nodes }
+  },
+  head: ({ loaderData }) => ({
+    meta: loaderData
+      ? [
+          { title: loaderData.shop.name },
+          { name: 'description', content: loaderData.shop.description ?? '' },
+        ]
+      : [],
+  }),
+  component: HomePage,
+})
+
+function HomePage() {
+  const { shop, collections, featured } = Route.useLoaderData()
+
+  return (
+    <div className="shop-root min-h-screen">
+      <ShopHero
+        title={shop.name}
+        tagline={shop.description ?? 'A TanStack Start + Shopify storefront.'}
+      />
+
+      {collections.length > 0 && (
+        <section className="mx-auto max-w-7xl px-4 pb-20 sm:px-6 lg:px-8">
+          <FeaturedCollections collections={collections.slice(0, 3)} />
+        </section>
+      )}
+
+      <section className="mx-auto max-w-7xl px-4 pb-24 sm:px-6 lg:px-8">
+        <div className="mb-8 flex items-baseline justify-between">
+          <h2 className="text-2xl font-medium tracking-tight sm:text-3xl">
+            Best sellers
+          </h2>
+          <Link
+            to="/shop"
+            className="text-sm underline underline-offset-4 hover:opacity-80"
+          >
+            Shop all →
+          </Link>
+        </div>
+        <ProductGrid products={featured} />
+      </section>
+    </div>
+  )
+}

package/dist/frameworks/react/examples/shopify-storefront/info.json

@@ -0,0 +1,18 @@
+{
+  "name": "Shopify Storefront",
+  "description": "A polished Shopify storefront starter — TanStack Start + Shopify Storefront API + optional customer accounts. Hosted checkout, deploy anywhere.",
+  "phase": "example",
+  "modes": ["file-router"],
+  "type": "example",
+  "category": "other",
+  "color": "#5A31F4",
+  "priority": 5,
+  "link": "https://shopify.dev/docs/storefronts/headless",
+  "dependsOn": ["shopify"],
+  "default": true,
+  "routes": [
+    { "url": "/", "path": "src/routes/index.tsx", "jsName": "ShopHome" }
+  ],
+  "integrations": [],
+  "variables": []
+}

package/dist/frameworks/react/examples/shopify-storefront/package.json

@@ -0,0 +1,3 @@
+{
+  "dependencies": {}
+}

package/dist/frameworks/react/project/base/src/components/Header.tsx.ejs

@@ -32,7 +32,40 @@ export default function Header() {
           </Link>
         </h2>
 
-        <div className="ml-auto flex items-center gap-1.5 sm:ml-0 sm:gap-2">
+        <div className="order-3 flex w-full flex-wrap items-center gap-x-4 gap-y-1 pb-1 text-sm font-semibold sm:order-none sm:w-auto sm:flex-nowrap sm:pb-0">
+          <Link to="/" className="nav-link" activeProps={{ className: 'nav-link is-active' }}>
+            Home
+          </Link>
+          <Link
+            to="/about"
+            className="nav-link"
+            activeProps={{ className: 'nav-link is-active' }}
+          >
+            About
+          </Link>
+          <a
+            href="https://tanstack.com/start/latest/docs/framework/react/overview"
+            className="nav-link"
+            target="_blank"
+            rel="noreferrer"
+          >
+            Docs
+          </a>
+          <% if (demoRoutes.length > 0) { %><details className="relative w-full sm:w-auto">
+            <summary className="nav-link list-none cursor-pointer">Demos</summary>
+            <div className="mt-2 min-w-56 rounded-xl border border-[var(--line)] bg-[var(--header-bg)] p-2 shadow-lg sm:absolute sm:right-0">
+              <% for (const route of demoRoutes) { %><a
+                href="<%= route.url %>"
+                className="block rounded-lg px-3 py-2 text-sm text-[var(--sea-ink-soft)] no-underline transition hover:bg-[var(--link-bg-hover)] hover:text-[var(--sea-ink)]"
+              >
+                <%= route.name %>
+              </a>
+              <% } %>
+            </div>
+          </details><% } %>
+        </div>
+
+        <div className="ml-auto flex items-center gap-1.5 sm:gap-2">
           <a
             href="https://x.com/tan_stack"
             target="_blank"
@@ -65,39 +98,6 @@ export default function Header() {
           <% } %>
           <ThemeToggle />
         </div>
-
-        <div className="order-3 flex w-full flex-wrap items-center gap-x-4 gap-y-1 pb-1 text-sm font-semibold sm:order-2 sm:w-auto sm:flex-nowrap sm:pb-0">
-          <Link to="/" className="nav-link" activeProps={{ className: 'nav-link is-active' }}>
-            Home
-          </Link>
-          <Link
-            to="/about"
-            className="nav-link"
-            activeProps={{ className: 'nav-link is-active' }}
-          >
-            About
-          </Link>
-          <a
-            href="https://tanstack.com/start/latest/docs/framework/react/overview"
-            className="nav-link"
-            target="_blank"
-            rel="noreferrer"
-          >
-            Docs
-          </a>
-          <% if (demoRoutes.length > 0) { %><details className="relative w-full sm:w-auto">
-            <summary className="nav-link list-none cursor-pointer">Demos</summary>
-            <div className="mt-2 min-w-56 rounded-xl border border-[var(--line)] bg-[var(--header-bg)] p-2 shadow-lg sm:absolute sm:right-0">
-              <% for (const route of demoRoutes) { %><a
-                href="<%= route.url %>"
-                className="block rounded-lg px-3 py-2 text-sm text-[var(--sea-ink-soft)] no-underline transition hover:bg-[var(--link-bg-hover)] hover:text-[var(--sea-ink)]"
-              >
-                <%= route.name %>
-              </a>
-              <% } %>
-            </div>
-          </details><% } %>
-        </div>
       </nav>
     </header>
   )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/create",
-  "version": "0.65.0",
+  "version": "0.67.0",
   "description": "TanStack Application Builder Engine",
   "type": "module",
   "main": "./dist/index.js",

package/src/frameworks/react/add-ons/powersync/README.md.ejs

@@ -0,0 +1,26 @@
+# PowerSync
+
+This project includes the PowerSync Web SDK and React hooks.
+
+## Environment
+
+Set these variables in `.env.local`:
+
+- `VITE_POWERSYNC_URL`
+- `VITE_POWERSYNC_TOKEN` for local development only
+
+## What The Add-on Includes
+
+- `src/lib/powersync/AppSchema.ts`
+- `src/lib/powersync/BackendConnector.ts`
+- `src/integrations/powersync/provider.tsx`
+- `src/routes/demo/powersync.tsx`
+
+## Next Steps
+
+1. Replace the development token flow in `src/lib/powersync/BackendConnector.ts` with your real auth flow.
+2. Update the sample schema in `src/lib/powersync/AppSchema.ts` to match your synced tables.
+3. Implement the upload logic in `uploadData()` so local mutations are written back to your backend.
+
+PowerSync setup guidance:
+https://docs.powersync.com/client-sdk-references/js-web

package/src/frameworks/react/add-ons/powersync/assets/_dot_env.local.append

@@ -0,0 +1,3 @@
+
+VITE_POWERSYNC_URL=
+VITE_POWERSYNC_TOKEN=

package/src/frameworks/react/add-ons/powersync/assets/powersync-vite-plugin.ts

@@ -0,0 +1,17 @@
+import type { Plugin } from 'vite'
+
+export default function powersyncVite(): Plugin {
+  return {
+    name: 'powersync-vite',
+    config() {
+      return {
+        optimizeDeps: {
+          exclude: ['@powersync/web'],
+        },
+        worker: {
+          format: 'es',
+        },
+      }
+    },
+  }
+}

package/src/frameworks/react/add-ons/powersync/assets/src/integrations/powersync/provider.tsx

@@ -0,0 +1,26 @@
+import type { ReactNode } from 'react'
+import { PowerSyncContext } from '@powersync/react'
+import { PowerSyncDatabase, WASQLiteOpenFactory } from '@powersync/web'
+
+import { AppSchema } from '#/lib/powersync/AppSchema'
+import { BackendConnector } from '#/lib/powersync/BackendConnector'
+
+const db = new PowerSyncDatabase({
+  database: new WASQLiteOpenFactory({
+    dbFilename: 'powersync.db',
+  }),
+  schema: AppSchema,
+  flags: {
+    disableSSRWarning: true,
+  },
+})
+
+void db.connect(new BackendConnector())
+
+export default function PowerSyncProvider({
+  children,
+}: {
+  children: ReactNode
+}) {
+  return <PowerSyncContext.Provider value={db}>{children}</PowerSyncContext.Provider>
+}

package/src/frameworks/react/add-ons/powersync/assets/src/lib/powersync/AppSchema.ts

@@ -0,0 +1,17 @@
+import { Schema, Table, column } from '@powersync/web'
+
+const todos = new Table(
+  {
+    created_at: column.text,
+    description: column.text,
+    completed: column.integer,
+  },
+  { indexes: { created_at: ['created_at'] } },
+)
+
+export const AppSchema = new Schema({
+  todos,
+})
+
+export type Database = (typeof AppSchema)['types']
+export type TodoRecord = Database['todos']

package/src/frameworks/react/add-ons/powersync/assets/src/lib/powersync/BackendConnector.ts

@@ -0,0 +1,52 @@
+import {
+  type AbstractPowerSyncDatabase,
+  type PowerSyncBackendConnector,
+  UpdateType,
+} from '@powersync/web'
+
+export class BackendConnector implements PowerSyncBackendConnector {
+  private readonly powersyncUrl = import.meta.env.VITE_POWERSYNC_URL
+  private readonly powersyncToken = import.meta.env.VITE_POWERSYNC_TOKEN
+
+  async fetchCredentials() {
+    if (!this.powersyncUrl || !this.powersyncToken) {
+      return null
+    }
+
+    return {
+      endpoint: this.powersyncUrl,
+      token: this.powersyncToken,
+    }
+  }
+
+  async uploadData(database: AbstractPowerSyncDatabase): Promise<void> {
+    const transaction = await database.getNextCrudTransaction()
+
+    if (!transaction) {
+      return
+    }
+
+    try {
+      for (const op of transaction.crud) {
+        const record = { ...op.opData, id: op.id }
+
+        switch (op.op) {
+          case UpdateType.PUT:
+            console.info('TODO: create record remotely', record)
+            break
+          case UpdateType.PATCH:
+            console.info('TODO: patch record remotely', record)
+            break
+          case UpdateType.DELETE:
+            console.info('TODO: delete record remotely', record)
+            break
+        }
+      }
+
+      await transaction.complete()
+    } catch (error) {
+      console.error('PowerSync uploadData failed', error)
+      throw error
+    }
+  }
+}

package/src/frameworks/react/add-ons/powersync/assets/src/routes/demo/powersync.tsx

@@ -0,0 +1,129 @@
+import { useState } from 'react'
+import { createFileRoute } from '@tanstack/react-router'
+import { usePowerSync, useQuery, useStatus } from '@powersync/react'
+
+export const Route = createFileRoute('/demo/powersync')({
+  component: PowerSyncDemo,
+})
+
+type TodoRow = {
+  id: string
+  created_at: string
+  description: string
+  completed: number
+}
+
+function PowerSyncDemo() {
+  const powerSync = usePowerSync()
+  const status = useStatus()
+  const { data } = useQuery(
+    'SELECT id, created_at, description, completed FROM todos ORDER BY created_at DESC',
+  )
+  const todos = (data ?? []) as Array<TodoRow>
+  const [description, setDescription] = useState('')
+  const [error, setError] = useState<string | null>(null)
+
+  async function addTodo(event: React.FormEvent<HTMLFormElement>) {
+    event.preventDefault()
+
+    const nextDescription = description.trim()
+    if (!nextDescription) {
+      return
+    }
+
+    try {
+      setError(null)
+      await powerSync.execute(
+        'INSERT INTO todos (id, created_at, description, completed) VALUES (?, ?, ?, ?)',
+        [crypto.randomUUID(), new Date().toISOString(), nextDescription, 0],
+      )
+
+      setDescription('')
+    } catch (error) {
+      console.error('Failed to insert PowerSync todo', error)
+      setError('Failed to insert row. Please try again.')
+    }
+  }
+
+  return (
+    <main className="page-wrap py-10">
+      <div className="max-w-3xl space-y-6">
+        <header className="space-y-2">
+          <p className="text-sm font-semibold uppercase tracking-[0.2em] text-[var(--sea-ink-soft)]">
+            Offline Sync
+          </p>
+          <h1 className="text-3xl font-semibold tracking-tight">PowerSync</h1>
+          <p className="text-sm text-[var(--sea-ink-soft)]">
+            This demo writes to the local SQLite database immediately. Replace the sample
+            schema and backend connector with your real PowerSync configuration.
+          </p>
+        </header>
+
+        <section className="rounded-3xl border border-[var(--line)] bg-white/70 p-5 shadow-sm">
+          <h2 className="text-sm font-semibold uppercase tracking-[0.16em] text-[var(--sea-ink-soft)]">
+            Connection State
+          </h2>
+          <pre className="mt-3 overflow-auto rounded-2xl bg-[var(--chip-bg)] p-4 text-xs leading-6 text-[var(--sea-ink)]">
+            {JSON.stringify(status, null, 2)}
+          </pre>
+        </section>
+
+        <section className="rounded-3xl border border-[var(--line)] bg-white/70 p-5 shadow-sm">
+          <h2 className="text-sm font-semibold uppercase tracking-[0.16em] text-[var(--sea-ink-soft)]">
+            Local Todos
+          </h2>
+          {error ? (
+            <p className="mt-3 rounded-2xl border border-red-200 bg-red-50 px-4 py-3 text-sm text-red-700">
+              {error}
+            </p>
+          ) : null}
+          <form className="mt-4 flex flex-col gap-3 sm:flex-row" onSubmit={addTodo}>
+            <label className="sr-only" htmlFor="powersync-todo-description">
+              Todo description
+            </label>
+            <input
+              id="powersync-todo-description"
+              className="min-w-0 flex-1 rounded-2xl border border-[var(--line)] bg-white px-4 py-3 text-sm text-[var(--sea-ink)] outline-none"
+              onChange={(event) => setDescription(event.target.value)}
+              placeholder="Write to the local PowerSync database"
+              value={description}
+            />
+            <button
+              className="rounded-2xl bg-[var(--sea-ink)] px-4 py-3 text-sm font-semibold text-white"
+              type="submit"
+            >
+              Insert Local Row
+            </button>
+          </form>
+
+          <ul className="mt-5 space-y-3">
+            {todos.length === 0 ? (
+              <li className="rounded-2xl border border-dashed border-[var(--line)] px-4 py-5 text-sm text-[var(--sea-ink-soft)]">
+                No rows yet. Insert one locally, then wire `uploadData()` to send it upstream.
+              </li>
+            ) : (
+              todos.map((todo) => (
+                <li
+                  className="rounded-2xl border border-[var(--line)] bg-[var(--chip-bg)] px-4 py-4"
+                  key={todo.id}
+                >
+                  <div className="flex items-start justify-between gap-4">
+                    <div>
+                      <p className="font-medium text-[var(--sea-ink)]">{todo.description}</p>
+                      <p className="mt-1 text-xs text-[var(--sea-ink-soft)]">
+                        {todo.created_at}
+                      </p>
+                    </div>
+                    <span className="rounded-full border border-[var(--line)] px-2 py-1 text-xs font-semibold text-[var(--sea-ink-soft)]">
+                      {todo.completed ? 'done' : 'pending'}
+                    </span>
+                  </div>
+                </li>
+              ))
+            )}
+          </ul>
+        </section>
+      </div>
+    </main>
+  )
+}

package/src/frameworks/react/add-ons/powersync/info.json

@@ -0,0 +1,46 @@
+{
+  "name": "PowerSync",
+  "description": "Add PowerSync offline sync to your application.",
+  "phase": "add-on",
+  "type": "add-on",
+  "category": "database",
+  "color": "#2563EB",
+  "priority": 55,
+  "link": "https://docs.powersync.com/client-sdk-references/js-web",
+  "modes": ["file-router"],
+  "envVars": [
+    {
+      "name": "VITE_POWERSYNC_URL",
+      "description": "PowerSync instance URL",
+      "required": true,
+      "file": ".env.local"
+    },
+    {
+      "name": "VITE_POWERSYNC_TOKEN",
+      "description": "Client-visible development token for local testing; VITE_* env vars are exposed to the browser",
+      "required": false,
+      "file": ".env.local"
+    }
+  ],
+  "integrations": [
+    {
+      "type": "vite-plugin",
+      "path": "powersync-vite-plugin.ts",
+      "jsName": "powersyncVite",
+      "code": "powersyncVite()"
+    },
+    {
+      "type": "provider",
+      "path": "src/integrations/powersync/provider.tsx",
+      "jsName": "PowerSyncProvider"
+    }
+  ],
+  "routes": [
+    {
+      "url": "/demo/powersync",
+      "name": "PowerSync",
+      "path": "src/routes/demo/powersync.tsx",
+      "jsName": "PowerSyncDemo"
+    }
+  ]
+}

package/src/frameworks/react/add-ons/powersync/package.json.ejs

@@ -0,0 +1,7 @@
+{
+  "dependencies": {
+    "@journeyapps/wa-sqlite": "^1.2.6",
+    "@powersync/react": "^1.7.4",
+    "@powersync/web": "^1.26.1"
+  }
+}

package/src/frameworks/react/add-ons/powersync/small-logo.svg

@@ -0,0 +1,6 @@
+<svg width="64" height="64" viewBox="0 0 64 64" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <rect width="64" height="64" rx="16" fill="#2563EB"/>
+  <path d="M20 21C20 18.7909 21.7909 17 24 17H39.5C45.299 17 50 21.701 50 27.5C50 33.299 45.299 38 39.5 38H29V47H20V21Z" fill="white"/>
+  <path d="M29 29H38.5C40.9853 29 43 26.9853 43 24.5C43 22.0147 40.9853 20 38.5 20H29V29Z" fill="#2563EB"/>
+  <circle cx="43" cy="44" r="7" fill="#93C5FD"/>
+</svg>

package/src/frameworks/react/add-ons/shopify/README.md

@@ -0,0 +1,86 @@
+# Shopify
+
+Headless Shopify storefront for TanStack Start. Mounts `/shop/*` routes
+alongside your existing app — your home page stays untouched.
+
+The default `.env.local` points at Shopify's public Hydrogen demo store, so the
+storefront renders real products on first run with zero setup.
+
+## Routes
+
+| Route                          | What it does                                |
+|--------------------------------|---------------------------------------------|
+| `/shop`                        | Shop landing — featured products + collections |
+| `/shop/products/$handle`       | Product detail (variants, images, options)  |
+| `/shop/collections/$handle`    | Collection grid with sort + pagination      |
+| `/shop/cart`                   | Cart line items, discount codes, checkout   |
+| `/shop/search`                 | Product search                              |
+| `/shop/pages/$handle`          | Shopify CMS pages (about, etc.)             |
+| `/shop/policies/$handle`       | Privacy, refund, terms, shipping            |
+
+If you opted into customer accounts during scaffold:
+
+| Route                                | What it does                       |
+|--------------------------------------|------------------------------------|
+| `/shop/account/login`                | Kick off Shopify OAuth             |
+| `/shop/account/callback`             | OAuth callback handler             |
+| `/shop/account/logout`               | End the customer session           |
+| `/shop/account`                      | Dashboard                          |
+| `/shop/account/orders`               | Order history                      |
+| `/shop/account/orders/$id`           | Order detail                       |
+| `/shop/account/addresses`            | Manage saved addresses             |
+
+## Connect your store
+
+1. In Shopify admin, go to **Settings > Apps and sales channels > Develop apps**.
+2. Create a new app, enable the **Storefront API**, and copy the public access token.
+3. Set in `.env.local`:
+   ```
+   SHOPIFY_STORE_DOMAIN=your-store.myshopify.com
+   SHOPIFY_PUBLIC_STOREFRONT_TOKEN=...
+   ```
+4. (Optional) For higher rate limits + buyer-IP forwarding, also create a private
+   token and set `SHOPIFY_PRIVATE_STOREFRONT_TOKEN`.
+
+## Enable customer accounts
+
+If `customerAccount=enabled` was selected during scaffold:
+
+1. In Shopify admin, go to **Settings > Customer accounts > Headless**.
+2. Register a public client. Add `http://localhost:3000/shop/account/callback`
+   *and* your production callback URL to the redirect URIs.
+3. Copy the Client ID and Shop ID into `.env.local`:
+   ```
+   SHOPIFY_CUSTOMER_ACCOUNT_CLIENT_ID=...
+   SHOPIFY_CUSTOMER_ACCOUNT_SHOP_ID=...
+   SHOPIFY_SESSION_SECRET=$(openssl rand -hex 32)
+   ```
+
+The Hydrogen demo store doesn't have customer accounts configured, so the
+default demo creds won't work for `/shop/account/*` — you'll need a real store.
+
+## Architecture
+
+- **Storefront API client** — server-only fetch in `src/server/shopify/storefront-client.ts`.
+  All product/cart reads go through the server (private token never reaches the browser).
+- **Cart state** — Cart ID stored in an httpOnly cookie (`tanstack_cart_id`). React
+  Query owns the cache (single key `['shopify', 'cart']`); optimistic updates with
+  a module-level mutation counter to batch invalidations.
+- **GraphQL queries** — hand-written strings in `src/lib/shopify/queries.ts`, types
+  sliced from `@shopify/hydrogen-react/storefront-api-types` (type-only import; zero runtime).
+- **Customer accounts** — hand-rolled OAuth 2.1 PKCE with `.well-known` discovery
+  (no usable npm client exists yet). Tokens in a signed httpOnly cookie.
+- **Checkout** — redirects to `cart.checkoutUrl` (Shopify-hosted).
+
+## Deployment
+
+Works anywhere TanStack Start runs:
+
+- **Node** — `npm run build && npm start`
+- **Cloudflare Workers / Shopify Oxygen** — Oxygen is just Workers under the hood;
+  build with the Workers preset and deploy to either platform.
+- **Vercel / Netlify** — set the env vars in the dashboard.
+- **Bun, Deno** — supported via Start's adapters.
+
+For the customer-account flow, register both your local *and* production
+callback URLs in the Shopify admin's headless app config.

package/src/frameworks/react/add-ons/shopify/assets/_dot_env.local.append

@@ -0,0 +1,19 @@
+# ─── Shopify ─────────────────────────────────────────────────────────────────
+# These defaults point to Shopify's public Hydrogen demo store so the storefront
+# works on first run with zero config. Replace with your store's values to go live.
+# Get tokens at: Shopify admin > Settings > Apps and sales channels > Develop apps.
+SHOPIFY_STORE_DOMAIN=hydrogen-preview.myshopify.com
+SHOPIFY_STOREFRONT_API_VERSION=2026-01
+SHOPIFY_PUBLIC_STOREFRONT_TOKEN=3b580e70970c4528da70c98e097c2fa0
+# Optional — set to a private storefront token for higher rate limits + buyer-IP forwarding.
+SHOPIFY_PRIVATE_STOREFRONT_TOKEN=
+
+# ─── Shopify Customer Account API ────────────────────────────────────────────
+# Required only if you opted into customer accounts during scaffold.
+# Register a public client in Shopify admin > Settings > Customer accounts > Headless,
+# then paste the client ID and your numeric shop ID below.
+SHOPIFY_CUSTOMER_ACCOUNT_CLIENT_ID=
+SHOPIFY_CUSTOMER_ACCOUNT_SHOP_ID=
+SHOPIFY_CUSTOMER_ACCOUNT_REDIRECT_URI=http://localhost:3000/shop/account/callback
+# 32+ random chars, e.g. `openssl rand -hex 32`. Used to sign customer session cookies.
+SHOPIFY_SESSION_SECRET=

package/src/frameworks/react/add-ons/shopify/assets/src/components/shop/account-nav.tsx.ejs

@@ -0,0 +1,41 @@
+<% if (addOnOption.shopify.customerAccount !== 'enabled') { ignoreFile(); return; } %>
+import { Link } from '@tanstack/react-router'
+
+const ITEMS = [
+  { to: '/shop/account', label: 'Overview', exact: true },
+  { to: '/shop/account/orders', label: 'Orders', exact: false },
+  { to: '/shop/account/addresses', label: 'Addresses', exact: false },
+] as const
+
+export function AccountNav() {
+  return (
+    <nav className="flex flex-col gap-1 text-sm">
+      {ITEMS.map((item) => (
+        <Link
+          key={item.to}
+          to={item.to}
+          activeOptions={{ exact: item.exact }}
+          className="rounded-md px-2 py-1.5 text-[var(--storefront-fg-muted)] hover:bg-[var(--storefront-line)]/40 hover:text-[var(--storefront-fg)]"
+          activeProps={{
+            className:
+              'rounded-md px-2 py-1.5 bg-[var(--storefront-line)]/60 text-[var(--storefront-fg)] font-medium',
+          }}
+        >
+          {item.label}
+        </Link>
+      ))}
+      <form
+        action="/shop/account/logout"
+        method="post"
+        className="mt-4 border-t border-[var(--storefront-line)] pt-4"
+      >
+        <button
+          type="submit"
+          className="rounded-md px-2 py-1.5 text-left text-sm text-[var(--storefront-fg-muted)] hover:text-[var(--storefront-fg)]"
+        >
+          Sign out
+        </button>
+      </form>
+    </nav>
+  )
+}