Back to Blog
Open Source
Engineering
Community

Luma Page Transformer: The Engine Behind Clean Bookmarks

Ever wondered how Luma keeps your bookmarks looking so clean? Meet the open-source library that makes it possible.

Vinod
2025-12-23
3 min read
Luma Page Transformer: The Engine Behind Clean Bookmarks

We've all been there: you bookmark a YouTube video to watch later, and the title gets saved as "(2) Amazing Tutorial - YouTube". Or you save a recipe, and the bookmark title is fifty words long, filled with SEO keywords you don't care about.

At Luma, we believe your digital space should be clean, organized, and clutter-free. That's why we built luma-page-transformer.

What is Luma Page Transformer?

luma-page-transformer is an open-source npm library designed to transform and clean up page metadata. It's the silent engine that runs in the background when you save a link to Luma, ensuring that what you see is the actual content, not the noise.

Think of it as a translator that takes the messy, raw data from the web and translates it into a clean, human-readable format for your personal library.

Why Do We Need It?

Websites are designed to grab attention in a crowded browser tab or a Google search result. They often stuff their titles with notifications, brand names, and extraneous information.

The YouTube Example

Imagine you have unread notifications on YouTube. The tab title might look like this:

(2) How to Build a React App - YouTube

When you bookmark this, you don't want that (2) part. It's irrelevant to the content. You also probably don't need the - YouTube suffix if you already know where it's from.

This is where our transformer comes in handy. It recognizes that this is a YouTube link, parses the title, identifies the notification count pattern, and strips it away. The result?

How to Build a React App

Clean, simple, and exactly what you wanted to save.

Open Source and Community Driven

Here's the best part: anyone can contribute.

The internet is huge. There are millions of websites, and each one formats its data differently. We can't possibly cover them all on our own. That's why we made this project public and open source.

If you find a website that doesn't look quite right in Luma, you can write a transformer for it and add it to the library.

How to Contribute

  1. Check out the project on GitHub: https://github.com/vinodliyanage/luma-page-transformers
  2. Fork the repository.
  3. Add a transformer rule for your favorite site (it's easier than you think!).
  4. Submit a Pull Request.

By contributing, you're not just improving Luma for yourself; you're helping developers everywhere who need a standardized way to handle web metadata.

Let's build a cleaner web together.