Vex is a production-grade, autonomous marketing pipeline designed to automate multi-platform content distribution, campaign scheduling, and social media syndication. Built with a resilient micro-architecture, it features the Shadow Engine—an advanced stealth browser automation subsystem powered by Playwright and BullMQ to handle secure credential vaults, proxy routing, and direct platform publishing without exposing sensitive data.
vex/
├── vex-client/ # Frontend dashboard and campaign control center
├── vex-server/ # Backend core, database models, queues, and automation workers
├── docker-compose.yml # Container orchestration configuration
├── package.json # Root workspace manifest
└── .gitignore # Global exclusion rules for secrets and build artifacts
Core Features
🛡️ Shadow Engine Stealth Automation: Bypasses modern bot detection mechanisms (Cloudflare, Datadome) using playwright-extra and stealth plugins.
⚡ Reliable Distributed Queuing: Powered by BullMQ and Redis with persistent connection handling, backoff logic, and concurrency controls.
🔐 AES-256-GCM Secure Credential Vault: Safely stores and decrypts platform tokens dynamically during runtime execution.
🌍 Edge Network Geolocation Routing: Supports regional proxy endpoints, timezone synchronization, and locale fingerprinting.
🐦 Automated Social Gateway Integration: Features strict content length governance (automated 275-character safety limits for free tiers), modal-clearing error handlers, and visual proof screenshot verification.
🛠️ Tech Stack
Languages: TypeScript, JavaScript, CSS
Backend & Workers: Node.js, BullMQ, IORedis, Prisma ORM
Automation: Playwright, Puppeteer Extra Plugin Stealth
Database: PostgreSQL / Supabase
DevOps & Deployment: Docker, Docker Compose, GitHub Actions
🚀 Getting Started
Prerequisites
Node.js (v18+ recommended)
Docker & Docker Compose
A running Redis instance
Installation & Local Setup
Clone the repository:
Bash
git clone [https://github.com/adi6206096675/vex.git](https://github.com/adi6206096675/vex.git)
cd vex
Install root dependencies:
Bash
npm install
Configure environment variables:
Set up your .env files in both root and server directories with your database URLs, Redis connection string, and proxy configurations.
Launch via Docker Compose:
Bash
docker-compose up --build
📜 License
Distributed under the Apache-2.0 License. See the LICENSE file for more information.