Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

πŸ” Mastodon User Search

A lightweight web app to search Mastodon users in real-time using the public Mastodon API.

🌐 Live Demo: Mastodon-Search-Tool


✨ Features

  • ⚑ Real-time user search
  • 🌍 Works across Mastodon instances
  • πŸ‘€ Displays user profiles (username, avatar, bio)
  • 🎯 Simple and responsive UI
  • πŸš€ No frameworks β€” pure HTML, CSS, and JavaScript

πŸ› οΈ Tech Stack

  • HTML5
  • CSS3
  • Vanilla JavaScript
  • Mastodon API (/api/v2/search)

πŸ“Έ Preview

image image

πŸš€ Getting Started

Run Locally

  1. Clone the repository:
git clone https://github.com/your-username/mastodon-user-search.git
  1. Open the project folder:
cd mastodon-user-search
  1. Open index.html in your browser

πŸ“‘ How It Works

  • Takes user input (search query)
  • Sends a request to the Mastodon API
  • Fetches matching user accounts
  • Dynamically displays results on the page

πŸ“ Project Structure

mastodon-user-search/
│── index.html
│── style.css
│── script.js
│── assets/
│── README.md

πŸ“Œ Roadmap

  • Add hashtag search
  • Add toot (post) search
  • Improve UI/UX
  • Add dark mode πŸŒ™
  • Better error handling

🀝 Contributing

Feel free to contribute!

  • Fork the repo
  • Create a new branch
  • Make your changes
  • Submit a pull request

πŸ“„ License

This project is licensed under the MIT License.


πŸ’‘ Inspiration

Built to make discovering people on the Fediverse simple and fast.

"Explore the decentralized social web effortlessly."

Releases

Packages

Contributors

Languages