Blu — Behavioral Analytics & Action Platform

Track → Understand → Decide → Act
Blu is a B2B SaaS platform that helps companies turn user behavior into business actions — all in one multi‑tenant system.

---

Warning

This project is not yet production‑ready, but the core infrastructure is taking shape.
Status: Under Active Development

We’re building a complete data‑to‑action pipeline that combines:

• Analytics (mixpanel‑like)
• Feature flags (launchdarkly‑like)
• Actions & integrations (hightouch‑like)

Why you should star this repo → Because this is the only open‑source platform that does all three in one, with a behavioral engine that auto‑enables features based on user activity.

---

🎯 The Goals

For the Product

• Multi‑tenant SaaS – each customer gets isolated data and subdomains
• Event ingestion – SDKs for web, mobile, and backend
• Analytics core – dashboards, funnels, cohorts, and custom reports
• Segmentation engine – dynamic user grouping based on behavior
• Rule engine – customer‑defined logic (if‑this‑then‑that for analytics)
• Action adapters – feature flags, Slack, webhooks, email
• Behavioral auto‑flags – enable features automatically when users hit criteria

For Developers (this project)

• Clean architecture – separation of ingestion, processing, storage, analytics, and actions
• Async‑first – all heavy work goes through JetQueue
• Demo‑mode ready – can run fully on Vercel’s free tier with mock data
• SDK‑first – a stable, versioned SDK for customers
• Open‑source core – MIT license, community‑driven

---

🏗️ Architecture (Work in Progress)

flowchart TB
    subgraph Customers
        A[Customer App]
    end

    subgraph Blu
        A -->|SDK| B[Ingestion API]
        B --> C[JetQueue]
        C --> D[Processing Pipeline]
        D --> E[(Raw Events)]
        D --> F[(Processed Metrics)]
        F --> G[Analytics Layer]
        G --> H[Segmentation Engine]
        H --> I[Rule Engine]
        I --> J[Action Engine]
        J --> K[Feature Flag System]
        J --> L[Slack/Email/Webhooks]
    end

    K --> M[Customer Feature Flags]
    L --> N[Customer Actions]

Loading

---

⚙️ Key features by the live demo

• Multi-tenant architecture (enterprise pattern)
• Real-time analytics dashboard
• Stripe webhook handling
• Performance optimized (SSR/ISR)
• Production logging & monitoring
• Security best practices
• Rate limiting & bot protection
• A/B testing framework

---

🚧 What's going to be implemented

• Dynamic segmentation engine (real‑time based on behavioral criteria)
• Dashboard: charts, funnels, and cohorts
• Rule builder UI (drag‑and‑drop condition editor)
• Action engine: full integration with feature flag system
• Demo mode with seed data for easy testing
• Reverse ETL adapter (future)

---

🛠️ Tech Stack

Area	Technology
Frontend	Next.js 16, React 19, TailwindCSS
Backend	Next.js API Routes, Node.js
Database	MongoDB Atlas (multi‑tenant)
Queue	JetQueue (in‑memory for demo)
Real‑time	Server‑Sent Events (SSE)
Deployment	Vercel (serverless)
Authentication	JWT (stateless)(for demo)
SDK	TypeScript, React hooks, Node.js
Testing	Cypress, Vitest

---

🚀 Getting Started (Local Dev)

# Clone
git clone https://github.com/arxja/blu.git
cd blu

# Install dependencies
pnpm install

# Set up environment
cp .env.example .env.local

# Start MongoDB (or use Atlas)
docker run -d -p 27017:27017 mongo:6

# Seed demo data (optional)
pnpm db:seed

# Run dev server
pnpm dev

Environment variables (.env.local):

# check the central config schema for more info
MONGODB_URI=mongodb://localhost:27017/blu
JWT_SECRET=your_jwt_secret
NEXT_PUBLIC_APP_URL=http://localhost:3000
DEMO_MODE=true

---

📋 Roadmap

Phase	Focus	Estimated
1. Foundation & Core	Ingestion, storage, basic analytics, codebase, SaaS app general features	🚧 In Progress
2. Intelligence	Segmentation, rule engine, behavioral flags	📋 Next
3. Actions	Feature flag integration, Slack, webhooks	📋 Future
4. Scale	Reverse ETL, enterprise features, on‑prem	📋 Future

---

🤝 Contributing

We welcome contributions! Even if you just star the repo – it helps a lot.

Areas where help is most welcome:

• 📊 Dashboard UI/UX
• 🔧 Integration adapters (new actions)
• 🧪 Tests & documentation
• 🌐 Internationalization

See CONTRIBUTING.md for guidelines.

---

📄 License

MIT © Blu Analytics

---

🔗 Links

• Live Demo (coming soon): will be at blu-analytics.vercel.app
• Documentation: docs.blu.dev (in progress)

---

⭐ Why You Should Star This Repo

• Only open‑source platform combining analytics + flags + actions
• Behavioral auto‑flags – a feature not found in any competitor
• Clean, modern architecture – learn from a real‑world SaaS codebase
• Active development – we’re shipping fast and need early adopters