Prompt file imported from GrupoUS/aegiswallet (.github/prompts/deploy-vercel.prompt.md). Fill in {{arg1}} before use. Copyright stays with the author.

Deploy to Vercel

Name: deploy-vercel
Author: GrupoUS

This command helps you deploy AegisWallet to Vercel platform using the Hono + Vite stack.

🛑 MANDATORY DEPLOYMENT POLICY

ALL TypeScript errors MUST be fixed before deployment.

✅ DO: Fix all type-check errors, then build, then deploy

❌ DO NOT: Skip error fixing or use --no-type-check

❌ DO NOT: Deploy with known errors "to fix later"

No exceptions. This ensures production stability and prevents runtime failures.

Prerequisites

Before deploying, ensure you have:

Vercel Account
Vercel CLI installed globally: bun add -g vercel
Bun runtime installed
Linked your project to Vercel account

Initial Setup (First Time Only)

If this is your first time deploying:

Login to Vercel:
```
vercel login
```
Link Project:
```
vercel link
```
Setup Environment Variables:
```
bun deploy:vercel:setup
```
Required environment variables:
- VITE_SUPABASE_URL - Supabase project URL
- VITE_SUPABASE_ANON_KEY - Supabase public anonymous key
- VITE_GOOGLE_CLIENT_ID - Google OAuth Client ID
- GOOGLE_CLIENT_SECRET - Google OAuth Client Secret
- GOOGLE_REDIRECT_URI - OAuth callback URI
- TOKENS_ENCRYPTION_KEY - Key for encrypting sensitive tokens
⚠️ Important: For Google OAuth login to work, credentials must also be configured in the Supabase Dashboard (Authentication > Providers > Google).

Deployment Strategy

🚀 ALWAYS DEPLOY TO PRODUCTION

All deployments go directly to production at https://aegiswallet.vercel.app.

The deployment process will:

Fix all TypeScript errors first (mandatory)
Run type-check, lint, and build locally
Deploy directly to production

⚠️ Preview deployments are disabled. All deploys target production.

# Standard deployment command (always production)
vercel deploy --prod --yes

# Or using the npm script
bun deploy:vercel:prod

Deployment with Continuous Error Verification

This workflow performs iterative testing and fixing until the deployment succeeds without errors.

Step-by-Step Process

1. Initial Build Verification

Before deploying, verify the local build works:

# Run type checking
bun run type-check

# Run linting
bun run lint

# Build locally
bun run build

If any of these fail, fix the errors before proceeding.

2. Deploy to Production

# Deploy directly to production
vercel deploy --prod --yes

# Or using npm script:
bun deploy:vercel:prod

Production URL: https://aegiswallet.vercel.app

3. Check Deployment Logs for Errors

# View real-time logs
vercel logs <deployment-url> --follow

# Or check specific deployment logs
vercel logs <deployment-url>

Look for:

Build errors
Runtime errors
Function timeouts
Missing environment variables
Import/module resolution errors

4. Test Deployed Application

Run comprehensive tests against the deployed URL:

# Health check
curl https://<deployment-url>/health

# Test API endpoints
curl https://<deployment-url>/api/v1/health

# Test frontend loads
curl -I https://<deployment-url>

Manual browser testing:

Open https://<deployment-url> in browser
Check console for errors (F12 → Console)
Test critical user flows:
- Login functionality
- Navigation between pages
- API calls working correctly
Check Network tab for failed requests

5. Identify and Fix Errors

Common error types and fixes:

Build Errors:

Missing dependencies: Add to package.json and run bun install
TypeScript errors: Fix type issues in the code
Import errors: Check import paths and file names

Runtime Errors:

Environment variables missing: Run bun deploy:vercel:setup or add via Vercel Dashboard
API endpoint failures: Check Hono RPC routes at /api/v1/*
Database connection issues: Verify Supabase credentials and RLS policies

Performance Issues:

Function timeouts: Optimize slow operations or increase timeout limits
Memory issues: Reduce bundle size or optimize memory usage

6. Re-deploy After Fixes

After making fixes:

# Commit your changes
git add .
git commit -m "fix: resolve deployment errors"

# Re-deploy to production
vercel deploy --prod --yes

7. Iterate Until Clean Deployment

Repeat steps 3-6 until:

✅ No errors in deployment logs
✅ All health checks pass
✅ No console errors in browser
✅ All critical user flows work
✅ All API endpoints respond correctly

8. Verify Production Deployment

Once deployment is complete:

# Verify production deployment
vercel logs https://aegiswallet.vercel.app --follow

# Run production health checks
curl https://aegiswallet.vercel.app/health
curl https://aegiswallet.vercel.app/api/v1/health

Automated Error Detection Script

Create a verification script to automate checks:

#!/usr/bin/env bash
# scripts/verify-deployment.sh

DEPLOYMENT_URL={{arg1}}

echo "🔍 Verifying deployment: $DEPLOYMENT_URL"

# Health check
echo "1️⃣ Testing health endpoint..."
HEALTH=$(curl -s "$DEPLOYMENT_URL/health")
if [ -z "$HEALTH" ]; then
  echo "❌ Health check failed"
  exit 1
fi
echo "✅ Health check passed"

# Test API
echo "2️⃣ Testing API endpoint..."
API_RESPONSE=$(curl -s "$DEPLOYMENT_URL/api/v1/health")
if [ -z "$API_RESPONSE" ]; then
  echo "❌ API check failed"
  exit 1
fi
echo "✅ API check passed"

# Check for errors in logs
echo "3️⃣ Checking for errors in logs..."
ERRORS=$(vercel logs "$DEPLOYMENT_URL" | grep -i "error" | head -n 5)
if [ ! -z "$ERRORS" ]; then
  echo "⚠️ Errors found in logs:"
  echo "$ERRORS"
  exit 1
fi
echo "✅ No errors in logs"

echo "🎉 All checks passed!"

Usage:

chmod +x scripts/verify-deployment.sh
./scripts/verify-deployment.sh https://aegiswallet.vercel.app

Checklist for Successful Deployment

Post-Deployment Verification

1. View Deployment Logs

vercel logs [deployment-url]

2. Health Check

Verify the backend is running correctly:

curl https://[your-deployment-url]/health

Troubleshooting

Rollback to Previous Version

If something goes wrong, revert to a previous deployment:

vercel rollback

Common Issues

Environment Variables Missing: Run bun deploy:vercel:setup again
Google OAuth Not Working: Check Supabase Dashboard → Authentication → Providers → Google
Build Failures: Check logs with vercel logs [deployment-url]

CI/CD Integration

Automated deployments are configured via GitHub Actions:

Push to main: Triggers Production deployment
Pull Requests: Triggers Preview deployment with URL in PR comments

Performance Notes

Edge Runtime: Hono server runs on Vercel Edge Functions for low latency
Caching: Static assets served with aggressive caching headers
Rewrites: API requests efficiently routed via vercel.json configuration

# Deploy to Vercel This command helps you deploy AegisWallet to Vercel platform using the Hono + Vite stack. > 🛑 **MANDATORY DEPLOYMENT POLICY** > > **ALL TypeScript errors MUST be fixed before deployment.** > > - ✅ DO: Fix all type-check errors, then build, then deploy > - ❌ DO NOT: Skip error fixing or use `--no-type-check` > - ❌ DO NOT: Deploy with known errors "to fix later" > > **No exceptions.** This ensures production stability and prevents runtime failures. ## Prerequisites Before deploying, ensure you have: - Vercel Account - Vercel CLI installed globally: `bun add -g vercel` - Bun runtime installed - Linked your project to Vercel account ## Initial Setup (First Time Only) If this is your first time deploying: 1. **Login to Vercel:** ```bash vercel login ``` 2. **Link Project:** ```bash vercel link ``` 3. **Setup Environment Variables:** ```bash bun deploy:vercel:setup ``` Required environment variables: - `VITE_SUPABASE_URL` - Supabase project URL - `VITE_SUPABASE_ANON_KEY` - Supabase public anonymous key - `VITE_GOOGLE_CLIENT_ID` - Google OAuth Client ID - `GOOGLE_CLIENT_SECRET` - Google OAuth Client Secret - `GOOGLE_REDIRECT_URI` - OAuth callback URI - `TOKENS_ENCRYPTION_KEY` - Key for encrypting sensitive tokens > ⚠️ **Important**: For Google OAuth login to work, credentials must also be configured in the Supabase Dashboard (Authentication > Providers > Google). ### Deployment Strategy **🚀 ALWAYS DEPLOY TO PRODUCTION** All deployments go directly to production at **https://aegiswallet.vercel.app**. The deployment process will: 1. Fix all TypeScript errors first (mandatory) 2. Run type-check, lint, and build locally 3. Deploy directly to production > ⚠️ Preview deployments are disabled. All deploys target production. ```bash # Standard deployment command (always production) vercel deploy --prod --yes # Or using the npm script bun deploy:vercel:prod ``` ## Deployment with Continuous Error Verification This workflow performs iterative testing and fixing until the deployment succeeds without errors. ### Step-by-Step Process #### 1. Initial Build Verification Before deploying, verify the local build works: ```bash # Run type checking bun run type-check # Run linting bun run lint # Build locally bun run build ``` If any of these fail, fix the errors before proceeding. #### 2. Deploy to Production ```bash # Deploy directly to production vercel deploy --prod --yes # Or using npm script: bun deploy:vercel:prod ``` **Production URL**: https://aegiswallet.vercel.app #### 3. Check Deployment Logs for Errors ```bash # View real-time logs vercel logs <deployment-url> --follow # Or check specific deployment logs vercel logs <deployment-url> ``` **Look for**: - Build errors - Runtime errors - Function timeouts - Missing environment variables - Import/module resolution errors #### 4. Test Deployed Application Run comprehensive tests against the deployed URL: ```bash # Health check curl https://<deployment-url>/health # Test API endpoints curl https://<deployment-url>/api/v1/health # Test frontend loads curl -I https://<deployment-url> ``` **Manual browser testing**: 1. Open `https://<deployment-url>` in browser 2. Check console for errors (F12 → Console) 3. Test critical user flows: - Login functionality - Navigation between pages - API calls working correctly 4. Check Network tab for failed requests #### 5. Identify and Fix Errors Common error types and fixes: **Build Errors:** - **Missing dependencies**: Add to `package.json` and run `bun install` - **TypeScript errors**: Fix type issues in the code - **Import errors**: Check import paths and file names **Runtime Errors:** - **Environment variables missing**: Run `bun deploy:vercel:setup` or add via Vercel Dashboard - **API endpoint failures**: Check Hono RPC routes at `/api/v1/*` - **Database connection issues**: Verify Supabase credentials and RLS policies **Performance Issues:** - **Function timeouts**: Optimize slow operations or increase timeout limits - **Memory issues**: Reduce bundle size or optimize memory usage #### 6. Re-deploy After Fixes After making fixes: ```bash # Commit your changes git add . git commit -m "fix: resolve deployment errors" # Re-deploy to production vercel deploy --prod --yes ``` #### 7. Iterate Until Clean Deployment **Repeat steps 3-6 until:** - ✅ No errors in deployment logs - ✅ All health checks pass - ✅ No console errors in browser - ✅ All critical user flows work - ✅ All API endpoints respond correctly #### 8. Verify Production Deployment Once deployment is complete: ```bash # Verify production deployment vercel logs https://aegiswallet.vercel.app --follow # Run production health checks curl https://aegiswallet.vercel.app/health curl https://aegiswallet.vercel.app/api/v1/health ``` ### Automated Error Detection Script Create a verification script to automate checks: ```bash #!/usr/bin/env bash # scripts/verify-deployment.sh DEPLOYMENT_URL={{arg1}} echo "🔍 Verifying deployment: $DEPLOYMENT_URL" # Health check echo "1️⃣ Testing health endpoint..." HEALTH=$(curl -s "$DEPLOYMENT_URL/health") if [ -z "$HEALTH" ]; then echo "❌ Health check failed" exit 1 fi echo "✅ Health check passed" # Test API echo "2️⃣ Testing API endpoint..." API_RESPONSE=$(curl -s "$DEPLOYMENT_URL/api/v1/health") if [ -z "$API_RESPONSE" ]; then echo "❌ API check failed" exit 1 fi echo "✅ API check passed" # Check for errors in logs echo "3️⃣ Checking for errors in logs..." ERRORS=$(vercel logs "$DEPLOYMENT_URL" | grep -i "error" | head -n 5) if [ ! -z "$ERRORS" ]; then echo "⚠️ Errors found in logs:" echo "$ERRORS" exit 1 fi echo "✅ No errors in logs" echo "🎉 All checks passed!" ``` Usage: ```bash chmod +x scripts/verify-deployment.sh ./scripts/verify-deployment.sh https://aegiswallet.vercel.app ``` ### Checklist for Successful Deployment - [ ] Local build passes (`bun run build`) - [ ] Type checking passes (`bun run type-check`) - [ ] Linting passes (`bun run lint`) - [ ] Deployment completes without build errors - [ ] Health endpoint returns 200 OK - [ ] No errors in Vercel logs - [ ] Frontend loads without console errors - [ ] Google OAuth login works - [ ] API endpoints respond correctly - [ ] Database queries work (check RLS policies) - [ ] All environment variables configured ## Post-Deployment Verification ### 1. View Deployment Logs ```bash vercel logs [deployment-url] ``` ### 2. Health Check Verify the backend is running correctly: ```bash curl https://[your-deployment-url]/health ``` ## Troubleshooting ### Rollback to Previous Version If something goes wrong, revert to a previous deployment: ```bash vercel rollback ``` ### Common Issues 1. **Environment Variables Missing**: Run `bun deploy:vercel:setup` again 2. **Google OAuth Not Working**: Check Supabase Dashboard → Authentication → Providers → Google 3. **Build Failures**: Check logs with `vercel logs [deployment-url]` ## CI/CD Integration Automated deployments are configured via GitHub Actions: - **Push to `main`**: Triggers Production deployment - **Pull Requests**: Triggers Preview deployment with URL in PR comments ## Performance Notes - **Edge Runtime**: Hono server runs on Vercel Edge Functions for low latency - **Caching**: Static assets served with aggressive caching headers - **Rewrites**: API requests efficiently routed via `vercel.json` configuration

{ "prompt": "# Deploy to Vercel\n\nThis command helps you deploy AegisWallet to Vercel platform using the Hono + Vite stack.\n\n> 🛑 **MANDATORY DEPLOYMENT POLICY**\n>\n> **ALL TypeScript errors MUST be fixed before deployment.**\n>\n> - ✅ DO: Fix all type-check errors, then build, then deploy\n> - ❌ DO NOT: Skip error fixing or use `--no-type-check`\n> - ❌ DO NOT: Deploy with known errors \"to fix later\"\n>\n> **No exceptions.** This ensures production stability and prevents runtime failures.\n\n## Prerequisites\n\nBefore deploying, ensure you have:\n- Vercel Account\n- Vercel CLI installed globally: `bun add -g vercel`\n- Bun runtime installed\n- Linked your project to Vercel account\n\n## Initial Setup (First Time Only)\n\nIf this is your first time deploying:\n\n1. **Login to Vercel:**\n ```bash\n vercel login\n ```\n\n2. **Link Project:**\n ```bash\n vercel link\n ```\n\n3. **Setup Environment Variables:**\n ```bash\n bun deploy:vercel:setup\n ```\n\n Required environment variables:\n - `VITE_SUPABASE_URL` - Supabase project URL\n - `VITE_SUPABASE_ANON_KEY` - Supabase public anonymous key\n - `VITE_GOOGLE_CLIENT_ID` - Google OAuth Client ID\n - `GOOGLE_CLIENT_SECRET` - Google OAuth Client Secret\n - `GOOGLE_REDIRECT_URI` - OAuth callback URI\n - `TOKENS_ENCRYPTION_KEY` - Key for encrypting sensitive tokens\n\n > ⚠️ **Important**: For Google OAuth login to work, credentials must also be configured in the Supabase Dashboard (Authentication > Providers > Google).\n\n### Deployment Strategy\n\n**🚀 ALWAYS DEPLOY TO PRODUCTION**\n\nAll deployments go directly to production at **https://aegiswallet.vercel.app**.\n\nThe deployment process will:\n1. Fix all TypeScript errors first (mandatory)\n2. Run type-check, lint, and build locally\n3. Deploy directly to production\n\n> ⚠️ Preview deployments are disabled. All deploys target production.\n\n```bash\n# Standard deployment command (always production)\nvercel deploy --prod --yes\n\n# Or using the npm script\nbun deploy:vercel:prod\n```\n\n## Deployment with Continuous Error Verification\n\nThis workflow performs iterative testing and fixing until the deployment succeeds without errors.\n\n### Step-by-Step Process\n\n#### 1. Initial Build Verification\nBefore deploying, verify the local build works:\n```bash\n# Run type checking\nbun run type-check\n\n# Run linting\nbun run lint\n\n# Build locally\nbun run build\n```\n\nIf any of these fail, fix the errors before proceeding.\n\n#### 2. Deploy to Production\n```bash\n# Deploy directly to production\nvercel deploy --prod --yes\n\n# Or using npm script:\nbun deploy:vercel:prod\n```\n\n**Production URL**: https://aegiswallet.vercel.app\n\n#### 3. Check Deployment Logs for Errors\n```bash\n# View real-time logs\nvercel logs <deployment-url> --follow\n\n# Or check specific deployment logs\nvercel logs <deployment-url>\n```\n\n**Look for**:\n- Build errors\n- Runtime errors\n- Function timeouts\n- Missing environment variables\n- Import/module resolution errors\n\n#### 4. Test Deployed Application\nRun comprehensive tests against the deployed URL:\n\n```bash\n# Health check\ncurl https://<deployment-url>/health\n\n# Test API endpoints\ncurl https://<deployment-url>/api/v1/health\n\n# Test frontend loads\ncurl -I https://<deployment-url>\n```\n\n**Manual browser testing**:\n1. Open `https://<deployment-url>` in browser\n2. Check console for errors (F12 → Console)\n3. Test critical user flows:\n - Login functionality\n - Navigation between pages\n - API calls working correctly\n4. Check Network tab for failed requests\n\n#### 5. Identify and Fix Errors\n\nCommon error types and fixes:\n\n**Build Errors:**\n- **Missing dependencies**: Add to `package.json` and run `bun install`\n- **TypeScript errors**: Fix type issues in the code\n- **Import errors**: Check import paths and file names\n\n**Runtime Errors:**\n- **Environment variables missing**: Run `bun deploy:vercel:setup` or add via Vercel Dashboard\n- **API endpoint failures**: Check Hono RPC routes at `/api/v1/*`\n- **Database connection issues**: Verify Supabase credentials and RLS policies\n\n**Performance Issues:**\n- **Function timeouts**: Optimize slow operations or increase timeout limits\n- **Memory issues**: Reduce bundle size or optimize memory usage\n\n#### 6. Re-deploy After Fixes\nAfter making fixes:\n\n```bash\n# Commit your changes\ngit add .\ngit commit -m \"fix: resolve deployment errors\"\n\n# Re-deploy to production\nvercel deploy --prod --yes\n```\n\n#### 7. Iterate Until Clean Deployment\n**Repeat steps 3-6 until:**\n- ✅ No errors in deployment logs\n- ✅ All health checks pass\n- ✅ No console errors in browser\n- ✅ All critical user flows work\n- ✅ All API endpoints respond correctly\n\n#### 8. Verify Production Deployment\nOnce deployment is complete:\n\n```bash\n# Verify production deployment\nvercel logs https://aegiswallet.vercel.app --follow\n\n# Run production health checks\ncurl https://aegiswallet.vercel.app/health\ncurl https://aegiswallet.vercel.app/api/v1/health\n```\n\n### Automated Error Detection Script\n\nCreate a verification script to automate checks:\n\n```bash\n#!/usr/bin/env bash\n# scripts/verify-deployment.sh\n\nDEPLOYMENT_URL={{arg1}}\n\necho \"🔍 Verifying deployment: $DEPLOYMENT_URL\"\n\n# Health check\necho \"1️⃣ Testing health endpoint...\"\nHEALTH=$(curl -s \"$DEPLOYMENT_URL/health\")\nif [ -z \"$HEALTH\" ]; then\n echo \"❌ Health check failed\"\n exit 1\nfi\necho \"✅ Health check passed\"\n\n# Test API\necho \"2️⃣ Testing API endpoint...\"\nAPI_RESPONSE=$(curl -s \"$DEPLOYMENT_URL/api/v1/health\")\nif [ -z \"$API_RESPONSE\" ]; then\n echo \"❌ API check failed\"\n exit 1\nfi\necho \"✅ API check passed\"\n\n# Check for errors in logs\necho \"3️⃣ Checking for errors in logs...\"\nERRORS=$(vercel logs \"$DEPLOYMENT_URL\" | grep -i \"error\" | head -n 5)\nif [ ! -z \"$ERRORS\" ]; then\n echo \"⚠️ Errors found in logs:\"\n echo \"$ERRORS\"\n exit 1\nfi\necho \"✅ No errors in logs\"\n\necho \"🎉 All checks passed!\"\n```\n\nUsage:\n```bash\nchmod +x scripts/verify-deployment.sh\n./scripts/verify-deployment.sh https://aegiswallet.vercel.app\n```\n\n### Checklist for Successful Deployment\n\n- [ ] Local build passes (`bun run build`)\n- [ ] Type checking passes (`bun run type-check`)\n- [ ] Linting passes (`bun run lint`)\n- [ ] Deployment completes without build errors\n- [ ] Health endpoint returns 200 OK\n- [ ] No errors in Vercel logs\n- [ ] Frontend loads without console errors\n- [ ] Google OAuth login works\n- [ ] API endpoints respond correctly\n- [ ] Database queries work (check RLS policies)\n- [ ] All environment variables configured\n\n## Post-Deployment Verification\n\n### 1. View Deployment Logs\n```bash\nvercel logs [deployment-url]\n```\n\n### 2. Health Check\nVerify the backend is running correctly:\n```bash\ncurl https://[your-deployment-url]/health\n```\n\n## Troubleshooting\n\n### Rollback to Previous Version\nIf something goes wrong, revert to a previous deployment:\n```bash\nvercel rollback\n```\n\n### Common Issues\n1. **Environment Variables Missing**: Run `bun deploy:vercel:setup` again\n2. **Google OAuth Not Working**: Check Supabase Dashboard → Authentication → Providers → Google\n3. **Build Failures**: Check logs with `vercel logs [deployment-url]`\n\n## CI/CD Integration\n\nAutomated deployments are configured via GitHub Actions:\n- **Push to `main`**: Triggers Production deployment\n- **Pull Requests**: Triggers Preview deployment with URL in PR comments\n\n## Performance Notes\n\n- **Edge Runtime**: Hono server runs on Vercel Edge Functions for low latency\n- **Caching**: Static assets served with aggressive caching headers\n- **Rewrites**: API requests efficiently routed via `vercel.json` configuration", "variables": [ "arg1" ], "notes": "This command helps you deploy AegisWallet to Vercel platform using the Hono + Vite stack.", "metadata": { "source": { "provider": "github-prompts", "repository": "https://github.com/GrupoUS/aegiswallet", "path": ".github/prompts/deploy-vercel.prompt.md", "ref": "1cdbf5b2cc9a3891b1bc1362343399b118d1e9b1", "url": "https://github.com/GrupoUS/aegiswallet/blob/1cdbf5b2cc9a3891b1bc1362343399b118d1e9b1/.github/prompts/deploy-vercel.prompt.md", "key": "GrupoUS/aegiswallet/.github/prompts/deploy-vercel.prompt.md" } } }

deploy-vercel

About