MongoMan

A modern, web-based MongoDB admin interface built with Next.js, shadcn/ui, and Tailwind CSS. MongoMan provides an intuitive way to manage your MongoDB databases, collections, and documents with a clean and responsive UI.

⚠️ Note: This project is currently under active development. Some features may be missing or partially implemented. Bug reports, feature requests, and contributions are warmly welcomed! Please feel free to open issues or submit pull requests.

🤖 AI-Powered Development: The initial version of MongoMan is primarily developed through conversations with Anthropic's Claude AI (3.5 Sonnet), with minimal manual coding from my side, just quick code reviews and partial improvements. While this essentially shows the potential of "AI-assisted" development, I am now actively maintaining and improving the codebase myself as the project scope has grown.

Features

• 🎨 Modern UI
• 📊 Database statistics and monitoring
• 📝 Collection management
• 📄 Document management

Environment Variables

To run this project, you will need to add the following environment variable:

MONGODB_URI - Your MongoDB connection string (e.g., mongodb://localhost:27017)

Run Locally

Clone the project

git clone [email protected]:AienTech/mongoman.git

Go to the project directory

cd mongoman

Install dependencies

yarn install

Set up your environment variables

cp .env.example .env.local

Then edit .env.local with your MongoDB connection string.

Start the development server

yarn dev

Docker Installation

Run with docker-compose:

version: '3'
services:
  mongoman:
    image: ghcr.io/aientech/mongoman:main
    environment:
      - MONGODB_URI=mongodb://mongo:27017
    ports:
      - "3000:3000"

Or run directly with Docker:

docker run -p 3000:3000 -e MONGODB_URI=mongodb://mongo:27017 ghcr.io/aientech/mongoman:main

Building from Source

Build the Docker image:

docker build --build-arg MONGODB_URI=mongodb://temporary:27017 -t mongoman .

Tech Stack

• Next.js 15
• React
• TypeScript
• shadcn/ui
• Tailwind CSS
• TanStack Table
• MongoDB Node.js Driver

Contributing

Contributions are always welcome! Here's how you can help:

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

MIT

Acknowledgements

• shadcn/ui for the beautiful UI components
• Next.js for the amazing framework
• MongoDB for the database platform

Authors

• @aientech

Support

For support, please open an issue in the GitHub repository or contact the maintainers.

Roadmap

• Add authentication and authorization
• Support for MongoDB Atlas integration
• Advanced query builder
• Database backup and restore functionality
• Collection and document import/export
• Aggregation pipeline builder
• Light/dark mode support

Screenshots

Coming soon...

Related

Here are some related projects:

• Mongo Express
• MongoDB Compass