Back to .md Directory

Safe Wallet Pro – Vercel Context

Documents deployment configuration and environment setup for a Safe{Wallet} dApp on Vercel.

May 2, 2026
0 downloads
1 views
ai agent workflow
View source

What this file does

Documents deployment configuration and environment setup for a Safe{Wallet} dApp on Vercel.

When to use it

  • Deploying a Safe{Wallet} integration to Vercel
  • Setting up environment variables for a Safe dApp
  • Configuring the Safe App manifest file
  • Syncing CI/CD workflows with Vercel settings

Assumes this stack

Next.jsViteethers.jsviem@safe-global/protocol-kit@safe-global/safe-core-sdk

Safe Wallet Pro – Vercel Context

This document provides deployment context and configuration guidance for the Safe Wallet Pro project.
It is intended for Vercel AI Agents, developers, and contributors to ensure proper setup and deployment.


📌 Project Overview

  • Name: Safe Wallet Pro

  • Type: Safe{Wallet} integration + dApp (frontend + backend)

  • Main Signer Address: 0xFDf84a0e7D07bC56f7De56696fc409704cC83a24

  • Core SDKs:

    • @safe-global/protocol-kit
    • @safe-global/safe-core-sdk
    • ethers.js or viem
  • Key Features:

    • Safe transaction management
    • WalletConnect + Reown integration
    • Contract verification + Safe App manifest
    • Automated deployment from GitHub to Vercel

🚀 Deployment Guidelines

Build & Output

  • Framework: Next.js (or Vite if specified in package.json)
  • Build Command:
    npm run build
    
  • Output Directory:
    • .next (for Next.js)
    • dist (for Vite)

Environment Variables

Set these in Vercel Dashboard → Project → Settings → Environment Variables:

  • NEXT_PUBLIC_ALCHEMY_API_KEY → RPC provider key (Alchemy, Infura, or custom)
  • NEXT_PUBLIC_SAFE_APP_URL → deployed app URL
  • NEXT_PUBLIC_SIGNER_ADDRESS → 0xFDf84a0e7D07bC56f7De56696fc409704cC83a24

Safe App Manifest

  • The app manifest must be deployed at:
    /public/safe-app.json
    

Example minimal safe-app.json:

{
  "name": "Safe Wallet Pro",
  "description": "Safe{Wallet} integration dApp with contract verification",
  "iconPath": "logo.png",
  "safeAppsSdkVersion": "1.6.0",
  "accessControl": {
    "type": "domain",
    "value": "safe-wallet-pro.vercel.app"
  }
}

✅ Notes

  • Always bump the version tag (vX.Y.Z) before publishing a release.
  • Ensure CI/CD workflows (GitHub Actions + Vercel) are kept in sync with these settings.
  • For local testing, also include http://127.0.0.1/# in your configuration.

What's inside

4 sections: project overview, deployment guidelines, environment variables, and Safe App manifest example.

Change this for your project

  • Replace 0xFDf84a0e7D07bC56f7De56696fc409704cC83a24 with your signer address
  • Replace safe-wallet-pro.vercel.app with your deployed domain
  • Replace NEXT_PUBLIC_ALCHEMY_API_KEY with your own RPC provider key

Where it goes

Keep it in your repository where the agent or team that needs it will read it.

Related Documents