☁️ CloudDB

Modern Database Management Platform

Monitor, analyze, and manage all your databases from one unified platform with real-time insights and enterprise-grade security.

📋 Table of Contents

Features
Tech Stack
Screenshots
Getting Started
Environment Variables
Project Structure
Database Support
Pricing Tiers
Contributing
License
Support

✨ Features

🎯 Core Features

Real-Time Health Monitoring - Track database performance, uptime, and resource utilization with live updates
Advanced Analytics Dashboard - Deep insights into query performance with interactive visualizations
Multi-Database Support - Works seamlessly with MongoDB, PostgreSQL, MySQL, Redis, and more
Table Explorer - Browse, query, and manage your data with an intuitive interface
Security Shield - Enterprise-grade security with encryption and access controls
Live Metrics - Real-time visualization of database metrics and performance

🏢 Enterprise Features

Team Management - Advanced role-based access control and permissions
API Access - Full programmatic control via REST API
SOC 2 Compliance - Enterprise security standards
Global Infrastructure - Deploy across 30+ regions worldwide
Custom SLA - Dedicated support and custom service level agreements
SSO Integration - Single sign-on with enterprise identity providers

💎 Additional Features

Beautiful UI/UX - Modern, responsive design with glass-morphism effects
Dark Mode - Eye-friendly dark theme throughout the application
Responsive Design - Works perfectly on desktop, tablet, and mobile devices
Real-time Updates - Live data refresh without page reloads
Comprehensive Settings - Complete control over your account and databases
Audit Logs - Track all database operations and changes

🛠 Tech Stack

Frontend

Next.js 16.1.6 - React framework with App Router
React 19.2.3 - UI library
TypeScript 5 - Type-safe development
Tailwind CSS 4 - Utility-first styling
Framer Motion - Smooth animations
Recharts - Data visualizations
Lucide Icons - Beautiful icon set

Backend & Database

MongoDB - Primary database with Mongoose ODM
PostgreSQL - Relational database support (via pg)
MySQL - MySQL database support (via mysql2)
Redis - Caching and real-time features (via ioredis)

Authentication & Authorization

Clerk - Complete user authentication and management

UI Components

Radix UI - Accessible component primitives
clsx - Conditional className utility
tailwind-merge - Merge Tailwind classes

📸 Screenshots

Note: Add your screenshots here after deployment

### Landing Page
![Landing Page](./screenshots/landing.png)

### Dashboard
![Dashboard](./screenshots/dashboard.png)

### Database Health Monitoring
![Health Monitoring](./screenshots/health.png)

### Analytics
![Analytics](./screenshots/analytics.png)

### Table Explorer
![Table Explorer](./screenshots/explorer.png)

### Settings
![Settings](./screenshots/settings.png)

🚀 Getting Started

Prerequisites

Node.js 18.x or higher
npm or yarn or pnpm
MongoDB instance (local or cloud)
Clerk account for authentication

Installation

Clone the repository

git clone https://github.com/yourusername/clouddb.git
cd clouddb

Install dependencies

npm install
# or
yarn install
# or
pnpm install

Set up environment variables

Create a .env.local file in the root directory (see Environment Variables section)
Run the development server
```
npm run dev
# or
yarn dev
# or
pnpm dev
```
Open your browser

Navigate to http://localhost:3000

Build for Production

npm run build
npm run start

🔐 Environment Variables

Create a .env.local file in the root directory with the following variables:

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/dashboard
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/dashboard

# MongoDB (for storing application data)
MONGODB_URI=mongodb://localhost:27017/clouddb
# or for MongoDB Atlas:
# MONGODB_URI=mongodb+srv://username:password@cluster.mongodb.net/clouddb

# Optional: For production deployments
NODE_ENV=development

Getting Clerk Keys

Sign up at Clerk.com
Create a new application
Copy the API keys from the dashboard
Paste them into your .env.local file

MongoDB Setup

Local MongoDB:

# Install MongoDB locally
# macOS
brew tap mongodb/brew
brew install mongodb-community

# Start MongoDB
brew services start mongodb-community

MongoDB Atlas (Cloud):

Sign up at MongoDB Atlas
Create a free cluster
Get your connection string
Replace MONGODB_URI in .env.local

📁 Project Structure

clouddb/
├── app/
│   ├── (auth)/                      # Authentication routes
│   │   ├── sign-in/
│   │   └── sign-up/
│   ├── (dashboard)/                 # Protected dashboard routes
│   │   ├── dashboard/               # Main dashboard
│   │   ├── databases/               # Database management
│   │   │   └── [databaseId]/        # Individual database view
│   │   ├── plans/                   # Pricing plans
│   │   ├── profile/                 # User profile
│   │   ├── settings/                # Settings page
│   │   └── statistics/              # Statistics overview
│   ├── api/                         # API routes
│   │   └── databases/
│   │       ├── [dbId]/
│   │       │   ├── analytics/       # Database analytics
│   │       │   ├── explore/         # Database explorer
│   │       │   ├── health/          # Health checks
│   │       │   └── tables/          # Table operations
│   │       │       └── [tableName]/
│   │       │           ├── data/    # Table data
│   │       │           ├── rows/    # Row operations
│   │       │           └── schema/  # Schema information
│   │       └── route.ts             # Database CRUD
│   ├── globals.css                  # Global styles
│   ├── layout.tsx                   # Root layout
│   └── page.tsx                     # Landing page
├── components/
│   ├── landing/                     # Landing page components
│   │   ├── LandingHeader.tsx
│   │   ├── HeroSection.tsx
│   │   ├── FeaturesSection.tsx
│   │   ├── PricingSection.tsx
│   │   └── ...
│   ├── Sidebar.tsx                  # Dashboard sidebar
│   └── UpgradeBanner.tsx            # Upgrade prompts
├── lib/
│   ├── db.ts                        # Database connection
│   ├── plan-context.tsx             # Plan state management
│   └── utils.ts                     # Utility functions
├── models/
│   └── Database.ts                  # Database model
├── public/                          # Static assets
├── .env.local                       # Environment variables (not in repo)
├── next.config.ts                   # Next.js configuration
├── package.json                     # Dependencies
├── tailwind.config.ts               # Tailwind configuration
├── tsconfig.json                    # TypeScript configuration
└── README.md                        # This file

🗄️ Database Support

CloudDB supports multiple database types:

Database	Status	Features
MongoDB	✅ Full Support	Health checks, analytics, table explorer, CRUD operations
PostgreSQL	✅ Full Support	Health checks, analytics, table explorer, CRUD operations
MySQL	✅ Full Support	Health checks, analytics, table explorer, CRUD operations
Redis	🚧 Partial	Basic connection and key exploration
MariaDB	📋 Planned	Coming soon
SQLite	📋 Planned	Coming soon

Adding a Database

Navigate to Dashboard → Add Database
Select your database type
Enter connection details:
- Connection String (recommended)
- Or individual fields (host, port, username, password, database name)
Test the connection
Save and start monitoring!

💰 Pricing Tiers

CloudDB offers flexible pricing tiers to suit different needs:

Feature	Free	Pro	Advance	Enterprise
Price	$0/mo	$29/mo	$99/mo	Custom
Databases	5	25	100	Unlimited
Storage	10GB	100GB	500GB	Custom
Queries/month	100K	1M	10M	Unlimited
Team Members	1	5	20	Unlimited
Analytics	Basic	Advanced	Advanced	Advanced
Support	Community	Email	Priority	Dedicated
Backups	❌	Daily	Hourly	Custom
API Access	❌	✅	✅	✅
SSO	❌	❌	❌	✅
Custom SLA	❌	❌	❌	✅

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

Report Bugs - Open an issue with detailed information
Suggest Features - Share your ideas for improvements
Submit Pull Requests - Fix bugs or add new features
Improve Documentation - Help make the docs better
Share Feedback - Tell us what you think!

Development Workflow

Fork the repository
Create a feature branch
```
git checkout -b feature/amazing-feature
```
Make your changes
Commit your changes
```
git commit -m 'Add amazing feature'
```
Push to your branch
```
git push origin feature/amazing-feature
```
Open a Pull Request

Code Style

Use TypeScript for type safety
Follow the existing code style
Write meaningful commit messages
Add comments for complex logic
Update documentation as needed

Running Tests

npm run lint

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2026 CloudDB

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🆘 Support

Documentation

Getting Started Guide - [Link to docs]
API Documentation - [Link to API docs]
Tutorials - [Link to tutorials]
FAQ - [Link to FAQ]

Community

GitHub Issues - Report bugs and request features
Discussions - Join the conversation
Discord - Join our community (optional)
Twitter - @CloudDB (optional)

Contact

Email - support@clouddb.com (replace with actual email)
Website - https://clouddb.com

🙏 Acknowledgments

Next.js - The React Framework
Clerk - Authentication made easy
Vercel - Deployment platform
MongoDB - Database platform
Tailwind CSS - Styling framework
All our contributors

🗺️ Roadmap

Made with ❤️ by the CloudDB Team

⭐ Star us on GitHub • 🐛 Report Bug • ✨ Request Feature

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
.github		.github
app		app
components		components
lib		lib
models		models
public		public
.env.example		.env.example
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
eslint.config.mjs		eslint.config.mjs
middleware.ts		middleware.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json

License

ShahjahanAli/clouddb.com

Folders and files

Latest commit

History

Repository files navigation