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.



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
- 1Dashboard and APINext.js 16, TypeScript, SSE streaming, widget host
- 2RealtimeNode + Socket.io server for handoff and approvals
- 3KnowledgeCrawler, PDF extraction, chunking, Gemini embeddings
- 4DataMongoDB Atlas with Vector Search, per-workspace isolation
- 5EvalsPer-workspace test sets, LLM judge, CI regression gate
- 6BillingStripe Checkout and portal, signature-verified webhook