Jet Admin

🚀 Open-Source Analytics Platform & Internal Tools Builder

Connect your data sources · Build powerful queries · Design workflow automations · Visualize with widgets & dashboards

📖 Documentation · 🎯 Live Demo · ⚡ Quick Start · 🤝 Contributing

---

🌟 Overview

Jet Admin is a comprehensive open-source analytics platform that evolved from a PostgreSQL database manager into a full-featured internal tools builder. Empower your team to connect multiple data sources, create reusable queries, build visual workflow automations, and design interactive dashboards with customizable widgets.

💡 What You Can Build

📊 BI Dashboards Real-time KPI monitoring and data visualization

🔄 Data Pipelines Visual workflow builder with conditional logic

🛠️ Admin Tools CRUD interfaces for your databases

📈 Analytics Reports Query-based charts and data tables

---

✨ Key Features

🔌 Multi-Datasource Support

25+ Integrations with extensible connector architecture

💾 Databases	☁️ Cloud Services	🔗 APIs & Messaging
PostgreSQL MySQL MongoDB MS SQL Server SQLite CockroachDB Oracle Redis Neo4j	Google BigQuery Google Sheets Google Analytics Firestore Supabase Airtable Amazon S3 Elasticsearch Kafka	REST API GraphQL Slack Twilio SendGrid Stripe Jira Notion RabbitMQ

📝 Powerful Data Query Engine

🎯 Smart Queries Parameterized queries with dynamic variables SQL & NoSQL native support Real-time testing panel AI-assisted generation

⚡ High Performance Query result caching Optimized execution Batch processing Error handling

🔄 Visual Workflow Builder

Build complex automation pipelines with drag-and-drop simplicity:

┌─────────────────────────────────────────────────────────┐
│  🟢 Start → 🔷 Query → 📜 Script → 🔀 Condition        │
│                                      ├─ True → 🔴 End   │
│                                      └─ False → 🔁 Loop │
└─────────────────────────────────────────────────────────┘

View All Node Types

Node	Description
🟢 Start	Entry point with input argument definitions
🔷 Data Query	Execute any configured data query
📜 JavaScript	Custom JS code execution with full context access
🔀 Condition	Branch logic based on expressions
🔁 Loop	Iterate over arrays with nested execution
⏱️ Delay	Pause execution for specified duration
🔴 End	Terminal node with output mapping

📊 Rich Widget System

Create stunning visualizations connected to your workflows:

📈 Chart Types Bar · Line · Pie · Radar Bubble · Scatter · Polar

📋 Data Displays Tables · Text · Markdown Custom HTML · iFrames

🎨 Features Real-time updates Custom styling · Multi-dataset Auto-refresh · Export

🖥️ Dashboard Builder

• 🎨 Drag-and-drop Layout - Grid-based widget positioning
• 📱 Responsive Design - Adapts to all screen sizes
• 📑 Template System - Clone and reuse dashboards
• 🖨️ Export to PDF - Generate professional reports

👥 Enterprise-Ready Multi-Tenancy

🔒 Security Complete tenant isolation Role-based access control (RBAC) API key authentication Audit logging

👤 User Management Invite team members Granular permissions SSO support Activity tracking

🎁 Additional Capabilities

⏰ Cron Jobs - Schedule recurring workflows 📋 Table Manager - Direct CRUD operations 🔔 Real-time Notifications - WebSocket updates 🤖 AI Chat Assistant - Query generation helper

🎣 Database Triggers - React to database events 📊 Data Transformations - ETL pipelines 🔍 Search & Filter - Advanced data exploration 📤 Import/Export - Data migration tools

---

🏗️ Architecture

graph TB
    subgraph Frontend["🎨 Frontend (React)"]
        DB[Dashboard Builder]
        WE[Workflow Editor]
        WC[Widget Config]
        QE[Query Editor]
    end
    
    subgraph Backend["⚙️ Backend (Node.js)"]
        API[REST API / WebSocket]
        MS[Module System]
        WEE[Workflow Execution Engine]
    end
    
    subgraph Data["💾 Data Layer"]
        P[Prisma ORM]
        DC[Datasource Connectors]
    end
    
    Frontend --> API
    API --> MS
    MS --> WEE
    WEE --> P
    WEE --> DC

Loading

Tech Stack Details

Layer	Technology
Frontend	React 18 · Vite · TailwindCSS · React Query · React Flow
Backend	Node.js · Express.js · Socket.IO
ORM	Prisma
Authentication	Firebase Auth
Message Queue	RabbitMQ
Containerization	Docker · Docker Compose

---

🚀 Quick Start

Prerequisites

✅ Node.js 18+ ✅ PostgreSQL 14+ ✅ Docker & Docker Compose

✅ Firebase project ✅ Git ✅ 4GB+ RAM recommended

🐳 Option 1: Docker Deployment (Recommended)

# Clone the repository
git clone https://github.com/Jet-labs/jet-admin.git
cd jet-admin

# Configure environment
cp .env.docker.example .env.docker
# Edit .env.docker with your configuration

# Start all services
docker-compose -f docker-compose.cloud.yml up -d

🎉 Access the application at http://localhost:3000

🛠️ Option 2: Manual Setup

Backend Setup

cd apps/backend

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your database and Firebase credentials

# Run database migrations
npx prisma migrate dev

# Seed initial data (optional)
npm run seed

# Start the backend
npm run dev

Frontend Setup

cd apps/frontend

# Install dependencies
npm install

# Configure environment
cp public/config.example.js public/config.js
# Edit config.js with your API endpoint

# Start the frontend
npm run dev

Environment Configuration

Backend (.env)

DATABASE_URL=postgresql://user:password@localhost:5432/jetadmin
FIREBASE_PROJECT_ID=your-firebase-project
FIREBASE_PRIVATE_KEY=your-private-key
FIREBASE_CLIENT_EMAIL=your-client-email
RABBITMQ_URL=amqp://localhost:5672
JWT_SECRET=your-jwt-secret

Frontend (public/config.js)

window.JET_CONFIG = {
  API_URL: 'http://localhost:4000',
  FIREBASE_CONFIG: {
    apiKey: 'your-api-key',
    authDomain: 'your-project.firebaseapp.com',
    projectId: 'your-project-id'
  }
};

---

📁 Project Structure

jet-admin/
├── 📱 apps/
│   ├── backend/                 # Node.js Express API
│   │   ├── config/              # App configurations
│   │   ├── modules/             # Feature modules
│   │   │   ├── datasource/      # Data source management
│   │   │   ├── dataQuery/       # Query engine
│   │   │   ├── workflow/        # Workflow execution engine
│   │   │   ├── widget/          # Widget management
│   │   │   └── dashboard/       # Dashboard management
│   │   ├── prisma/              # Database schema & migrations
│   │   └── utils/               # Shared utilities
│   │
│   └── frontend/                # React SPA
│       ├── src/
│       │   ├── data/            # API clients & models
│       │   ├── logic/           # Contexts & hooks
│       │   └── presentation/    # UI components & pages
│       └── public/              # Static assets
│
├── 📦 packages/                 # Shared packages (monorepo)
│   ├── datasource-types/        # Datasource form configs
│   ├── datasources-logic/       # Datasource connectors
│   ├── widgets/                 # Widget implementations
│   └── workflow-nodes/          # Workflow node components
│
├── 📚 docs/                     # Docusaurus documentation
├── 🐳 docker-compose.cloud.yml  # Docker deployment
└── 📄 Dockerfile.*              # Container definitions

---

📚 Documentation

📖 Full Documentation →

🎯 Getting Started	🏛️ Architecture	✨ Features
Introduction Docker Deployment Backend Setup Frontend Setup	Backend Architecture Frontend Architecture Database Schema Data Flow	Datasources Data Queries Workflows Widgets & Charts Dashboards

---

🤝 Contributing

We ❤️ contributions from the community!

How to Contribute

1. 🍴 Fork the repository
2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
3. 💾 Commit your changes (git commit -m 'Add amazing feature')
4. 📤 Push to the branch (git push origin feature/amazing-feature)
5. 🎉 Open a Pull Request

🎯 Areas We Need Help

🔌 New Connectors Add support for more databases and APIs 📊 Widget Types Create new visualization components

🔄 Workflow Nodes Implement additional automation nodes 📖 Documentation Improve guides and examples

Check out our Contributing Guide for detailed information.

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

Built with amazing open-source technologies:

---

⭐ Star this repo if you find it useful!

🐛 Report Bug · 💡 Request Feature · 💬 Join Discussions

---

Made with ❤️ by the Jet Labs Team