Skip to main content

What is Hive?

Hive is a modern project management platform designed to help teams organize projects, track tasks, and collaborate effectively. Built with a JavaScript frontend and powered by Supabase for real-time synchronization, Hive brings your team’s work together in one intuitive interface.
Hive leverages real-time updates so changes made by one team member are instantly visible to everyone else—no refresh required.

Who is Hive For?

Hive is ideal for:
  • Small to medium-sized teams looking for lightweight project management
  • Development teams that need real-time task tracking and collaboration
  • Organizations wanting to self-host their project management tools
  • Teams that value simplicity and speed over complex enterprise features

Key Capabilities

Hive provides everything you need to manage team projects efficiently:

Project Management

Create and organize projects with custom colors, dates, and milestones. Track progress across multiple projects simultaneously.

Task Tracking

Create tasks with titles, descriptions, due dates, priorities, and assignees. Drag and drop tasks between projects and statuses.

Real-time Collaboration

All changes sync instantly across all connected clients. See who’s working on what in real-time with presence indicators.

Team Management

Manage team members with profiles, contact information, and presence status. Track workload and task assignments.

Dashboard Analytics

Visualize project progress with charts and metrics. Monitor task completion rates and team workload distribution.

Calendar View

View all tasks and deadlines in a calendar interface. Plan ahead and avoid scheduling conflicts.

System Architecture

Hive follows a modern, serverless architecture:

Frontend Layer

The frontend is built with vanilla JavaScript and TailwindCSS:
  • app.js - Core application logic, UI rendering, and state management
  • supabaseClient.js - Database client initialization and configuration
  • authSession.js - Authentication session management
  • app.realtime.js - Real-time event handlers and synchronization
// Global state management
let currentUser = JSON.parse(localStorage.getItem('user')) || null;
let tasks = [];
let employees = [];
let projects = [];
let tags = [];

// Supabase singleton
let supabase = null;
if (window.__supabaseClient) {
  supabase = window.__supabaseClient;
} else if (window.supabase && window.supabase.createClient) {
  supabase = window.supabase.createClient(
    window.SUPABASE_URL,
    window.SUPABASE_ANON_KEY
  );
  window.__supabaseClient = supabase;
}

Backend Layer

The backend uses Supabase (open-source Firebase alternative):
  • PostgreSQL Database - Core data storage (users, projects, tasks, tags)
  • Supabase Auth - JWT-based authentication and authorization
  • Realtime - WebSocket subscriptions for live updates
  • Row Level Security - Database-level access control
Supabase provides a powerful REST API and realtime subscriptions out of the box, eliminating the need to write custom backend code.

Realtime Synchronization

Hive uses Supabase Realtime to synchronize changes across all connected clients:
app.realtime.js (Channel Setup)
function wireRealtimeForTasks() {
  const client = window.__supabaseClient;
  
  // Global task changes channel
  const ch = client.channel('rt-pmh-tareas-global');
  
  ch.on('postgres_changes', { 
    event: '*', 
    schema: 'public', 
    table: 'tareas' 
  }, async (payload) => {
    const eventType = payload?.eventType;
    const taskId = payload?.new?.id || payload?.old?.id;
    
    if (eventType === 'INSERT') {
      await addTaskToUI(payload.new);
    } else if (eventType === 'UPDATE') {
      await updateTaskInUI(payload.new);
    } else if (eventType === 'DELETE') {
      await removeTaskFromUI(taskId);
    }
  });
  
  ch.subscribe();
}

Core Use Cases

1. Project Planning

Create projects with start/end dates, assign team members, and break work into tasks. Track progress with visual indicators and analytics.

2. Task Management

Organize tasks by project, priority, and status. Assign multiple team members to tasks and track completion percentages.

3. Team Coordination

See who’s online, what they’re working on, and collaborate in real-time without constant meetings or status updates.

4. Progress Tracking

Monitor project health with dashboards showing task completion rates, workload distribution, and upcoming deadlines.

Technology Stack

Frontend

  • Vanilla JavaScript (ES6+)
  • TailwindCSS
  • Chart.js for visualizations
  • jQuery for DOM manipulation

Backend

  • Supabase (PostgreSQL + Auth + Realtime)
  • Row Level Security (RLS)
  • Vercel Serverless Functions

Deployment

  • Vercel (recommended)
  • Static file hosting
  • Edge functions for API routes

Development

  • Git version control
  • NPM package management
  • Modern browser targets

Next Steps

Ready to get started with Hive?

Quickstart Guide

Follow our step-by-step guide to create your first project and task

Installation Guide

Deploy Hive on your own infrastructure with Supabase and Vercel

Explore Features

Learn about all the features Hive has to offer

API Reference

Integrate Hive with your existing tools and workflows

Build docs developers (and LLMs) love