Correspondents/docs/BUILD.md

Build & Deployment Instructions

Prerequisites

• Node.js (v18 or higher)
• pnpm package manager
• Cloudflare account with Wrangler CLI configured

Development

Start the development server:

pnpm dev

The app will be available at http://localhost:3000

Building for Production

1. Build Next.js Application

pnpm build

This runs next build and creates an optimized production build in .next/

2. Build for Cloudflare with OpenNext

npx @opennextjs/cloudflare build

This command:

• Runs the Next.js build (if not already built)
• Converts the Next.js output to Cloudflare Workers format
• Creates the deployment-ready bundle in .open-next/
• Generates the worker script and static assets

Note: You must run this step before deploying to Cloudflare. The standard next build alone is not sufficient.

Deployment

Deploy to Cloudflare Workers

npx wrangler deploy

Or specify an environment explicitly:

npx wrangler deploy --env=""  # Deploy to default environment

The deployment will:

• Upload new/modified static assets
• Deploy the worker script
• Provide a live URL (e.g., https://inspiration-repo-agent.nicholaivogelfilms.workers.dev)

Complete Build & Deploy Workflow

# 1. Build Next.js app and prepare for Cloudflare
npx @opennextjs/cloudflare build

# 2. Deploy to Cloudflare
npx wrangler deploy

Environment Variables

Local Development

Create a .env.local file in the project root:

AGENT_1_URL=https://n8n.example.com/webhook/agent-1-uuid
AGENT_1_NAME=Agent Name
AGENT_1_DESCRIPTION=Description of the agent

AGENT_2_URL=https://n8n.example.com/webhook/agent-2-uuid
AGENT_2_NAME=Another Agent
AGENT_2_DESCRIPTION=Description of another agent

Production (Cloudflare)

Set environment variables in the Cloudflare dashboard:

1. Go to Workers & Pages → inspiration-repo-agent → Settings → Environment Variables
2. Add the same AGENT_* variables as above
3. Redeploy for changes to take effect

Troubleshooting

"No updated asset files to upload"

This means the OpenNext build hasn't been run or hasn't picked up your changes. Run:

npx @opennextjs/cloudflare build

Then deploy again.

ESLint Configuration Error

If you see ESLint errors during build, the build will still complete successfully. The linting step can be skipped if needed.

Multiple Environments Warning

If you see a warning about multiple environments, explicitly specify the environment:

npx wrangler deploy --env=""

Package Manager

This project uses pnpm (not npm). Always use pnpm commands:

• pnpm install - Install dependencies
• pnpm dev - Start dev server
• pnpm build - Build Next.js app

Tech Stack

• Framework: Next.js 15.5.4 (App Router)
• Runtime: Cloudflare Workers
• Adapter: @opennextjs/cloudflare
• Styling: Tailwind CSS 4.1.9
• Package Manager: pnpm