How forgemind-git/forgegrowth-oss works
Forge Growth is a self-hosted WhatsApp-centered CRM that connects Meta ad referrals to conversations, leads, funnel stages, and attributed payments. The principal flow is inbound WhatsApp webhook processing, lead and click-referral capture, automation or agent response, sales-stage tracking, and payment reconciliation. The frontend provides workspace views through an API client; backend routes, engines, services, queues, and integrations implement the domain behavior. Several capabilities are README-documented but their implementation was not sampled, so those links are documented relationships rather than inferred calls.
Main entry points: webhook.js WhatsApp webhook · agentEngine.js Agent engine · leads.js Lead management · api.js API client
Components 23
User experience
- Workspace shell
frontend/src/App.jsx - API client
frontend/src/api.js - Lead pipeline view
frontend/src/pages/sales/PipelinePage.jsx - Campaign workspace
frontend/src/pages/marketing/CampaignsPage.jsx
Messaging and automation
- WhatsApp webhook
backend/src/routes/webhook.js - Automation engine
backend/src/engine/automationEngine.js - Agent engine
backend/src/engine/agentEngine.js - Agent queue
backend/src/queue/agentQueue.js - Send queue
backend/src/queue/sendQueue.js - Message sender
backend/src/services/messageSender.js
Growth and sales
- Lead management
backend/src/routes/leads.js - Click referrals
backend/src/routes/ctwa.js - Funnel configuration
backend/src/services/funnelConfig.js - Campaign analytics
backend/src/routes/marketing.js - Payment requests
backend/src/routes/paymentRequests.js
Backend platform
- Postgres data
backend/src/db.js - Live event bus
backend/src/events.js - Media library
backend/src/routes/mediaLibrary.js - Media object store
backend/src/util/minioClient.js
Other components
- Operator
- WhatsApp platform
- Razorpay
- Meta Marketing API
Connections 25
- Operator → Workspace shell: uses
frontend/src/App.jsx - Workspace shell → API client: requests
frontend/src/App.jsx - Lead pipeline view → API client: loads leads
frontend/src/pages/sales/PipelinePage.jsx - Campaign workspace → API client: loads campaigns
- API client → Lead management: HTTP requests
- WhatsApp platform → WhatsApp webhook: sends events
- WhatsApp webhook → Automation engine: dispatches
backend/src/routes/webhook.js - WhatsApp webhook → Agent engine: routes agents
backend/src/routes/webhook.js - WhatsApp webhook → Click referrals: records referral
backend/src/routes/webhook.js - WhatsApp webhook → Lead management: resolves leads
backend/src/routes/webhook.js - Agent queue → Agent engine: runs
- Agent engine → Send queue: enqueues replies
backend/src/engine/agentEngine.js - Automation engine → Send queue: enqueues messages
backend/src/engine/automationEngine.js - Send queue → Message sender: delegates sends
backend/src/queue/sendQueue.js - Message sender → WhatsApp platform: sends messages
- Lead management → Funnel configuration: uses funnel rules
backend/src/routes/leads.js - Lead management → Live event bus: emits updates
backend/src/routes/leads.js - Campaign analytics → Meta Marketing API: fetches spend
README.md - Campaign analytics → Click referrals: joins click attribution
README.md - Payment requests → Razorpay: creates payment links
README.md - Razorpay → Payment requests: reports payments
README.md - Automation engine → Postgres data: reads and writes
backend/src/engine/automationEngine.js - Agent engine → Postgres data: reads and writes
backend/src/engine/agentEngine.js - WhatsApp webhook → Postgres data: stores events
backend/src/routes/webhook.js - Media library → Media object store: stores media
backend/src/routes/mediaLibrary.js