https://github.com/distinctcodes/managehub
ManageHub is a comprehensive management system for tech hubs, designed to streamline user and workspace management. It features biometric authentication for staff and users to clock in and out efficiently, enhancing security and operational oversight.
https://github.com/distinctcodes/managehub
nestjs nextjs postgresql stellar typescript
Last synced: 3 months ago
JSON representation
ManageHub is a comprehensive management system for tech hubs, designed to streamline user and workspace management. It features biometric authentication for staff and users to clock in and out efficiently, enhancing security and operational oversight.
- Host: GitHub
- URL: https://github.com/distinctcodes/managehub
- Owner: DistinctCodes
- Created: 2025-03-04T08:26:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-04T09:51:07.000Z (over 1 year ago)
- Last Synced: 2025-03-04T10:35:44.682Z (over 1 year ago)
- Topics: nestjs, nextjs, postgresql, stellar, typescript
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# **ManageHub**
**A Comprehensive Coworking and Workspace Management System**
ManageHub is a full-stack platform designed to streamline **coworking and workspace management** for hubs, coworking spaces and workspaces. It includes features like **biometric clock-in/clock-out functionality**, enhancing operational efficiency, security, and administrative oversight. The backend is structured for real-world usage and the frontend is designed for intuitive interaction.
---
## Table of Contents
1. **About**
2. **Features**
3. **Tech Stack**
4. **Getting Started**
- Prerequisites
- Installation
- Environment Variables
5. **Usage**
6. **Project Structure**
7. **Contributing**
8. **Roadmap**
9. **License**
10. **Acknowledgements**
---
## About
ManageHub is structured to handle everyday operational needs of tech hubs, from managing members to tracking workspace usage and attendance using biometric authentication. The platform is modular, scalable, and designed with real-world enterprise needs in mind.
Live Demo: [https://managehub.vercel.app/](https://managehub.vercel.app/)
---
## Key Features
- **Biometric Authentication** — Supports biometric clock-ins/outs for users and staff.
- **User & Role Management** — Manage accounts, roles, and permissions.
- **Workspace Tracking** — Monitor usage of workspaces, seats, and resources.
- **Analytics & Logs** — View attendance and activity logs.
- **Team Collaboration** — Support for teams with admin roles.
- **Modular Architecture** — Easy to extend or customize for future needs.
---
## Tech Stack
ManageHub uses a modern full-stack technology stack:
| Layer | Technology | |
| ---------------------- | ---------------------------------------------- | --- |
| Frontend | **Next.js**, React, Tailwind CSS | |
| Backend | **NestJS**, Node.js | |
| Database | **PostgreSQL** | |
| Blockchain / Contracts | Rust, Stellar | |
| Deployment | Vercel 🚀 (Frontend & possibly Serverless API) | |
> Side note: Using NestJS for API and backend services alongside Next.js for the frontend is a powerful combination for maintainable, scalable projects, especially when complex business logic or multi-client access is needed — something Next.js alone doesn’t fully optimize for in large systems.
---
## Getting Started
These instructions help you run the project locally for development or testing.
### Prerequisites
Make sure you have the following installed:
- Node.js ≥ 18.x
- npm or yarn
- PostgreSQL database
- Rust toolchain (if building or interacting with _contracts_)
---
### Installation
1. **Clone the repository**
```bash
git clone https://github.com/DistinctCodes/ManageHub.git
cd ManageHub
```
2. **Install dependencies**
```bash
# frontend
cd frontend
npm install
# backend
cd ../backend
npm install
```
---
### Environment Variables
Copy the example environment variables and configure them:
```bash
cp .env.example .env
```
Update variables such as:
- `DATABASE_URL` — PostgreSQL connection string
- `JWT_SECRET` / other secrets
- Any API keys for external services
---
## Usage
**Run backend:**
```bash
cd backend
npm run start:dev
```
**Run frontend:**
```bash
cd frontend
npm run dev
```
Open `http://localhost:3000` in your browser.
---
## Project Structure
```plaintext
ManageHub/
├── backend/ # NestJS backend API
├── frontend/ # Next.js client application
├── contracts/ # Rust & Stellar contract modules (wasm, etc.)
├── .github/ # CI/CD workflows
├── README.md # Project readme (this file)
```
- **backend/** — Contains controllers, services, modules, database logic.
- **frontend/** — UI components, pages, API integrations.
- **contracts/** — Smart contract or blockchain/logic modules (Rust).
---
## Contributing
We love contributions! Whether it’s documentation, bug fixes, new features, or tests — your help is appreciated.
1. Fork the repository
2. Create a new branch (`git checkout -b feature/YourFeature`)
3. Commit your changes
4. Push and open a pull request
Please follow the existing code style and architecture when contributing.
---
## Acknowledgements
Thanks to all contributors and maintainers on this project — there are **96+ contributors** helping shape this repository.