GoodDollar · L03TJ3 · Jul 7, 2026 · Jun 23, 2026 · Jun 23, 2026 · Jun 24, 2026
diff --git a/.github/workflows/deploy-ai-credits-web.yml b/.github/workflows/deploy-ai-credits-web.yml
@@ -0,0 +1,62 @@
+name: Deploy AI Credits Web
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'apps/ai-credits-web/**'
+      - 'packages/ai-credits-widget/**'
+      - 'packages/core/**'
+      - 'packages/ui/**'
+      - 'packages/embed/**'
+      - 'pnpm-lock.yaml'
+      - 'pnpm-workspace.yaml'
+
+concurrency:
+  group: deploy-ai-credits-web-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+  VERCEL_PROJECT_ID: ${{ secrets.VERCEL_AI_CREDITS_WEB_PROJECT_ID }}
+
+jobs:
+  production:
+    runs-on: ubuntu-latest
+    environment:
+      name: production
+      url: ${{ steps.deploy.outputs.url }}
+    defaults:
+      run:
+        working-directory: apps/ai-credits-web
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+        working-directory: ${{ github.workspace }}
+
+      - name: Pull Vercel project settings
+        run: pnpm exec vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Build deployment
+        run: pnpm exec vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}
+
+      - name: Deploy production
+        id: deploy
+        run: |
+          url="$(pnpm exec vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }})"
+          echo "url=$url" >> "$GITHUB_OUTPUT"
diff --git a/.github/workflows/deploy-storybook.yml b/.github/workflows/deploy-storybook.yml
@@ -4,6 +4,11 @@ on:
   push:
     branches:
       - main
+    paths:
+      - 'examples/storybook/**'
+      - 'packages/**'
+      - 'pnpm-lock.yaml'
+      - 'pnpm-workspace.yaml'
 
 concurrency:
   group: deploy-storybook-${{ github.ref }}
@@ -19,6 +24,9 @@ jobs:
     environment:
       name: production
       url: ${{ steps.deploy.outputs.url }}
+    defaults:
+      run:
+        working-directory: examples/storybook
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -36,6 +44,7 @@ jobs:
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
+        working-directory: ${{ github.workspace }}
 
       - name: Pull Vercel project settings
         run: pnpm exec vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}

diff --git a/.gitignore b/.gitignore
@@ -18,3 +18,7 @@ playwright-report/
 local-reference-assets
 .vercel
 .env*
+
+
+.agents
+skills-lock.json
diff --git a/apps/ai-credits-web/.gitignore b/apps/ai-credits-web/.gitignore
@@ -0,0 +1,2 @@
+.vercel
+.env*
diff --git a/apps/ai-credits-web/index.html b/apps/ai-credits-web/index.html
@@ -0,0 +1,24 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>GoodDollar AI Credits</title>
+    <style>
+      * {
+        margin: 0;
+        padding: 0;
+        box-sizing: border-box;
+      }
+      html,
+      body,
+      #root {
+        min-height: 100%;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
diff --git a/apps/ai-credits-web/package.json b/apps/ai-credits-web/package.json
@@ -0,0 +1,28 @@
+{
+  "name": "@goodwidget/ai-credits-web",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite --port 3001",
+    "build": "tsc && vite build",
+    "preview": "vite preview",
+    "lint": "eslint src/",
+    "clean": "rm -rf dist .turbo"
+  },
+  "dependencies": {
+    "@goodwidget/ai-credits-widget": "workspace:*",
+    "@goodwidget/core": "workspace:*",
+    "@goodwidget/ui": "workspace:*",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0",
+    "react-native-web": "^0.19.13"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.2.0"
+  }
+}
diff --git a/apps/ai-credits-web/src/App.tsx b/apps/ai-credits-web/src/App.tsx
@@ -0,0 +1,44 @@
+import React from 'react'
+import { AiCreditsWidget } from '@goodwidget/ai-credits-widget'
+import { Container, Text, YStack } from '@goodwidget/ui'
+
+function getInjectedProvider(): unknown | null {
+  if (typeof window === 'undefined') return null
+  return window.ethereum ?? null
+}
+
+function envAddress(value: string | undefined): `0x${string}` | undefined {
+  return value ? (value as `0x${string}`) : undefined
+}
+
+export function App() {
+  const provider = getInjectedProvider()
+
+  if (!provider) {
+    return (
+      <Container>
+        <YStack gap="$3" paddingVertical="$6">
+          <Text fontWeight="700">No wallet found</Text>
+          <Text secondary>
+            Install or enable a browser wallet (e.g. Rabby, MetaMask), then refresh this page.
+          </Text>
+        </YStack>
+      </Container>
+    )
+  }
+
+  return (
+    <Container>
+      <AiCreditsWidget
+        provider={provider}
+        backendUrl={import.meta.env.VITE_AI_CREDITS_BACKEND_URL}
+        baseRpcUrl={import.meta.env.VITE_AI_CREDITS_BASE_RPC_URL}
+        celoRpcUrl={import.meta.env.VITE_AI_CREDITS_CELO_RPC_URL}
+        fundingVaultAddress={envAddress(import.meta.env.VITE_AI_CREDITS_FUNDING_VAULT_ADDRESS)}
+        vaultAddress={envAddress(import.meta.env.VITE_AI_CREDITS_VAULT_ADDRESS)}
+        goodIdAddress={envAddress(import.meta.env.VITE_AI_CREDITS_GOODID_ADDRESS)}
+        testId="AiCreditsWidget-web"
+      />
+    </Container>
+  )
+}
diff --git a/apps/ai-credits-web/src/globals.d.ts b/apps/ai-credits-web/src/globals.d.ts
@@ -0,0 +1,22 @@
+declare const process: {
+  env: Record<string, string | undefined>
+}
+
+interface Window {
+  ethereum?: unknown
+}
+
+interface ImportMetaEnv {
+  readonly VITE_AI_CREDITS_BACKEND_URL?: string
+  readonly VITE_AI_CREDITS_BASE_RPC_URL?: string
+  readonly VITE_AI_CREDITS_CELO_RPC_URL?: string
+  readonly VITE_AI_CREDITS_FUNDING_VAULT_ADDRESS?: string
+  readonly VITE_AI_CREDITS_VAULT_ADDRESS?: string
+  readonly VITE_AI_CREDITS_GOODID_ADDRESS?: string
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv
+}
+
+declare function setImmediate(callback: (...args: unknown[]) => void, ...args: unknown[]): number
diff --git a/apps/ai-credits-web/src/main.tsx b/apps/ai-credits-web/src/main.tsx
@@ -0,0 +1,9 @@
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import { App } from './App'
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+)
diff --git a/apps/ai-credits-web/src/types/tamagui-shim.d.ts b/apps/ai-credits-web/src/types/tamagui-shim.d.ts
@@ -0,0 +1,4 @@
+declare module 'tamagui' {
+  const tamagui: unknown
+  export = tamagui
+}
diff --git a/apps/ai-credits-web/tsconfig.json b/apps/ai-credits-web/tsconfig.json
@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "strict": false,
+    "baseUrl": ".",
+    "paths": {
+      "react-native": ["react-native-web"],
+      "tamagui": ["src/types/tamagui-shim.d.ts"]
+    }
+  },
+  "include": ["src"]
+}
diff --git a/apps/ai-credits-web/vercel.json b/apps/ai-credits-web/vercel.json
@@ -0,0 +1,11 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "framework": "vite",
+  "installCommand": "cd ../.. && pnpm install --frozen-lockfile",
+  "buildCommand": "cd ../.. && pnpm --filter @goodwidget/ai-credits-web build",
+  "outputDirectory": "dist",
+  "devCommand": "pnpm dev",
+  "git": {
+    "deploymentEnabled": false
+  }
+}
diff --git a/apps/ai-credits-web/vite.config.ts b/apps/ai-credits-web/vite.config.ts
@@ -0,0 +1,36 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  define: {
+    global: 'globalThis',
+    'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'development'),
+    'process.env.TAMAGUI_TARGET': JSON.stringify('web'),
+  },
+  resolve: {
+    alias: {
+      'react-native': 'react-native-web',
+    },
+  },
+  optimizeDeps: {
+    esbuildOptions: {
+      resolveExtensions: [
+        '.web.js',
+        '.web.jsx',
+        '.web.ts',
+        '.web.tsx',
+        '.mjs',
+        '.js',
+        '.mts',
+        '.ts',
+        '.jsx',
+        '.tsx',
+        '.json',
+      ],
+      loader: {
+        '.js': 'jsx',
+      },
+    },
+  },
+})
diff --git a/examples/storybook/package.json b/examples/storybook/package.json
@@ -16,6 +16,7 @@
     "@goodwidget/governance-widget": "workspace:*",
     "@goodwidget/streaming-widget": "workspace:*",
     "@goodwidget/staking-migration-widget": "workspace:*",
+    "@goodwidget/ai-credits-widget": "workspace:*",
     "react": "^18.3.0",
     "react-dom": "^18.3.0",
     "react-native-web": "^0.19.13",
-Original file line number
+Diff line change
@@ Expand Up / @@ -18,3 +18,7 @@ playwright-report/ @@
     local-reference-assets
     .vercel
     .env*
+    .agents
+    skills-lock.json