npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@idotj/mastodon-embed-timeline

v4.8.0

Published

Displays a Mastodon timeline with posts embed in your website. Very easy to setup, no dependencies, no trackers, cross-browser, WCAG compliant and fully responsive.

Readme

🐘 Mastodon embed timeline

Mastodon timeline widget screenshot

Embed a Mastodon timeline in your page with just a CSS and JS file.

Demo:
https://codepen.io/ipuntoj/pen/MWppNGL

📋 Table of contents

🛠️ Installation

Steps for installing the timeline in three different ways. Click here

⚙️ Setup

Steps to configure and customize your timeline. Click here

🔌 API

The current version has the following functions that can be performed:

| Function | Description | | ------------------------- | ------------------------------------------------------------------------------- | | mtColorTheme(themeType) | Apply a theme color. themeType accepts only two values: 'light' or 'dark' | | mtUpdate() | Reload the timeline by fetching the lastest posts |

📚 Examples

The folder examples/ contains different demos of timeline types to play with. Download the full project and open each HTML file in your favorite browser.

If you have any problems loading the examples in your browser (e.g. CORS error), check the documentation CONTRIBUTING.md to run the examples using alternatives such as Docker or Http-server.

🌐 Browser support

Mastodon embed timeline is supported on the latest versions of the following browsers:

  • Chrome
  • Firefox
  • Edge
  • Safari
  • Vivaldi
  • Opera

🚀 Improve me

Feel free to add your features and improvements.
In the file CONTRIBUTING.md you have detailed information that explains how to modify, build and collaborate with this project.

👥 Contributors

Contributions made by users on the Mastodon embed timeline by merge requests: i.j, Olle Wreede, Chris Vitalos, Markus Schlichting, Jesús Martínez, Charles Chin, Mònica

⚖️ License

GNU Affero General Public License v3.0

💬 FAQ

Check the closed issues, you might find your question there.

If nothing matches with your problem, check the open issues or feel free to create a new one.

Looking for a previous version of Mastodon embed timeline?
Check on the tags list to see all the released versions: Tags history

Alternatives

Other projects to embed your Mastodon timeline: