An open API service indexing awesome lists of open source software.

https://github.com/miladjoodi/tokenbox

π“π¨π€πžπ§ππ¨π± is a lightweight Chrome extension that helps you test API logins and manage tokens without friction. πŸ”
https://github.com/miladjoodi/tokenbox

chrome chrome-extension chrome-extensions extension google googlechrome googleextension token

Last synced: 6 months ago
JSON representation

π“π¨π€πžπ§ππ¨π± is a lightweight Chrome extension that helps you test API logins and manage tokens without friction. πŸ”

Awesome Lists containing this project

README

          

# TokenBox πŸ—οΈ

**TokenBox** is a lightweight Chrome extension designed to make managing API tokens super easy and safe. Whether you're a developer testing APIs or just need to copy tokens quickly, TokenBox helps you handle everything in one place.

---
# πŸŽ₯ Demo Video
Watch a quick demo of TokenBox in action:
[![Watch the video](https://miro.medium.com/v2/resize:fit:640/format:webp/1*YAPs-K9h07KF4rS8CGKlyg.png)]([https://www.youtube.com/watch?v=YOUTUBE_VIDEO_ID](https://www.youtube.com/shorts/UJIIaENGIzA))
---

## πŸš€ Features

- **Manage multiple roles** πŸ§‘β€πŸ’»
You can create different roles like `admin`, `user`, etc. Each role stores its own credentials and last API response.

- **Save your credentials securely** πŸ”’
Store your username and password for each role. TokenBox remembers them so you don’t have to type them every time.

- **Receive API tokens instantly** ⚑
Send a request to your API and get the token back in one click.

- **Copy tokens easily** πŸ“‹
Copy the last received token for any role with a dedicated β€œCopy” button. The button is disabled if no valid token exists.

- **View last API response** πŸ“„
For each role, you can see the last response from the API by clicking the β€œLast Response” button.

- **Edit or delete roles** ✏️❌
Modify credentials for any role or delete a role entirely with confirmation.

- **Smart UI & UX** 🎨
- Responsive layout and neat design
- Colored messages for success βœ… and errors ❌
- Only shows relevant buttons based on your actions
- Maintains last token even after closing the popup

---

## πŸ› οΈ How It Works

1. **Set API URL**
Click the `Change` button next to the URL display to edit your API URL. Press `Apply` to save it.

2. **Add Roles**
Click the `+` button in the roles section to create a new role.

3. **Add Credentials**
Select a role and click `Edit Credentials`. Enter your username and password and save.

4. **Get Token**
Click the `Receive Token` button to send a request to your API.
- If successful, the token is saved and displayed.
- The β€œCopy” button becomes active to copy the access token.

5. **View Last Response**
Click the `Last Response` button to see the last API response for the selected role.

6. **Delete Role**
Select a role and click the `Delete` button to remove it. A confirmation alert ensures you don’t delete by accident.

---

## πŸ’Ύ Storage

TokenBox uses Chrome’s local storage to save:

- API URL
- Roles list
- Credentials for each role (username + password)
- Last received access token per role
- Last API response per role

All data stays on your machine. Nothing is sent elsewhere.

---

## 🎨 UI Details

- Messages:
- βœ… Green = Success
- ❌ Red = Error
- βšͺ Gray = Info

- Buttons:
- **Copy token** spans full width at the bottom.
- Action buttons (`Receive Token`, `Last Response`, `Delete`, `Edit Credentials`) show only when a role is selected.
- Disabled buttons turn gray if not clickable.

- Roles highlight when selected.

---

## πŸ”§ Installation

1. Open Chrome and go to `chrome://extensions/`
2. Enable **Developer mode**
3. Click **Load unpacked** and select the `TokenBox` folder
4. Pin the extension for quick access

---

## πŸ§‘β€πŸ’» Usage Tips

- Always save your credentials before requesting tokens
- Use separate roles for different API environments like `dev`, `staging`, and `prod`
- The **Last Response** button is helpful for debugging API calls

---

## πŸ“Œ Notes

- TokenBox only sends requests to the API URL you configure
- Your data stays on your device and is never shared elsewhere
- Works offline for viewing saved roles, responses, and credentials

---

## πŸ“ Feedback and Contribution

If you enjoy using TokenBox or have ideas for improving it, feel free to open an issue or submit a pull request.

Made with ❀️ by **[Milad Joodi](https://www.linkedin.com/in/joodi/)**