Neon x Aceternity Chatbot Template

Neon x Aceternity Chatbot Template is an open-source Next.js chatbot starter that streams OpenAI model responses in real time and persists each conversation turn in a Neon serverless Postgres database. It is published on GitHub by Neon (neondatabase/neon-chatbot) and is intended to be cloned, configured with two environment variables, and deployed rather than installed as a package.

What is the Neon x Aceternity Chatbot Template?

The template is a full chatbot application scaffold: it takes a user's chat message as input, sends it to an OpenAI model, streams the assistant reply back to the browser, and writes both the user message and the assistant reply into a Postgres table so history survives page reloads. It runs on Next.js 14's App Router, uses Tailwind CSS for styling, and sources its interface elements from Aceternity UI. Neon provides the hosted serverless Postgres backend and is also the maintainer of the repository.

Key Features

• Streaming responses — assistant output is delivered to the client token by token rather than as one blocking response.
• Persistent chat history — messages are stored in a Neon serverless Postgres table named chat_history with user_message, assistant_message, and a created_at timestamp.
• Aceternity UI components — prebuilt interface pieces are used for the chat surface instead of hand-rolled markup.
• Tailwind CSS theming — colors and layout are customized through utility classes rather than a separate component library config.
• Framer Motion animations — motion effects are included as a project dependency.
• Responsive layout — the UI is described as adapting across device sizes.
• Next.js 14 App Router — routing and layouts live in the /app directory, with /components, /lib, /public, and /styles alongside it.
• Vercel deployment path — the README documents pushing to GitHub, importing to Vercel, and setting environment variables in the dashboard.

Who is it for?

• Developers building a first AI chat product: clone the repo, add a Neon database URL and an OpenAI API key, run the provided SQL to create the history table, and have a working chat interface locally.
• Teams that need message persistence without running a database: Neon's serverless Postgres removes the need to provision or manage a Postgres server for chat storage.
• Next.js developers evaluating UI libraries: the template demonstrates Aceternity UI components and Tailwind inside an App Router project.

What can you do with the Neon x Aceternity Chatbot Template?

• Prototype an internal assistant: stand up a streaming chat endpoint backed by OpenAI and keep a durable log of every exchange for review.
• Ship a demo on Vercel: connect the repository to Vercel, set DATABASE_URL and OPENAI_API_KEY, and deploy a public chat page.
• Extend toward a custom assistant: swap the OpenAI model or style the interface with Tailwind to match an existing brand before building further features.

How does the Neon x Aceternity Chatbot Template work?

Clone the repository and run the install command with npm, yarn, or pnpm, then add a .env.local file holding DATABASE_URL and OPENAI_API_KEY. Execute the CREATE TABLE chat_history statement against the Neon database, start the dev server, and open localhost:3000. Deployment follows the same three steps on Vercel: push to GitHub, import the repo, and add the environment variables.

FAQ

What are the prerequisites for this chatbot template?

Node.js 18 or newer, a Neon account to create a Postgres database, and an OpenAI API key. The README lists no other required services.

Does the template include user accounts or authentication?

No authentication layer is described. The schema stores a single chat_history table of message pairs without a user or session column.