How to Build a URL Shortener with Node.js, Express, and MongoDB (Full Project)

Introduction

In the internet age, long and complicated URLs can be a hassle to share or remember. A URL shortener service provides an elegant solution by converting lengthy URLs into compact, shareable links. In this blog post, we will learn how to build a simple yet robust URL shortener service using Node.js, Express, and MongoDB. This project is perfect for honing your skills in full-stack development.

Features

URL Shortening: Converts long URLs into short, easy-to-share links.
Redirection: Automatically redirects users from a short URL to the original URL.
User-Friendly Interface: A clean and intuitive frontend built with HTML, CSS, and JavaScript.
Backend Efficiency: Powered by Node.js and Express for seamless server-side operations.
Database Integration: MongoDB is used to store and retrieve URL mappings efficiently.

Technologies Used

Backend: Node.js, Express.js, MongoDB, Mongoose
Frontend: HTML, CSS, JavaScript
Deployment: Render
Other Tools: Body-Parser, CORS, dotenv

Project Structure

url-shortening-service/
├── client/
│   ├── app.js
│   ├── index.html
│   └── style.css
├── server/
│   ├── constants.js
│   ├── db.js
│   ├── server.js
│   └── url.model.js
├── .gitignore
├── package.json
├── README.md
└── render.yaml

Client-Side

index.html: The main HTML file provides the structure of the interface.
style.css: Stylesheet to enhance the look and feel of the front end
app.js: Contains the logic for user interaction, sending requests, and handling responses from the backend.

Server-Side

server.js: The entry point for the backend. Sets up the Express server, defines routes, and connects to MongoDB.
db.js: Manages the MongoDB connection using Mongoose.
url.model.js: Defines the Mongoose schema for storing original and shortened URLs.
constants.js: Contains constants such as database configuration and other reusable values.

Setting Up the Project

Prerequisites

Node.js: Ensure Node.js is installed on your machine.
MongoDB Atlas: Create a MongoDB Atlas account and set up a database.

Installation Steps

Clone the Repository:

git clone https://github.com/codingashishdev/url-shortening-service.git

Navigate to the Project Directory:
```
cd url-shortening-service
```
Install Dependencies:
```
npm install
```
Set Up Environment Variables:
- Create a .env file in the root directory.
- Add the following variables:
```
MONGODB_URI=your_mongodb_atlas_connection_string
BASE_URL=your_bash_url
```
Start the Server:
```
npm run dev
```
Access the Application:
- Open http://localhost:3000 in your browser.
- Enter the URL to shorten and click "Shorten URL" to generate a shareable link.

How It Works

1. Frontend Interaction

Users input a long URL into the form provided on the interface.
When the user submits, a POST request is sent to the backend API with the long URL.

2. Backend Processing

URL Validation: The backend validates the input URL format.
Database Check:
- If the URL already exists in the database, the existing short key is returned.
- If it's new, a unique short key is generated and saved along with the original URL.
Response: The shortened URL is sent back to the front end for display.

3. Redirection

When users visit a shortened URL, the server fetches the corresponding original URL from the database and redirects the user to it.

Deployment

The application can be deployed on Render, a cloud platform for hosting web applications. The render.yaml file contains all the configurations required for deployment, including environment variables and build commands.

Conclusion

Creating a URL shortener service is a great way to improve your full-stack development skills. This project uses important technologies like Node.js, Express, and MongoDB to build a working and scalable app. It also gives you practical experience with API design, database management, and connecting the frontend and backend.

Check out the GitHub repository for the full source code. Contributions and suggestions are always welcome.

FAQ

How does a URL shortener generate short codes?

This project generates a unique random key and checks MongoDB for collisions before saving. At scale, most shorteners switch to an auto-incrementing ID converted to base62 (a–z, A–Z, 0–9) — six base62 characters cover about 56 billion URLs.

What happens when two users shorten the same URL?

The backend checks whether the original URL already exists in the database and returns the existing short key instead of creating a duplicate. This keeps the collection small and makes click counts per destination straightforward.

Where can I deploy a Node.js URL shortener for free?

Render, Railway, and Fly.io all have free or low-cost tiers that work with MongoDB Atlas' free cluster. This project includes a render.yaml so the service and database deploy together with one push.

Is MongoDB a good choice for a URL shortener?

Yes — the data model is a simple key-value mapping, MongoDB handles that efficiently, and Atlas gives you a free hosted database. A relational database works equally well; the schema is one table with two columns.