🚀 Welcome to LOL URL

Your Links, Now with Superpowers. 😄
🌐 Live Demo • Issues • Pull Requests • Contributing • Demo Guide • Roadmap • FAQ

🚀 Shrink links, share smarter, and track your impact. Now open-source — contribute and grow with us!

🌐 Visit lolurl.site Now

LOL URL is a modern and playful open source URL-shortening website that lets you shrink long links, download custom QR codes, and track detailed analytics, including total clicks and regional insights. Built for simplicity and speed, LOL URL is perfect for creators, marketers, businesses, and anyone who loves smart link management. 🚀

✨ Features

| Feature | Description | |------------------------|----------------------------------------------------------| | URL Shortening | Convert long URLs into sleek, shareable links | | QR Code Generator | Download custom QR codes in high-quality formats | | Analytics Dashboard | Track total clicks and regional insights | | Fast & Responsive | Built with modern tools for seamless performance | | Link Management | Organize and manage all your shortened URLs in one place | | Custom Aliases | Create custom aliases for your shortened URLs | | Open Source | 100% MIT licensed (LICENSE) | | Live Demo | Try it instantly! |

See the ARCHITECTURE.md and GLOSSARY.md for more details.

🚀 Quick Start

Want to try it out? Check the live demo! or see DEMO.md

Local Setup

1. Clone the repository: bash git clone https://github.com/Rohit-Dnath/LOL-URL.git cd LOL-URL
2. Install dependencies: bash npm install
3. Set up environment variables: Create a .env file and add the required Supabase credentials and other configurations. See TROUBLESHOOTING.md if you get stuck.
4. Run the development server: bash npm run dev
5. Open http://localhost:3000 in your browser to view the app.

For deployment, see DEPLOYMENT-GUIDE.md.

🛠️ Usage

1. Paste a long URL into the input field
2. Click the "Shorten" button to generate a short link
3. Download the QR code or copy the link for sharing
4. Access analytics to track clicks and regions
5. Manage your links and view detailed analytics in the dashboard

See FAQ.md and USAGE.md for more tips.

🤝 Contributing

We welcome contributions from everyone! Want to make LOL URL even better?

1. Fork the repository
2. Create a new branch: git checkout -b feature/your-feature-name
3. Make your changes and add tests if applicable
4. Run npm run lint and npm run build to ensure code quality
5. Commit your changes: git commit -m 'Describe your change'
6. Push to your fork: git push origin feature/your-feature-name
7. Open a pull request with a clear description

Before contributing, please read: - CONTRIBUTING.md - CODEOFCONDUCT.md - SECURITY.md - SUPPORT.md - TROUBLESHOOTING.md - GOVERNANCE.md - CODESTYLE.md - COMMUNITY-GUIDELINES.md

See CONTRIBUTORS-GUIDE.md for more ways to get involved!

🙏 Acknowledgements

Special thanks to the open-source community for providing the tools and libraries that made this project possible. See THIRDPARTYNOTICES.md for a full list of dependencies.

👥 Contributors

This project exists thanks to all the amazing people who contribute! 🙌

👑 Project Founder & Lead Maintainer

Rohit Debnath 👑 - Creator & Admin - 🚀 Built LOL URL from the ground up - 🛠️ Lead maintainer and project architect - 💡 Vision: Making URL shortening fun and accessible for everyone

🌟 How to become a contributor:

• 🐛 Report bugs - Found an issue? Open an issue
• 💡 Suggest features - Have ideas? We'd love to hear them!
• 🔧 Submit pull requests - Code contributions are always welcome
• 📚 Improve documentation - Help make our docs better
• 🎨 Design improvements - UI/UX enhancements
• 🧪 Testing - Help us test new features and report issues
• 📢 Spread the word - Share LOL URL with your network

🚀 Getting Started as a Contributor:

1. Star the repo ⭐ - Show your support!
2. Fork the repository - Create your own copy
3. Check out CONTRIBUTING.md for detailed guidelines
4. Look for good first issues to get started
5. Join our community - Connect with other contributors

💝 Recognition

Every contributor, no matter how big or small their contribution, is valued and recognized:

• Code Contributors - Listed in our contributors graph
• Documentation Contributors - Credited in relevant docs
• Community Contributors - Recognized in our community channels
• Issue Reporters - Acknowledged in issue resolutions
• Feature Suggesters - Credited when features are implemented

Together, we're building something amazing! 🚀

Want to see your name here? Check out our CONTRIBUTORS-GUIDE.md to get started!

📬 Contact & Support

For any inquiries, support, or suggestions:

• Open an issue for bugs or feature requests
• Email: debnathrohit97@gmail.com
• Website: rohitdebnath.me
• See SUPPORT.md and SECURITY_CONTACTS.md

📢 Spread the Word

If you love LOL URL, star the repo, share it on social media, and tell your friends! Every ⭐ and share helps this project grow and reach more people.

📚 More Docs

• FAQ.md
• GLOSSARY.md
• ROADMAP.md
• RELEASE-NOTES.md
• AUTHORS.md
• MAINTAINERS.md
• FUNDING.md
• BRANDING-GUIDE.md
• ARCHITECTURE.md
• DEMO.md
• SUPPORTED_PLATFORMS.md
• MIGRATION-GUIDE.md
• TESTING-GUIDE.md
• CONTRIBUTORS-GUIDE.md
• CODESTYLE.md
• GOVERNANCE.md
• THIRDPARTYNOTICES.md
• SECURITY_CONTACTS.md

📂 Docs Folder

| File | Description | |------|-------------| | docs/database.md | Database overview & ER diagram | | docs/schemas.md | Table schemas (SQL) | | docs/api.md | API endpoints | | docs/setup.md | Setup guide | | docs/architecture-diagram.md | Architecture diagram (Mermaid) |

⚙️ Tech Stack

| Layer | Technology | |------------|-------------------| | Frontend | React, Vite, Tailwind CSS | | Backend | Supabase (DB, Auth, Analytics) | | Deployment | Vercel | | Docs | Markdown, Mermaid |

Hey, it's me, the developer of LOL URL,
Rohit Debnath

Connect with me:

Made with ❤️ by the open source community.

Shorten, Share, Track, Laugh! 😄