Eve Chat Template

Eve Chat Template

A persisted Next.js chat template for Eve, built with shadcn/ui, Tailwind CSS, Streamdown, Better Auth, Drizzle, Neon, and Upstash Redis.

Quick Start

Two ways to get going:

• One-click: use the Deploy with Vercel button above to clone and provision storage, then run migrations (see Setup and Deployment [blocked]).
• Local script: clone the repo and run the setup script. It links the project, provisions Neon, registers the Sign in with Vercel OAuth app (email scope + callbacks), sets the environment variables through the Vercel API, pulls them locally, runs migrations, and can optionally set up the Notion connector. If OAuth app registration isn't available it falls back to a guided manual flow.

1
# Uses the linked project's team by default
2
./scripts/setup.sh
3

4
# Or target a specific team (also accepts a bare team slug)
5
./scripts/setup.sh --scope <team-slug>

The --scope is optional; omit it to use the linked project's team. The script needs the vercel CLI, node, pnpm, and openssl. Prefer to do it by hand? Follow the sequential steps below, or the full Setup and Deployment [blocked] guide.

Getting Started

For the full local setup, storage provisioning, Sign in with Vercel credentials, and production deploy flow, see Setup and Deployment [blocked]. For the runtime architecture, streaming model, persistence flow, and extension points, see How the Chatbot Works [blocked].

Install dependencies with pnpm:

1
pnpm install

Link the Vercel project and pull environment variables:

1
vercel link

Provision storage with the Vercel CLI integration commands:

1
# Required: persisted chat, auth, Eve session state, and message snapshots
2
vercel integration add neon
3

4
# Required: Redis-backed rate limiting
5
vercel integration add upstash

Follow the prompts to connect each resource to the linked project. Then pull the generated environment variables locally:

1
vercel env pull .env.local --yes

Required environment variables:

1
DATABASE_URL=
2
BETTER_AUTH_SECRET=
3
NEXT_PUBLIC_VERCEL_APP_CLIENT_ID=
4
VERCEL_APP_CLIENT_SECRET=
5
UPSTASH_REDIS_REST_URL=
6
UPSTASH_REDIS_REST_TOKEN=
7
KV_REST_API_URL=
8
KV_REST_API_TOKEN=

Optional environment variables:

1
# Override the app origin for custom production domains.
2
BETTER_AUTH_URL=
3

4
# Enable hosted Notion support.
5
NOTION_CONNECTOR=

Create the Notion connector:

1
vercel connect create mcp.notion.com --name notion

The deploy button does not require Notion. For manual setup, put the returned connector UID in NOTION_CONNECTOR. The app falls back to notion, so local connectors created with --name notion work without editing agent/connections/notion.ts.

If the connector is not attached to the linked project, run:

1
vercel connect attach <connector-uid> --yes
2
vercel env pull .env.local

Create the database tables:

1
pnpm db:migrate

For production, run migrations with Vercel production env vars:

1
vercel env run -e production -- pnpm db:migrate

Start the development server:

1
pnpm dev

What Is Included

• Text chat with an Eve agent through same-origin /eve/v1/* routes
• Better Auth sign-in with Vercel
• Mandatory Neon-backed chat history
• Mandatory Upstash Redis rate limiting for authenticated chat sends
• Drizzle schema and migrations under lib/db
• Saved Eve session cursors and event snapshots
• Sidebar history with delete and new-chat actions
• Vercel Connect-backed Notion MCP connection
• Composer-level connections menu
• First-message chat titles derived locally from the user's prompt
• Streamdown markdown rendering for assistant text and reasoning
• shadcn/Tailwind components for messages, tools, HITL prompts, and composer

This template intentionally does not include Slack code, file uploads, Vercel Blob, guest mode, NextAuth/Auth.js, or AI Elements.

Agent Code

Edit the agent in agent/agent.ts. Its behavior is defined in agent/instructions.md, and tools live in agent/tools/.

The browser talks to Eve with useEveAgent() from eve/react; the app stores Eve stream events and session state so /chat/[id] can resume the same durable conversation after refresh.