Skip to content

rexmirak/leadforge

Repository files navigation

rexlead

rexlead is a lead intake and qualification system built around a real client acquisition workflow.

It started as a practical way to improve my own inbound process for AI systems, workflow automation, and software engineering work. The project grew into a full stack exercise in CRM integration, workflow orchestration, structured LLM output, and production deployment.

What it does

rexlead captures project briefs from a public site, enriches and scores them, routes them through an orchestration layer, syncs the result into HubSpot, and sends a branded first reply for qualified leads.

Architecture

The system is split across five layers.

  1. A Next.js application serves the public site, protected admin views, and internal workflow endpoints.
  2. Supabase handles authentication, persistence, audit records, and workflow state.
  3. Ollama Cloud provides structured lead analysis with a bounded tool calling loop.
  4. n8n coordinates intake, analysis, routing, replay, and scheduled digest execution.
  5. HubSpot acts as the CRM layer for contacts, companies, deals, tasks, and notes.

Stack

  • Next.js 16
  • TypeScript
  • Supabase
  • Ollama Cloud
  • n8n
  • HubSpot
  • Nodemailer and Resend
  • Vercel

Core workflow

  1. A visitor submits a project brief.
  2. The application validates and stores the lead.
  3. n8n dispatches analysis and routing.
  4. The analysis layer produces structured signals and a reply draft.
  5. The routing layer updates HubSpot and logs delivery state.
  6. The admin surface remains available for monitoring, resend actions, and visibility into workflow traces.

Running locally

npm install
npm run dev

Open http://localhost:3000.

Verification

npm run preflight:ollama
npm run lint
npm run typecheck
npm test
npx next build --webpack

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors