ControlHub - Modern Admin Management System

A modern, full-stack admin panel and management system built with React, TypeScript, and Node.js. This monorepo contains a complete admin dashboard solution with advanced analytics, user management, and real-time features.

🚀 Features

• Modern UI/UX: Built with Radix UI, Tailwind CSS, and modern React patterns
• Type Safety: Full TypeScript support across the entire stack
• Real-time Updates: WebSocket integration for live data updates
• Advanced Analytics: Comprehensive dashboard with charts and metrics
• User Management: Complete user authentication and authorization system
• Database Integration: Prisma ORM with PostgreSQL support
• API Documentation: Auto-generated Swagger documentation
• Internationalization: Multi-language support with i18next
• Form Validation: Robust form handling with React Hook Form and Zod

🏗️ Architecture

This is a monorepo built with Turborepo containing:

Apps

• @controlhub/web: React frontend application
• @controlhub/api: Node.js/Express backend API

Packages

• @controlhub/eden: Type-safe API client
• @controlhub/db: Database schema and client
• @controlhub/tsconfig: Shared TypeScript configuration

🛠️ Tech Stack

Frontend

• React 19
• TypeScript
• Tailwind CSS
• Radix UI
• TanStack Query
• TanStack Router
• React Hook Form
• Zod validation

Backend

• Node.js
• Elysia.js
• Prisma ORM
• PostgreSQL
• Redis
• JWT Authentication

Development

• Turborepo
• Bun package manager
• Biome for linting/formatting
• Husky for git hooks

📦 Installation

1. Clone the repository

   git clone <your-repo-url>
   cd controlhub

2. Install dependencies

   bun install

3. Set up environment variables

   cp config/apps/web/.env.example config/apps/web/.env
   cp config/apps/api/.env.example config/apps/api/.env

4. Start the database

   bun run db:start

5. Run database migrations

   bun run db:migrate

🚀 Development

Start all services

bun run dev

Start specific services

# Frontend only
bun run dev:web

# Backend only
bun run dev:api

Build for production

bun run build

📁 Project Structure

controlhub/
├── apps/
│   ├── web/          # React frontend
│   └── api/          # Node.js backend
├── packages/
│   ├── eden/         # Type-safe API client
│   ├── database/     # Database schema & client
│   └── tooling-config/ # Shared configs
├── config/           # Environment configurations
└── patches/          # Package patches

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests and linting
5. Submit a pull request

📄 License

This project is licensed under the MIT License.