Overview

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.

Repository Architecture

• 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

1. Clone the repository: git clone https://github.com/adi6206096675/vex.git
2. Navigate to the project directory: cd vex
3. Install root dependencies: npm install
4. Configure environment variables: Set up your .env files in both root and server directories with your database URLs, Redis connection string, and proxy configurations.
5. Launch via Docker Compose: docker-compose up --build

License

Distributed under the Apache-2.0 License. See the LICENSE file for more information.