X Finder General

A JavaScript application (OOP-based) for generating and displaying profile, list, and community URLs from X (formerly Twitter), featuring OAuth 2.0 support, token refresh, local storage, and filtered blocked users.

---

🚀 Features

• OAuth 2.0 PKCE login (using your X Developer Client ID)

• Automatic token refresh (if supported by your client)

• Persistent storage using localStorage and sessionStorage

• Manual logout (clears all stored tokens)

• Dynamic URL generation for:

  • Communities: members, moderators
  • Lists: followers, members
  • Users: followers, following, verified followers

• Visual indicator of authentication status

• Modern UI styled like X.com

---

💧 How to Use Locally

1. Clone or download this project:

   git clone https://github.com/andrealba/x-finder-general.git
   cd x-finder-general

2. Open index.html in your browser directly, or launch a local server:

   # With Python 3
   python -m http.server
   # Then visit http://localhost:8000

3. Fill in the required fields:

   • Your Client ID from developer.x.com
   • Optionally, a Bearer Token
   • One of: Community ID, List ID, or User ID

4. Click "Login with X" to begin the OAuth flow.

---

🌐 Deploying on GitHub Pages

1. Copy x-finder-general.html to your repo root.

2. In GitHub > Settings > Pages:

   • Set source to main branch, root folder (/).

3. After deployment, add the following URI in your app settings on X Developer Portal:

   https://andrealba.github.io/x-finder-general
   

---

🔒 Security Notes

Tokens are stored in localStorage for ease of use during development. In production:

• Consider encrypting tokens
• Set shorter token expiration
• Implement CORS protection on server
• Strip debug logs and error traces

---

📄 License

This project is released under the MIT License.