Vercel Expert | Bootspring Docs

The Vercel Expert agent specializes in Vercel platform deployment, Edge Functions, serverless configuration, environment management, and optimizing Next.js apps for Vercel hosting.

Expertise Areas#

Project Configuration - vercel.json setup and optimization
Edge Functions - Edge runtime for low-latency responses
Environment Variables - Secure configuration management
Serverless Functions - Timeout, region, and runtime config
Caching & ISR - Incremental Static Regeneration
Vercel Storage - Blob, KV, and Postgres
Preview Deployments - PR-based testing environments
Cron Jobs - Scheduled serverless execution

Usage Examples#

Project Setup#

Use the vercel-expert agent to configure vercel.json for a Next.js SaaS application with API routes.

Response includes:

Build configuration
Function timeouts
Headers and redirects
Region settings

Edge Functions#

Use the vercel-expert agent to implement geo-based routing using Edge Functions.

Response includes:

Edge runtime setup
Middleware configuration
Geo detection
Response handling

Caching Strategy#

Use the vercel-expert agent to implement ISR with on-demand revalidation for a blog.

Response includes:

Revalidation configuration
Cache tags
API endpoints for revalidation
Cache invalidation patterns

Best Practices Applied#

1. Deployment#

Proper build commands
Environment variable scoping
Region optimization
Preview deployment testing

2. Performance#

Edge runtime for latency-sensitive routes
ISR for dynamic content
On-demand revalidation
Proper caching headers

3. Storage#

Blob for file uploads
KV for session/cache data
Postgres for relational data
Efficient data access patterns

4. Security#

Environment variable protection
Cron job authentication
Secure headers
API route protection

Common Patterns#

Vercel Configuration#

// vercel.json
{
  "framework": "nextjs",
  "buildCommand": "npm run build",
  "regions": ["iad1"],
  "functions": {
    "app/api/**/*.ts": {
      "maxDuration": 30
    }
  },
  "headers": [
    {
      "source": "/api/(.*)",
      "headers": [
        { "key": "Access-Control-Allow-Origin", "value": "*" }
      ]
    }
  ],
  "crons": [
    {
      "path": "/api/cron/cleanup",
      "schedule": "0 0 * * *"
    }
  ]
}

Edge Function#

// app/api/edge/route.ts
export const runtime = 'edge';

export async function GET(request: Request) {
  const country = request.headers.get('x-vercel-ip-country') ?? 'US';

  return new Response(JSON.stringify({
    message: 'Hello from the edge!',
    country,
  }), {
    headers: { 'Content-Type': 'application/json' },
  });
}

On-Demand Revalidation#

// app/api/revalidate/route.ts
import { revalidatePath, revalidateTag } from 'next/cache';
import { NextRequest, NextResponse } from 'next/server';

export async function POST(request: NextRequest) {
  const secret = request.headers.get('x-revalidate-secret');

  if (secret !== process.env.REVALIDATE_SECRET) {
    return NextResponse.json({ error: 'Invalid secret' }, { status: 401 });
  }

  const { path, tag } = await request.json();

  if (path) revalidatePath(path);
  if (tag) revalidateTag(tag);

  return NextResponse.json({ revalidated: true, now: Date.now() });
}

Vercel Blob Storage#

// app/api/upload/route.ts
import { put, del, list } from '@vercel/blob';
import { NextResponse } from 'next/server';

export async function POST(request: Request) {
  const formData = await request.formData();
  const file = formData.get('file') as File;

  if (!file) {
    return NextResponse.json({ error: 'No file provided' }, { status: 400 });
  }

  const blob = await put(file.name, file, {
    access: 'public',
    addRandomSuffix: true,
  });

  return NextResponse.json(blob);
}

Sample Prompts#

Task	Prompt
Configuration	"Set up vercel.json for a production deployment"
Edge functions	"Implement geolocation-based content serving"
ISR	"Configure incremental static regeneration for product pages"
Blob storage	"Set up file upload with Vercel Blob"
Cron jobs	"Schedule a daily cleanup job"

Configuration#

// bootspring.config.js
module.exports = {
  agents: {
    customInstructions: {
      'vercel-expert': `
        - Use Edge runtime for latency-sensitive routes
        - Configure proper environment variables
        - Implement ISR with on-demand revalidation
        - Use Vercel storage solutions
        - Set up preview deployment testing
      `,
    },
  },
  deployment: {
    platform: 'vercel',
    region: 'iad1',
  },
};

DevOps Expert - CI/CD and infrastructure
Performance Expert - Optimization
Backend Expert - API development