Fireball TL – Guild Management for Throne & Liberty

Fireball TL is an open-source guild management platform for Throne & Liberty, helping guild leaders and members efficiently organize guild activities.

📌 Project Overview

Fireball TL is a static guild management website for Throne & Liberty. It is designed as a client-side-only web application, meaning it does not have a backend or database. All data is stored in static JSON files inside the public folder.

⚡ Key Points to Know

• 🛑 No Database – All data is managed as static files.
• 📂 Static Data Storage – Stored in JSON files inside the public folder.
• 🌐 Static Website – Built with Next.js 15, but runs entirely on the client-side.
• 🎨 No Theme Color – The UI does not support theme customization.
• 🌍 No Multi-Language Support – The interface is available only in one language.

🔥 Features

• 📜 Guild Member List – View and manage guild members' information
• 🏹 Boss Loot Reservation – Reserve boss loot for fair distribution
• 🎲 Boss Loot Queue – Prioritize item drops for guild members
• ⚔️ Guild Boss Raid Schedule – Plan and track raid schedules
• 📜 Guild Rules – Set internal rules and guidelines for guild members

🛠️ Tech Stack

• Next.js 15 – Framework for static site generation.
• Framer Motion – Used for animations.
• TailwindCSS 4 – Utility-first CSS framework for styling.
• TypeScript – Strongly typed JavaScript for better maintainability.

🚀 Live Demo

Try it here: Fireball TL

📂 Installation & Setup

To run this project locally, follow these steps:

1. Clone the repository

git clone https://github.com/guysuvijak/fireball-tl.git

cd fireball-tl

2. Install dependencies

npm install

3. Start the development server

npm run dev

4. The app will be available

http://localhost:3000

🗺️ Project Structure

fireball-tl/
├── public/              # Static assets
│   ├── assets/          # Static Image Data
│   ├── data/            # Static Main Data
│   │   ├── member.json  # Static Guild Member Data -> Edit Here
│   │   ├── queue.json   # Static Queue Boss Data -> Edit Here
│   │   └── update.json  # Static News Data -> Edit Here
│   └── icon/            # Website Icon
└── src/
    ├── app/             # layout & page Next.JS
    │   ├── boss-queue/  # boss-queue page
    │   ├── boss-rule/   # boss-rule page
    │   ├── member/      # member page
    │   ├── position/    # position page
    │   └── schedule/    # schedule page
    ├── components/      # React components
    ├── configs/         # Configs File
    ├── hooks/           # React Custom Hooks
    ├── styles/          # CSS styles
    └── types/           # TypeScript File

📄 Modifying the Website

Since this is a static website, all modifications must be made directly within the project files. Here’s where you can edit specific parts of the site:

👥 Guild Members List
📍 File: public/data/member.json
Modify this file to update the list of guild members.

🏹 Boss Loot Queue
📍 File: public/data/queue.json
Update this file to change the queue order for boss loot distribution.

📢 Homepage News & Updates
📍 File: public/data/update.json
Edit this file to change the announcements displayed on the homepage.

🖼️ Adding Images
📍 Folder: public/assets/
Add new images for bosses, boss items, or weapons in this directory.

⚙️ Website Configuration
📍 Files:
src/app/layout.tsx – Modify general layout and metadata settings.
public/manifest.json – Update website metadata for PWA settings.

⚙️ Website Configs & Data
📍 Files:
src/configs/ – Modify Configs & Data in website.

📜 License

This project is open-source under the MIT License. Let me know if you need any modifications! 🚀

🙏 Acknowledgments

Thank you for your interest in Fireball TL! Your support means a lot. ❤️
⭐ If you like this project, please consider giving it a star on GitHub to show your support and encouragement! 🚀