staging <- dev

.github/workflows/deploy-app-walrus.yml

@@ -68,6 +68,12 @@ jobs:
           VITE_DOCS_URL: ${{ vars.VITE_DOCS_URL }}
           VITE_DEMO_URLS: ${{ vars.VITE_DEMO_URLS }}
           VITE_GA_MEASUREMENT_ID: ${{ vars.VITE_GA_MEASUREMENT_ID }}
+          VITE_GTM_CONTAINER_ID: ${{ vars.VITE_GTM_CONTAINER_ID }}
+          VITE_ANALYTICS_ALLOWED_HOSTS: ${{ vars.VITE_ANALYTICS_ALLOWED_HOSTS }}
+          VITE_POSTHOG_PROJECT_API_KEY: ${{ vars.VITE_POSTHOG_PROJECT_API_KEY }}
+          VITE_POSTHOG_KEY: ${{ vars.VITE_POSTHOG_KEY }}
+          VITE_POSTHOG_HOST: ${{ vars.VITE_POSTHOG_HOST }}
+          VITE_POSTHOG_UI_HOST: ${{ vars.VITE_POSTHOG_UI_HOST }}
 
       - name: Deploy to Walrus Site (Mainnet)
         id: deploy-mainnet

apps/app/.env.example

@@ -24,6 +24,18 @@ VITE_DEMO_URLS=
 # Google Analytics 4 Measurement ID. Leave blank to disable analytics.
 VITE_GA_MEASUREMENT_ID=
 
+# Google Tag Manager Container ID. Set to GTM-KPDDH5DX in production.
+VITE_GTM_CONTAINER_ID=
+
+# Analytics only sends on these production hosts. Applies to GTM, GA4, and PostHog.
+# Use * for local analytics testing.
+VITE_ANALYTICS_ALLOWED_HOSTS=walrus.xyz,www.walrus.xyz
+
+# PostHog Project API key. Leave blank to disable PostHog.
+VITE_POSTHOG_PROJECT_API_KEY=
+VITE_POSTHOG_HOST=https://t.walrus.xyz
+VITE_POSTHOG_UI_HOST=https://us.posthog.com
+
 # ══════════════════════════════════════════════════════════════
 # ▷ INACTIVE: MAINNET  (uncomment below, comment out TESTNET above)
 # ══════════════════════════════════════════════════════════════

apps/app/Dockerfile

@@ -37,6 +37,12 @@ ARG VITE_GOOGLE_CLIENT_ID
 ARG VITE_DOCS_URL
 ARG VITE_DEMO_URLS
 ARG VITE_GA_MEASUREMENT_ID
+ARG VITE_GTM_CONTAINER_ID
+ARG VITE_ANALYTICS_ALLOWED_HOSTS
+ARG VITE_POSTHOG_PROJECT_API_KEY
+ARG VITE_POSTHOG_KEY
+ARG VITE_POSTHOG_HOST
+ARG VITE_POSTHOG_UI_HOST
 
 ENV VITE_MEMWAL_SERVER_URL=$VITE_MEMWAL_SERVER_URL
 ENV VITE_MEMWAL_PACKAGE_ID=$VITE_MEMWAL_PACKAGE_ID
@@ -47,20 +53,25 @@ ENV VITE_GOOGLE_CLIENT_ID=$VITE_GOOGLE_CLIENT_ID
 ENV VITE_DOCS_URL=$VITE_DOCS_URL
 ENV VITE_DEMO_URLS=$VITE_DEMO_URLS
 ENV VITE_GA_MEASUREMENT_ID=$VITE_GA_MEASUREMENT_ID
+ENV VITE_GTM_CONTAINER_ID=$VITE_GTM_CONTAINER_ID
+ENV VITE_ANALYTICS_ALLOWED_HOSTS=$VITE_ANALYTICS_ALLOWED_HOSTS
+ENV VITE_POSTHOG_PROJECT_API_KEY=$VITE_POSTHOG_PROJECT_API_KEY
+ENV VITE_POSTHOG_KEY=$VITE_POSTHOG_KEY
+ENV VITE_POSTHOG_HOST=$VITE_POSTHOG_HOST
+ENV VITE_POSTHOG_UI_HOST=$VITE_POSTHOG_UI_HOST
 
 RUN pnpm --filter @memwal/app build
 
 # ── Stage 2: Serve static files ─────────────────────────────
 FROM node:22-alpine AS runtime
 
-RUN npm install -g serve
-
 WORKDIR /app
 
 COPY --from=builder /app/apps/app/dist ./dist
+COPY --from=builder /app/apps/app/server.mjs ./server.mjs
 
-ENV PORT=${PORT}
-EXPOSE ${PORT}
+ENV PORT=3000
+EXPOSE 3000
 
-# SPA mode — all routes fallback to index.html
-CMD sh -c "serve -s -l ${PORT} dist"
+# SPA mode for app routes only. File-like paths never fall back to index.html.
+CMD ["node", "server.mjs"]

apps/app/index.html

@@ -8,25 +8,37 @@
   <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
   <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
   <link rel="manifest" href="/site.webmanifest">
+  <link rel="image_src" href="https://dev.memwal.ai/walrus-memory-social-preview.jpg">
   <link rel="preload" href="/fonts/Ratch-Variable.ttf" as="font" type="font/ttf" crossorigin>
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
   <meta name="description"
-    content="Walrus Memory — privacy-preserving AI memory. Store your AI conversations encrypted on Walrus, searchable with embeddings. You own your data." />
+    content="Walrus Memory is portable memory for reliable AI agents across apps and sessions." />
   <meta name="theme-color" content="#000000" />
+  <meta itemprop="name" content="Walrus Memory" />
+  <meta itemprop="description" content="Portable memory for reliable AI agents across apps and sessions." />
+  <meta itemprop="image" content="https://dev.memwal.ai/walrus-memory-social-preview.jpg" />
 
   <!-- Open Graph -->
   <meta property="og:type" content="website" />
-  <meta property="og:title" content="Walrus Memory — AI Memory Dashboard" />
-  <meta property="og:description" content="Privacy-preserving AI memory. Store conversations encrypted on Walrus, searchable with embeddings." />
-  <meta property="og:image" content="/og-image.jpg" />
+  <meta property="og:url" content="https://dev.memwal.ai/" />
+  <meta property="og:site_name" content="Walrus Memory" />
+  <meta property="og:title" content="Walrus Memory" />
+  <meta property="og:description" content="Portable memory for reliable AI agents across apps and sessions." />
+  <meta property="og:image" content="https://dev.memwal.ai/walrus-memory-social-preview.jpg" />
+  <meta property="og:image:secure_url" content="https://dev.memwal.ai/walrus-memory-social-preview.jpg" />
+  <meta property="og:image:type" content="image/jpeg" />
+  <meta property="og:image:width" content="1600" />
+  <meta property="og:image:height" content="900" />
+  <meta property="og:image:alt" content="Walrus Memory mascot on an aurora background" />
 
   <!-- Twitter Card -->
   <meta name="twitter:card" content="summary_large_image" />
-  <meta name="twitter:title" content="Walrus Memory — AI Memory Dashboard" />
-  <meta name="twitter:description" content="Privacy-preserving AI memory. Store conversations encrypted on Walrus, searchable with embeddings." />
-  <meta name="twitter:image" content="/og-image.jpg" />
+  <meta name="twitter:title" content="Walrus Memory" />
+  <meta name="twitter:description" content="Portable memory for reliable AI agents across apps and sessions." />
+  <meta name="twitter:image" content="https://dev.memwal.ai/walrus-memory-social-preview.jpg" />
+  <meta name="twitter:image:alt" content="Walrus Memory mascot on an aurora background" />
 
-  <title>Walrus Memory — AI Memory Dashboard</title>
+  <title>Walrus Memory</title>
 </head>
 
 <body>

apps/app/package.json

@@ -6,8 +6,11 @@
   "scripts": {
     "dev": "vite",
     "build": "tsc -b && vite build",
+    "postbuild": "node scripts/verify-dist-assets.mjs",
     "lint": "eslint .",
-    "preview": "vite preview"
+    "preview": "vite preview",
+    "serve:dist": "node server.mjs",
+    "verify:static-server": "node scripts/verify-static-server.mjs"
   },
   "dependencies": {
     "@mysten/dapp-kit": "^1.0.3",