0xsequence · taylanpince · May 25, 2026 · May 25, 2026 · May 25, 2026 · May 25, 2026
diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
@@ -49,10 +49,19 @@ jobs:
           VITE_OMS_PUBLIC_API_KEY: ${{ secrets.OMS_PUBLIC_API_KEY }}
           VITE_OMS_PROJECT_ID: ${{ secrets.OMS_PROJECT_ID }}
 
+      - name: Build Trails Actions example
+        run: pnpm build:trails-actions-example
+        env:
+          GITHUB_PAGES: 'true'
+          VITE_OMS_PUBLIC_API_KEY: ${{ secrets.OMS_PUBLIC_API_KEY }}
+          VITE_OMS_PROJECT_ID: ${{ secrets.OMS_PROJECT_ID }}
+
       - name: Stage Pages artifact
         run: |
           mkdir -p pages/react-example
+          mkdir -p pages/trails-actions-example
           cp -R examples/react/dist/. pages/react-example/
+          cp -R examples/trails-actions/dist/. pages/trails-actions-example/
 
       - name: Upload Pages artifact
         uses: actions/upload-pages-artifact@v3
@@ -64,7 +73,7 @@ jobs:
     runs-on: ubuntu-latest
     environment:
       name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}react-example/
+      url: ${{ steps.deployment.outputs.page_url }}trails-actions-example/
 
     steps:
       - name: Deploy to GitHub Pages

diff --git a/README.md b/README.md
@@ -71,6 +71,20 @@ cp examples/react/.env.example examples/react/.env.local
 pnpm dev:example
 ```
 
+## Trails Actions React Example
+
+The Trails Actions example prepares and sends Polygon swap, deposit, and swap plus deposit flows with `0xtrails/actions`.
+
+The deployed Trails Actions example is available at [https://0xsequence.github.io/typescript-sdk/trails-actions-example/](https://0xsequence.github.io/typescript-sdk/trails-actions-example/).
+
+To run it locally from the repository root:
+
+```bash
+cp examples/trails-actions/.env.example examples/trails-actions/.env.local
+# Fill VITE_OMS_PUBLIC_API_KEY and VITE_OMS_PROJECT_ID in examples/trails-actions/.env.local
+pnpm dev:trails-actions-example
+```
+
 ## Quick Start
 
 ```typescript

diff --git a/examples/trails-actions/.env.example b/examples/trails-actions/.env.example
@@ -0,0 +1,2 @@
+VITE_OMS_PUBLIC_API_KEY=
+VITE_OMS_PROJECT_ID=
diff --git a/examples/trails-actions/README.md b/examples/trails-actions/README.md
@@ -0,0 +1,30 @@
+# Trails Actions React Example
+
+This Vite React app uses the TypeScript SDK wallet client with Trails actions on Polygon:
+
+- Swap POL to USDC
+- Deposit USDC using Earn
+- Swap POL to USDC and deposit USDC in one prepared Trails transaction
+
+Run it from the repository root:
+
+```bash
+pnpm install
+pnpm build
+cp examples/trails-actions/.env.example examples/trails-actions/.env.local
+# Fill VITE_OMS_PUBLIC_API_KEY and VITE_OMS_PROJECT_ID
+pnpm dev:trails-actions-example
+```
+
+The dev server runs at `http://localhost:5173`.
+
+The deployed example is available at `https://0xsequence.github.io/typescript-sdk/trails-actions-example`.
+
+The OMS project used by the environment values must support Polygon.
+
+Build it from the repository root:
+
+```bash
+pnpm build
+pnpm build:trails-actions-example
+```
diff --git a/examples/trails-actions/index.html b/examples/trails-actions/index.html
@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Trails Actions React Example</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
diff --git a/examples/trails-actions/package.json b/examples/trails-actions/package.json
@@ -0,0 +1,26 @@
+{
+  "name": "trails-actions-example",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "0xtrails": "0.16.0",
+    "@0xsequence/typescript-sdk": "workspace:*",
+    "@0xtrails/api": "0.16.0",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "viem": "^2.48.4"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "typescript": "^5.9.3",
+    "vite": "^8.0.10"
+  }
+}