Skip to content

A full-stack URL shortener application built with React (TypeScript) on the frontend, Express (TypeScript) on the backend, and powered by Recoil for state management. Utilizes Tailwind CSS for styling, MongoDB for data storage, and follows a RESTful API architecture. Designed with type safety as a core principle, providing a robust and scalable sol

Notifications You must be signed in to change notification settings

KashyapDas/URL-Shortner

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”— Ultimate URL Shortener | TypeScript | React | Express | MongoDB

πŸš€ Project Highlights

  • Full-Stack Type-Safe URL Shortening Solution
  • Modern Web Technologies
  • High Performance & Scalability

οΏ½tech-stack

Frontend

  • React with TypeScript
  • Recoil for State Management
  • Tailwind CSS for Responsive Design

Backend

  • Express.js with TypeScript
  • RESTful API Architecture
  • MongoDB Database Integration

🌟 Why This URL Shortener?

πŸ’‘ Key Problem Solved

Transforming long, complex URLs into clean, manageable, and shareable links that are:

  • Easy to remember
  • Quick to distribute
  • Trackable and secure

πŸ” Core Functionalities

  • Generate short, unique URL aliases
  • Redirect original long URLs
  • Basic click tracking and analytics
  • Custom URL slug creation
  • Link management dashboard

πŸ€” How URL Shortener Works

URL Creation Flow

  1. User enters long URL
  2. System generates unique short code
  3. Store mapping in database
  4. Return shortened URL to user

Redirection Mechanism

  1. When short URL is accessed
  2. Backend looks up original URL
  3. Performs 301 (permanent) redirect
  4. Optionally logs redirect event

πŸ”’ Technical Architecture

Type Safety Advantages

  • Compile-time error checking
  • Improved code quality
  • Better developer experience
  • Reduced runtime errors

Performance Optimization

  • Efficient MongoDB indexing
  • Minimal API response times
  • Scalable microservice design

πŸ›  Setup & Installation

Prerequisites

  • Node.js (v16+)
  • MongoDB
  • TypeScript

Quick Start

# Clone Repository
git clone https://github.com/KashyapDas/url-shortener

# Install Dependencies
npm install

# Run Development Server
npm run dev

🌈 Features Roadmap

  • User Authentication
  • Custom Domain Support

🀝 Contribution Guidelines

  1. Fork the Project
  2. Create Feature Branch
  3. Commit Changes
  4. Push to Branch
  5. Open Pull Request

πŸ“Š Project Stats

GitHub Stars GitHub Forks TypeScript

πŸ“œ License

MIT License

🌟 Show Your Support

Give a ⭐️ if this project helped you!

πŸ’– Spread the Word

Star this repo, share with your network, and help others discover this ultimate URL shortening solution!

#urlshortener #typescript #react #webdevelopment #opensource #nodejs #mongodb

About

A full-stack URL shortener application built with React (TypeScript) on the frontend, Express (TypeScript) on the backend, and powered by Recoil for state management. Utilizes Tailwind CSS for styling, MongoDB for data storage, and follows a RESTful API architecture. Designed with type safety as a core principle, providing a robust and scalable sol

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published