Skip to content

ayush712gupta/mastodon-user-search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

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

No releases published

Packages

 
 
 

Contributors

Languages