Skip to content
UT
All work

Full stack project · 2026

Groundline

AI customer support that answers from a business's own documents

Hosted on a free plan, so the first load can take up to a minute while the server wakes up.

Groundline chat widget answering a customer question with a source citation
Groundline dashboard overview with conversations, handoffs, latency and cost
Owner dashboard: conversations, handoffs, latency, cost and unanswered questions.
Groundline public evals page showing accuracy, citation and refusal rates
Public evals page: accuracy, citation hit rate and correct refusals on the test set.

Overview

Built for a client who wanted an AI assistant on their website that answers customers from their own pages and PDFs, hands the chat to a real person when it cannot answer, and shows how accurate the answers are. The business adds its website or documents, pastes one script tag, and visitors get streamed answers with a source citation on every reply.

What it does

  • Website crawl and PDF uploads, chunked and embedded into MongoDB Atlas Vector Search, with every document scoped to its workspace.
  • Chat widget from one script tag; answers stream in with numbered sources, and the assistant refuses with a fixed sentence when the documents do not cover the question.
  • Real-time human handoff: when the visitor asks for a person or the AI refuses, the team dashboard rings over Socket.io and an agent takes over the same thread.
  • Agent tools with human approval: look up an order, create a ticket or book an appointment, with the result shown to the visitor in the chat.
  • Insights for the owner: answered-by-AI rate, handoffs, latency, cost per answer and the list of questions the documents could not answer.
  • Public evals on a 40-question test set: 87% answer accuracy, 100% cited the right document, 100% correct refusals, under $0.001 per answer.
  • Teams and plans: invite links, owner and agent roles enforced on the server, Free and Pro limits with Stripe Checkout in test mode.
  • 151 automated tests (Vitest and Playwright, including two-browser handoff flows) and GitHub Actions on every push; runs entirely on free tiers.

How it is put together

  1. 1Dashboard and APINext.js 16, TypeScript, SSE streaming, widget host
  2. 2RealtimeNode + Socket.io server for handoff and approvals
  3. 3KnowledgeCrawler, PDF extraction, chunking, Gemini embeddings
  4. 4DataMongoDB Atlas with Vector Search, per-workspace isolation
  5. 5EvalsPer-workspace test sets, LLM judge, CI regression gate
  6. 6BillingStripe Checkout and portal, signature-verified webhook
Next projectSona PunjabTournament platform for pigeon racing clubs