KaBankz/hive

🐝 Hive

Construction Reporting Redefined

Features • Getting Started

Overview

Hive revolutionizes construction reporting by transforming time-consuming documentation into a streamlined, efficient process. Built for construction teams, Hive helps you create professional reports in minutes with an intuitive drag-and-drop interface and smart automation features.

Features

• ✨ Hivemind AI - Your AI assistant for construction reporting
• 🎯 Drag & Drop Editor - Effortlessly reorganize report sections
• 📑 PDF Export - Generate professional reports with one click
• ⚙️ Smart Section Controls - Show/hide report sections instantly

Project Structure

hive/
├── api/ # Flask API for Hivemind Chatbot
├── src/ # NextJS frontend
├── .env.local.example # Environment variables

Prerequisites

• Node.js
• Bun
• Python
• uv

Tip

Use mise to automatically install and manage the prerequisites in a single command 🚀

mise install

Getting Started

1. Install node dependencies:

   bun install

2. Install python dependencies:

   uv sync

3. Add your own values to the .env.local file:

   cp .env.local.example .env.local

4. Run the python API server:

   python -m api.app

5. Run the nextjs development server (in a different terminal):

   bun dev

6. Open http://localhost:3000 in your browser