ScaleForge

ScaleForge is a high-performance B2B sales automation and CRM platform. It provides a centralized dashboard for managing leads, orchestrating automated outreach via a decoupled bot architecture, and maintaining persistent state using Upstash Redis.

🚀 Key Features

• Decoupled Bot Automation: Internal automation system supporting Gmail (App Password and OAuth2) for high-deliverability outreach. Fully Dockerized for easy deployment.
• High-Performance Lead Ingestion: Advanced lead orchestration supporting massive CSV/Excel files (50k+ rows) via client-side batch parsing, bypassing serverless function constraints.
• Real-Time Analytics: Live monitoring of lead ingestion rates (leads/minute) and continuous bot system load visualization directly on the dashboard.
• Admin Control Center: Global configuration for bot credentials, webhooks, and team management.
• Atomic UI: Clean, professional, white-labeled B2B dashboard built with modular Atomic Design principles and Tailwind CSS (React 19).
• Serverless-Ready Architecture: Optimized for speed, scalability, and deployment.

🏗️ Architecture

ScaleForge is architected as a decoupled system for maximum scalability:

1. Frontend (/frontend):

   • Stack: React 19, Vite, TypeScript, Tailwind CSS, Zustand, React Query.
   • Concepts: Atomic Design, Feature-based modularity, Protected routing.

2. Backend (/backend):

   • Stack: Node.js, Express, TypeScript, Upstash Redis.
   • Logic: RESTful API endpoints for lead orchestration, bot management, and secure credential storage.

3. Automation Bot:

   • Type: Decoupled worker (TypeScript based).
   • Capabilities: Gmail integration, queue management, and real-time status reporting.
   • Bot Source Code Available at https://github.com/Asadullah-shz/scaleforge-bot.git

🛠️ Quick Start

1. Prerequisites

• Node.js (v18+)
• An active Upstash Redis instance (for serverless persistence)

2. Environment Setup

Create a .env file in the /backend directory:

PORT=5000
JWT_SECRET=your_jwt_secret
UPSTASH_REDIS_REST_URL=your_redis_url
UPSTASH_REDIS_REST_TOKEN=your_redis_token

3. Installation & Launch

# Install and run Backend
cd backend && npm install && npm run dev

# Install and run Frontend
cd ../frontend && npm install && npm run dev

The application will be available at http://localhost:5173.

🌐 Deployment

ScaleForge is optimized for Vercel.

• Connect the root directory to Vercel.
• Configure separate project settings for the /frontend and /backend and set the required environment variables.
• The system automatically handles edge function execution for backend logic.

---

⚖️ License & Copyright

© 2026 PseudoSoft. All Rights Reserved.

This software and its associated industrial-level data structures are the exclusive property of PseudoSoft. Unauthorized redistribution, reselling, or misuse of this codebase is strictly prohibited.