Your Digital Connection Hub
Create a personalized link tree to showcase all your online profiles and services in one beautiful place.
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.
β
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
| 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 |
- Node.js 18+
- MongoDB 6.0+
- Google OAuth credentials
- AWS S3 bucket (optional, for file uploads)
- Clone the repository
git clone https://github.com/yourusername/mero-link.git
cd mero-link- Install dependencies
npm install- 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- Run development server
npm run dev- Open browser
Navigate to
http://localhost:3000
- Deployment Guide - Deploy to production (Vercel, Docker, PM2)
- Migration Guide - Environment variable changes
- API Reference - REST API endpoints documentation
βββ 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
| 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 |
- β
Indexed queries on
uri,owner,emailfields - β Compound indexes for analytics queries
- β Lean queries to reduce memory footprint
- β Field projection to minimize payload size
- β 60s TTL cache for page data
- β 2-5min cache for user profiles
- β Smart invalidation on mutations
- β Cache monitoring & hit rate tracking
- β Image optimization with Next.js Image
- β Component code-splitting with dynamic imports
- β Lazy-loaded forms and analytics dashboard
- β Global progress bar for navigation feedback
docker-compose up -dnpm install -g vercel
vercel deploynpm install -g pm2
pm2 start ecosystem.config.js
pm2 saveSee PRODUCTION-GUIDE.md for detailed setup steps.
We welcome contributions! Here's how you can help:
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Run
npm run lintto check code quality - Run
npm run buildto verify production build - Run
npm run devfor development with hot reload
This project is licensed under the MIT License - see the LICENSE file for details.
Built with β€οΈ by the Mero Link team
Powered by Next.js, MongoDB, and TailwindCSS
- π§ Email: support@merolink.com
- π Issues: GitHub Issues
- π¬ Discussions: GitHub Discussions
Made with π¨ by creators, for creators
β Star us on GitHub if you find Mero Link useful!