Skip to content

utkarshagar2121/LinkEdge

Repository files navigation

🔗 LinkEdge - Modern URL Shortener with Analytics

LinkEdge is a full-stack URL shortener app built using React.js and Supabase. It provides users with a fast, clean way to shorten links, track clicks, generate QR codes, and analyze performance—all with secure authentication and a beautiful UI powered by ShadCN and TailwindCSS.


✨ Features

  • 🔐 Secure Authentication
    User login & signup handled by Supabase Auth (JWT sessions).

  • 🔗 Link Shortening
    Easily shorten long URLs into compact, shareable links.

  • 📈 Real-Time Click Analytics
    Track number of clicks, timestamps, and locations (via third-party APIs).

  • 📄 User Dashboard
    Personalized dashboard displaying all your shortened URLs and performance metrics.

  • 🧾 QR Code Generation
    Instantly generate downloadable QR codes for any short link.

  • 🛡️ Admin Panel (Role-Based)
    Admins can manage users, links, and monitor activity with Supabase role support.


🧱 Tech Stack

Layer Technology
Frontend React.js, TailwindCSS, ShadCN UI
Backend (BaaS) Supabase (Auth, DB, Realtime)
Database PostgreSQL (via Supabase)
Auth Supabase Auth (JWT-based)
Extras QR Code Generator, IP-based Geo API

🔧 Setup & Installation

1. Clone the Repository

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

2. Install Dependencies

npm install

3. Set Up Supabase

  • Create a project on https://supabase.com
  • Create the required tables:
    • urls: for storing original and short links
    • clicks: for storing click records (optional)
  • Enable email/password Auth
  • Get your Supabase Project URL and Anon Public Key

4. Add Environment Variables

Create a .env file in the root folder:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_anon_key

5. Run the App

npm run dev

🚀 Deployment

You can deploy LinkEdge to:

  • Vercel – Connect your repo and add environment variables
  • Netlify – Same as above
  • Supabase – Already handles your backend

🤝 Contributing

Contributions are welcome! Feel free to fork the repo and submit a pull request.


📄 License

MIT License. Free for personal and commercial use.


🙋‍♂️ Author

Made with ❤️ by Utkarsh Agarwal
📧 [email protected]
🌐 GitHub


About

Link shortner

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published