RAG Chatbot

rag-chatbot

Vercel's AI SDK RAG template — a retrieval-augmented chatbot: useChat on the page, streamText with three tools on the server (addResource, getInformation, understandQuery), resources chunked and embedded, embeddings stored in Postgres with pgvector through Drizzle — running on Cloudflare Workers + Static Assets through @opennextjs/cloudflare, chatting and embedding with Workers AI through the Worker's AI binding, its knowledge base a Supabase project's database reached through Cloudflare Hyperdrive, both provisioned by Terraform through Orun and the schema applied by Orun's db-migrate — the way the Lumen baseline does it — and packaged as an Orun baseline: one command takes a new product from nothing to live on stage and prod, in its own repository, under its own name, in ONE landing.

The template's code is the code. What the port changes is what the Workers runtime and a fresh, unattended deployment force: the database client is built per call over the Hyperdrive binding (lib/db/index.ts), and the models are Workers AI's (lib/ai/models.ts) — the platform brokers no AI vendor, and the Cloudflare account the app deploys into already is one — so the chat, the embeddings and the knowledge base work on a fresh build with only Cloudflare and Supabase connected. The embeddings column is sized to Workers AI's embedding model (768 dimensions, migration 020_workers_ai_embeddings); upstream's gateway model stays available for the chat behind an optional key. What the baseline adds is everything needed to make a copy of it somebody else's — built the way cirrus-baseline builds a product, in one landing. See specs/epics/rag-chatbot for the design, the milestones and the as-built status, including every departure.

Instantiating a product

git clone --depth 1 --branch <baseline-tag> https://github.com/sourceplane/rag-chatbot
cd rag-chatbot
orun new --blueprint repo-blueprint.yaml --out ~/products/acme-rag --run-hooks --resume \
  --set reponame=acme-rag --set productname="Acme Answers" \
  --set githuborg=acme-inc --set subdomain=<workers-dev-subdomain>

Or, once the platform's registry lists it, from the Orun console (Baselines → rag-chatbot → Build). Two phases: 01-product creates the repository, mints the five brokered credentials (Cloudflare and Supabase) and lands the whole product as one pull request, whose convergence on main provisions and deploys it per environment in a fixed order —

supabase ──▶ cloudflare-hyperdrive ──▶ db-migrate ──▶ web

— each edge mode: enforced on a push to main and advisory on a pull request; then 02-docs records the live deployment from probed facts. BOOTSTRAP.md is the operator guide; docs/phases/ has a page per phase.

It creates two Supabase projects, <reponame>-stage and <reponame>-prod. Supabase's free plan allows two active projects per organization, so the connected organization needs room for both (BOOTSTRAP.md, §0).

The new repository receives the product only — the app, the Terraform roots, the migrations, the tests, its CI, its tooling, a README of its own and its operating contract — renamed throughout to the product's name, repository, Worker, Supabase project and Hyperdrive config. None of this repository's machinery ships. No AI vendor key is asked for: Workers AI needs none, and a vendor chat model is the owner's to add afterwards (the product's README, "Use a vendor model instead").

What is here (the product)

Getting started

pnpm install
pnpm run wire:fixture   # re-render apps/web/wrangler.jsonc from its template (committed; this changes nothing)
pnpm typecheck
pnpm lint
pnpm test
pnpm build              # next build + opennextjs-cloudflare build → apps/web/.open-next
pnpm --filter @saas/db run manifest:check

The build needs no database, no model and no Cloudflare credential. Running it locally — a Postgres with pgvector on localhost:5432, pnpm --filter @app/web db:migrate, wrangler login for Workers AI, next dev or wrangler dev — is in the product's README (.baseline/product/README.md), which is what a product built from here carries.

How it maps to Vercel

CI