Hive Overview

Hive framework structure and conventions. Apply when working with this codebase.

diegosouzapw Updated 54 repo stars

File contents

Hive Framework Overview

Hive is a Koa-based Node.js framework with MongoDB, Zod validation, and auto-sync for embedded documents.

Directory Structure

Directory Purpose Edit?
/.hive/ Framework core No - read only
/src/ Application code Yes

Resources

A resource is a feature module in /src/resources/{name}/:

src/resources/{name}/
├── {name}.schema.js      # Required: DB schema
├── endpoints/            # API routes
├── handlers/             # Event listeners
└── methods/              # Reusable functions

Built-in (in .hive/)

  • tokens - Auth token storage
  • users - Base user schema
  • db - Database layer with services

Key Imports

import db from 'db';                    // Database
import config from 'app-config';        // Config
import { z } from 'zod';                // Validation

Services Access

const taskService = db.services.tasks;  // Auto-created from schema

diegosouzapw/awesome-omni-skill/tree/main/skills/development/hive-overview commit 963635136c

Frequently asked questions

npx skillmds@latest add diegosouzapw/hive-overview