Why Build a URL Shortener?

Before diving in, you might wonder: why build yet another URL shortener? Here’s why this project is valuable:

1. You own your data and links
2. You can track click analytics
3. You’ll learn modern web development practices
4. It’s a perfect serverless deployment example
5. You can extend it with custom features

The Tech Stack

We’re using a modern, lightweight stack:

• Node.js & Express: For our backend API
• MongoDB Atlas: For data persistence
• Vercel: For serverless deployment
• Tailwind CSS: For a clean, responsive UI

Key Features

Our URL shortener includes:

• URL shortening with nanoid for unique IDs
• Click tracking
• Real-time statistics
• Mobile-friendly interface
• Clean, RESTful API

The Implementation

Here’s the interesting part – how we built it. Let’s break down the key components:

1. The Data Model

We kept the MongoDB schema simple but effective:

const urlSchema = new mongoose.Schema({
  originalUrl: String,
  shortUrl: String,
  clicks: { type: Number, default: 0 },
  createdAt: { type: Date, default: Date.now }
});

2. URL Generation

Instead of using complex algorithms, we opted for nanoid, which provides:

• Short, unique IDs
• No collisions (practically)
• URL-safe characters

3. The API

We implemented three main endpoints:

// Create short URL
app.post('/api/shorten', async (req, res) => {
  const shortUrl = nanoid(8);
  const urlDoc = await Url.create({
    originalUrl: url,
    shortUrl
  });
  res.json(urlDoc);
});

// Get URL stats
app.get('/api/stats/:shortUrl', async (req, res) => {
  const urlDoc = await Url.findOne({ shortUrl: req.params.shortUrl });
  res.json(urlDoc);
});

// Handle redirects
app.get('/:shortUrl', async (req, res) => {
  const urlDoc = await Url.findOne({ shortUrl: req.params.shortUrl });
  urlDoc.clicks++;
  await urlDoc.save();
  res.redirect(urlDoc.originalUrl);
});

4. Serverless Deployment

Vercel made deployment incredibly simple. The key was properly configuring our Express app for serverless:

// Handle both API and static files
app.use(express.static('public'));
export default app;

Challenges and Solutions

During development, we encountered and solved several interesting challenges:

1. MongoDB Connection: Initially, we had issues with MongoDB connections in the serverless environment. The solution was proper connection handling and error management.
2. Route Handling: Vercel’s routing needed special attention to handle both API endpoints and the frontend correctly.
3. Statistics Updates: Ensuring atomic updates for click counting required careful consideration of MongoDB operations.

Future Improvements

The current implementation is solid but could be enhanced with:

1. Custom short URLs
2. User authentication
3. QR code generation
4. Advanced analytics
5. API rate limiting

Try It Yourself

The project is open source and available on GitHub: URL Shortener Project

You can see it in action here: Live Demo

Conclusion

Building a URL shortener was both fun and educational. It demonstrates how modern web technologies can come together to create something useful in a short time. The serverless deployment aspect makes it particularly interesting, as it shows how to build scalable applications without managing servers.

What features would you add to this URL shortener? Let me know in the comments below!

P.S. All the code is available on GitHub, and I encourage you to fork it, enhance it, and make it your own. If you build something cool with it, I’d love to hear about it!

Co-written with Claude 3.5 Sonnet

This post and the accompanying URL shortener project were developed in collaboration with Claude 3.5 Sonnet, an AI assistant from Anthropic. Claude helped architect the solution, write the code, and structure this blog post. While I implemented and tested the solution, made key technical decisions, and deployed the final product, I believe in being transparent about AI collaboration in both development and content creation.

The complete source code is available on GitHub.

• Silence – prayer/meditation
• Affirmations – describe the highest vision for yourself
• Visualization – visualize what success looks like and the actions to get there
• Exercise – 10 minutes to get the blood flowing. Try a push-up/sit-up/air-squat/pull-up circuit
• Reading – self-help/motivational books
• Scribing – check out the 5 minute journal

From the “The Miracle Morning” by Hal Elrod

Listen to Hal’s explanation on the Smart Passive Income podcast.

Touch ID iPhone 5s” by Pixeden.com – http://www.pixeden.com/psd-mock-up-templates/iphone-5s-psd-vector-mockup. Licensed under CC BY 3.0 via Wikimedia Commons.

I had given up on fingerprint readers in the 90s when I first used a Dell laptop with a built-in fingerprint reader. At the time, you had to swipe your finger downward across the sensor and most times it would take several swipes to work. Probably because I did not RTFM, I could only use the fingerprint reader to unlock the laptop, though my goal was to login to websites with a swipe of my finger. One could dream …

I know I’m late to the party, but wow … Touch ID is truly a game changer for my productive workflows. Finally, a finger print reader that just works. If you’re invested in the Apple ecosystem and have not upgraded to a Touch ID enabled iPhone, do it and do it now!

In combination with 1Password and TextExpander, you’ll surely save enough keystrokes to stifle iPhone typing induced carpal tunnel syndrome for at least one year.

Just like the iPod Touch first convinced me I did not need a stylus to operate a smart phone, Touch ID has convinced me that all the things should be done via fingerprint readers (or some other simple biometric reader). Shouts go out to apps that have already implemented Touch ID authentication — looking at you DayOne

Now, let’s go get some things done.

This is what the report looks like:

Here are some ideas to expand this script:

* organize the results by Folder
* make the note title start with YYYY-MM-DD
* send this report via email

To me, opening up a web browser is like walking into a large library. The potential is overwhelming and a strategy is necessary to maximize the amazing opportunity before you. Check out my strategy and let me know what you think.

The talk consists of the slides, documentation (on APIary) and code (on GitHub, written in Python/Flask).

Big thanks to API World for offering a platform to express these ideas and SendGrid for sponsoring my attendance.

When I awoke for the day ahead, I was determined to carpe diem, even though I was feeling weary due to lack of sleep. And in fact, today ended up being among my most productive days.

My solution? I launched into routine mode and made to myself a special commitment to start reading for leisure again. Since school began for my daughter on Monday, resulting in a one hour, twice a day commute, I decided to use Audible as the tool of choice.

I downloaded a book I’ve been wanting to read for a long time, Influx by Daniel Suarez. I was torn between that book and Kill Decision by the same author. I really enjoyed Suarez’s earlier works (Daemon and Freedom ) and was eager to explore his latest two offerings.

Right now I’m at chapter 4 and I can definitively say, I’m hooked. In fact, I feel like I need to do some extra chores, walk the dog again or drive somewhere randomly to get more “reading” done.

I have missed the great pleasure of letting my mind explore fantastical, yet possible in my lifetime, ideas that author’s like Michael Crichton have mastered.

I won’t reveal any spoilers here; however, I can say that this book, particularly chapter three, has re-ignited a child-like view of my world, all without mind alteration

If you decide to join me on this reading adventure, be sure to reach out so we can discuss the ideas presented in the book, especially those in chapter three. This is the kind of stuff I love talking and thinking about.

Enjoy and pass along to your chaotic good friends.

Proper Planning and Preparation Prevents Piss Poor Performance

Focus

Choose one habit or routine at a time to perfect, using Benjamin Franklin’s method by which he practiced his 13 virtues (read through to page 42).

Calendar or Reminders or Post-its?

Choose whatever method which would make sure you are reminded at the appropriate time, whether that be email, phone, calendar (paper or digital), a reminder app or a simple Post-it note on your forehead.

Reference Materials

Next, create an Evernote notebook (or whatever system you prefer) where you will store any information regarding keeping your routine or habit flowing. That could be a checklist, the hours your gym is open, phone numbers to call, etc.

If you don’t want to go digital, use a small notebook or index card. Whatever method you choose, make sure it allows you to retrieve the information you need, when you need it.

Tools

Make sure that whatever tools you need (physical, digital or otherwise) are also readily available. Take the time to research which tools will best help you stick to your habit or routine.

For example, if running is one of the habits you want to develop, invest the time and money into the right gear. Then make sure that gear is readily available at any time you could go for a run.

Measure

In order to continuously improve, you must measure your progress. This can be as simple as a hash mark on a piece of paper, or as sophisticated as an app such as Lift. Use whatever you will commit to using daily.

Execute

Start right now!

Pick your first habit and choose today’s date as your lucky number.

Godspeed!

If not, head on over and read my latest blog post, Quantify Thyself: Creating a Personal Life API, that describes how to create one.