Skip to content

sciteche/FlavorDash

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FlavorDash V1.0.1

FlavorDash is a personal browser dashboard and theme customizer for Flavortown Hack Club. It sits in your browser toolbar and gives you quick access to your stats, project status, the store inventory, and lets you customize the website's look.

Features

  • 🎨 Theme Changer: Transform the falling snow on the Flavortown website into Fire, Hearts, Stars, Rain, Money, and more!
  • 🍪 Stat Tracking: Real-time view of your Cookies, Likes, and Coding Hours.
  • 🛠️ Project Monitor: View the status of your top projects (Rate-limit safe).
  • 🛍️ Store Checker: See what's currently in stock at The Shack.
  • Cache System: Smart caching to prevent hitting API rate limits.

Installation Guide

1. Download

  1. Download this repository or the release zip.
  2. Extract the folder to your computer.

2. Load Extension

  1. Open Chrome/Brave/Edge.
  2. Go to chrome://extensions.
  3. Enable Developer Mode (Top right corner).
  4. Click Load Unpacked.
  5. Select the FlavorDash folder.

3. Configuration (Required)

FlavorDash connects to your personal Flavortown account. You need to provide your API Key to fetch your stats.

  1. Click the FlavorDash Icon in your toolbar.
  2. It will open the Setup tab.
  3. Click the link to the Flavortown Dashboard and open settings.
  4. Generate/Copy your API Key (starts with ft_sk_).
  5. Paste the Key into the extension settings.
  6. Enter your User ID (e.g., 1234).
    • Tip: You can find this in your profile URL: flavortown.hackclub.com/users/1234
  7. Click Save Configuration.

How to use the Theme Changer

  1. Open the extension and go to the 🎨 Themes tab.
  2. Click on any emoji (e.g., 🔥 Fire, ✨ Stars, 💸 Cash).
  3. Open (or reload) flavortown.hackclub.com.
  4. The falling snow effect will now be replaced by your selected emoji!

Troubleshooting

  • 401 Unauthorized: Your API Key is incorrect. Go to Settings and check it.
  • 429 Rate Limit: You are clicking too fast! The Flavortown API only allows 5 requests per minute. The extension will automatically wait if this happens.
  • Projects loading slowly? This is intentional. The extension adds a 3-second delay between project fetches to protect your account from being rate-limited.
  • Theme not changing? Make sure you refresh the Flavortown tab after selecting a new theme.

Not affiliated with Hack Club official team. Built by a Hacker for Hackers.

About

A FlavorTown Extension

Resources

Stars

Watchers

Forks

Packages

No packages published