Skip to content

probeen007/Mero-Link

Repository files navigation

Mero Link Logo

🌐 Mero Link

Your Digital Connection Hub

Next.js 15 React 19 MongoDB TailwindCSS License: MIT

Create a personalized link tree to showcase all your online profiles and services in one beautiful place.


🎯 About Mero Link

Mero Link is a modern, feature-rich platform that empowers individuals and businesses to create a personalized digital hub. Unlike traditional link tree services, we focus on delivering exceptional user experience with powerful analytics, stunning design customization, and seamless integration.

Why Choose Mero Link?

βœ… Beautiful Design - 30+ premium themes to match your brand
βœ… Real-time Analytics - Track clicks, views, and engagement
βœ… Mobile-Optimized - Perfect experience on all devices
βœ… Google Sign-in - Quick authentication with OAuth
βœ… File Hosting - Built-in S3 integration for avatars & backgrounds
βœ… QR Code Export - Share your profile as QR code
βœ… Lightning Fast - Optimized database with caching & indexing


✨ Key Features

Feature Description
🎨 30+ Themes Pre-designed themes from anime to corporate styles
πŸ“Š Analytics Dashboard Real-time insights into link performance and user engagement
πŸ–ΌοΈ Custom Branding Upload custom background images and adjust colors
πŸ“± Responsive Design Fluid typography and adaptive layouts for all screen sizes
πŸ”’ Privacy Control Control visibility and access to your profile
πŸŒ™ Dark/Light Mode Automatic theme switching based on system preference
⚑ Performance Database indexes + response caching for instant loads
πŸ”— Social Integration Link Instagram, Twitter, LinkedIn, GitHub, and more
πŸ“€ File Upload S3-powered image hosting with automatic optimization
πŸ”„ Live Preview See changes in real-time before publishing

πŸš€ Quick Start

Prerequisites

  • Node.js 18+
  • MongoDB 6.0+
  • Google OAuth credentials
  • AWS S3 bucket (optional, for file uploads)

Installation

  1. Clone the repository
git clone https://github.com/yourusername/mero-link.git
cd mero-link
  1. Install dependencies
npm install
  1. Set up environment variables
cp .env.example .env.local
# Edit .env.local with your credentials:
# - MONGO_URI
# - NEXTAUTH_SECRET
# - GOOGLE_CLIENT_ID / GOOGLE_CLIENT_SECRET
# - AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY / S3_BUCKET_NAME
  1. Run development server
npm run dev
  1. Open browser Navigate to http://localhost:3000

πŸ“š Documentation


πŸ—οΈ Architecture

β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/           # Next.js App Router pages & API routes
β”‚   β”œβ”€β”€ components/    # Reusable React components (with optimization)
β”‚   β”œβ”€β”€ actions/       # Server actions for mutations
β”‚   β”œβ”€β”€ models/        # Mongoose schemas (User, Page, Event)
β”‚   β”œβ”€β”€ libs/          # Utilities (caching, auth, upload, logging)
β”‚   └── hooks/         # Custom React hooks
β”œβ”€β”€ public/            # Static assets & PWA icons
β”œβ”€β”€ scripts/           # Database & deployment scripts
└── docker/            # Docker configuration

Tech Stack

Layer Technology
Frontend Next.js 15, React 19, TailwindCSS
Backend Node.js, Next.js API Routes
Database MongoDB 6+ with Mongoose ORM
Storage AWS S3 for avatars & backgrounds
Auth NextAuth.js with Google OAuth
Caching In-memory TTL cache + response optimization
Monitoring Custom logging & performance tracking

⚑ Performance Optimizations

Database Optimizations

  • βœ… Indexed queries on uri, owner, email fields
  • βœ… Compound indexes for analytics queries
  • βœ… Lean queries to reduce memory footprint
  • βœ… Field projection to minimize payload size

Response Caching

  • βœ… 60s TTL cache for page data
  • βœ… 2-5min cache for user profiles
  • βœ… Smart invalidation on mutations
  • βœ… Cache monitoring & hit rate tracking

Client-Side Optimizations

  • βœ… Image optimization with Next.js Image
  • βœ… Component code-splitting with dynamic imports
  • βœ… Lazy-loaded forms and analytics dashboard
  • βœ… Global progress bar for navigation feedback

πŸ“¦ Deployment

Docker (Recommended)

docker-compose up -d

Vercel

npm install -g vercel
vercel deploy

PM2 (Self-hosted)

npm install -g pm2
pm2 start ecosystem.config.js
pm2 save

See PRODUCTION-GUIDE.md for detailed setup steps.


🀝 Contributing

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

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

Development Tips

  • Run npm run lint to check code quality
  • Run npm run build to verify production build
  • Run npm run dev for development with hot reload

πŸ“„ License

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


πŸ™ Acknowledgments

Built with ❀️ by the Mero Link team
Powered by Next.js, MongoDB, and TailwindCSS


πŸ“ž Support


Made with 🎨 by creators, for creators

⭐ Star us on GitHub if you find Mero Link useful!

About

Your digital identity, unified. Create a personalized link hub that brings together your social profiles and essential links in one shareable space. Stand out, connect smarter, and redefine how you present yourself online.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Contributors