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.

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

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/

• 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.

ManageHub uses a modern full-stack technology stack:

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.

These instructions help you run the project locally for development or testing.

Make sure you have the following installed:

• Node.js ≥ 18.x
• npm or yarn
• PostgreSQL database
• Rust toolchain (required to build and test the contracts/ workspace)

1. Clone the repository

git clone https://github.com/DistinctCodes/ManageHub.git
cd ManageHub

2. Install dependencies

# frontend
cd frontend
npm install

# backend
cd ../backend
npm install

Copy the example environment variables and configure them:

cp .env.example .env

Update variables such as:

• DATABASE_URL — PostgreSQL connection string
• JWT_SECRET / other secrets
• Any API keys for external services

Run backend:

cd backend
npm run start:dev

Run frontend:

cd frontend
npm run dev

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

ManageHub/
├── backend/            # NestJS backend API
├── frontend/           # Next.js client application
├── contracts/          # Rust & Soroban smart contracts workspace
├── .github/            # CI/CD workflows
├── README.md           # Project readme (this file)

• backend/ — Contains controllers, services, modules, database logic.
• frontend/ — UI components, pages, API integrations.
• contracts/ — Soroban smart contract workspace (Rust). Currently contains the payment_escrow scaffold. See contracts/README.md for the backend integration reference and contracts/RUNBOOK.md for the operator recovery guide.

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.

Thanks to all contributors and maintainers on this project — there are 96+ contributors helping shape this repository.