--- title: "eve Chat Template" description: "A persisted Next.js chat template for eve, built with shadcn/ui, Tailwind CSS, Streamdown, Better Auth, Drizzle, and Neon." url: "https://vercel.com/templates/eve/eve-chat-template" links: repository: "https://github.com/vercel/eve/tree/main/apps/templates/eve-chat-template" demo: "https://chat.eve.dev" deploy: "https://vercel.com/new/clone?demo-title=eve+Chat+Template&demo-description=A+persisted+Next.js+chat+template+for+eve%2C+built+with+shadcn%2Fui%2C+Tailwind+CSS%2C+Streamdown%2C+Better+Auth%2C+Drizzle%2C+and+Neon.&demo-url=https%3A%2F%2Fchat.eve.dev&project-name=eve+Chat+Template&repository-name=eve-chat-template&repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Feve%2Ftree%2Fmain%2Fapps%2Ftemplates%2Feve-chat-template&demo-image=%2F%2Fimages.ctfassets.net%2Fe5382hct74si%2FYXYTquqpBmvVFbASdIvrC%2Fbb50d21ba7866882d90e25d842b6fc02%2Feve-chat-no-bg.png&env=EVE_CHAT_PASSWORD&envDescription=Choose+a+strong+password+to+protect+your+agent+%2816%2B+characters+recommended%29.&envLink=https%3A%2F%2Fgithub.com%2Fvercel%2Feve%2Fblob%2Fmain%2Fapps%2Ftemplates%2Feve-chat-template%2Fdocs%2Fsetup-and-deploy.md&from=templates" --- # eve Chat Template A persisted Next.js chat template for eve, built with shadcn/ui, Tailwind CSS, Streamdown, Better Auth, Drizzle, and Neon. # eve Chat Template A persisted Next.js chat template for [eve](https://eve.dev), built with shadcn/ui, Tailwind CSS, Streamdown, Better Auth, Drizzle, Neon, and Upstash Redis. [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?project-name=eve-chat-template&repository-name=eve-chat-template&repository-url=https%3A%2F%2Fgithub.com%2Fvercel%2Feve%2Ftree%2Fmain%2Fapps%2Ftemplates%2Feve-chat-template&env=EVE_CHAT_PASSWORD&envDescription=Choose+a+strong+password+to+protect+your+agent+%2816%2B+characters+recommended%29.&envLink=https%3A%2F%2Fgithub.com%2Fvercel%2Feve%2Fblob%2Fmain%2Fapps%2Ftemplates%2Feve-chat-template%2Fdocs%2Fsetup-and-deploy.md) ## 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](https://github.com/vercel/eve/tree/main/apps/templates/eve-chat-template/docs/setup-and-deploy.md#one-click-deploy)). - **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. ```bash # Uses the linked project's team by default ./scripts/setup.sh # Or target a specific team (also accepts a bare team slug) ./scripts/setup.sh --scope ``` 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](https://github.com/vercel/eve/tree/main/apps/templates/eve-chat-template/docs/setup-and-deploy.md) guide. ## Getting Started For the full local setup, storage provisioning, Sign in with Vercel credentials, and production deploy flow, see [Setup and Deployment](https://github.com/vercel/eve/tree/main/apps/templates/eve-chat-template/docs/setup-and-deploy.md). For the runtime architecture, streaming model, persistence flow, and extension points, see [How the Chatbot Works](https://github.com/vercel/eve/tree/main/apps/templates/eve-chat-template/docs/how-the-chatbot-works.md). Install dependencies with pnpm: ```bash pnpm install ``` Link the Vercel project and pull environment variables: ```bash vercel link ``` Provision storage with the [Vercel CLI integration commands](https://vercel.com/docs/cli/integration): ```bash # Required: persisted chat, auth, eve session state, and message snapshots vercel integration add neon # Required: Redis-backed rate limiting vercel integration add upstash ``` Follow the prompts to connect each resource to the linked project. Then pull the generated environment variables locally: ```bash vercel env pull .env.local --yes ``` Required environment variables: ```bash DATABASE_URL= BETTER_AUTH_SECRET= NEXT_PUBLIC_VERCEL_APP_CLIENT_ID= VERCEL_APP_CLIENT_SECRET= UPSTASH_REDIS_REST_URL= UPSTASH_REDIS_REST_TOKEN= KV_REST_API_URL= KV_REST_API_TOKEN= ``` Optional environment variables: ```bash # Override the app origin for custom production domains. BETTER_AUTH_URL= # Enable hosted Vercel Connect integrations. SLACK_CONNECTOR= LINEAR_CONNECTOR= NOTION_CONNECTOR= SENTRY_CONNECTOR= ``` Create optional Vercel Connect integrations: ```bash # Slack channel vercel connect create slack --name eve-chat-template --triggers vercel connect attach --triggers --trigger-path /eve/v1/slack --yes # MCP connections vercel connect create mcp.notion.com --name notion vercel connect create https://mcp.linear.app/mcp --name linear vercel connect create https://mcp.sentry.dev/mcp --name sentry ``` The deploy button does not require these integrations. For manual setup, put the returned connector UIDs in `SLACK_CONNECTOR`, `NOTION_CONNECTOR`, `LINEAR_CONNECTOR`, and `SENTRY_CONNECTOR`. Local development falls back to `slack/eve-chat-template`, `notion`, `linear`, and `sentry`, so connectors created with the names above work without editing `agent/`. If the connector is not attached to the linked project, run: ```bash vercel connect attach --yes vercel env pull .env.local ``` Create the database tables: ```bash pnpm db:migrate ``` For production, run migrations with Vercel production env vars: ```bash vercel env run -e production -- pnpm db:migrate ``` Start the development server: ```bash 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, Linear, and Sentry MCP connections - Vercel Connect-backed Slack channel route at `/eve/v1/slack` - 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 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. ## Related Templates ### [eve Contentful Agent](https://vercel.com/templates/eve/eve-contentful-agent) Slack-based Contentful assistant built on eve, with Vercel Drives providing a searchable copy of your content. ### [eve Content Agent](https://vercel.com/templates/eve/eve-content-agent) Turn your style guide into a Slack agent. Drafts blogs, social posts, release notes, and newsletters in your house voice, lint-enforced. ### [eve Personal Agent](https://vercel.com/templates/nuxt/eve-personal-agent) Fork your own personal agent. One identity across web, Slack, and iMessage, with memory you can import, edit, and approve. --- ## Additional documentation The [Vercel Knowledge Base](https://vercel.com/kb) contains guides and answers to common questions about Vercel, including deployment, framework configuration, domains, caching, and troubleshooting.