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

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

Fireball TL is a guild management website for Throne & Liberty, designed to help guild leaders and members efficiently manage their guild operations.
https://github.com/guysuvijak/fireball-tl

client-side frontend guildmanagement nextjs no-database open-source static-site throneandliberty typescript website

Last synced: 2 months ago
JSON representation

Fireball TL is a guild management website for Throne & Liberty, designed to help guild leaders and members efficiently manage their guild operations.

Awesome Lists containing this project

README

          

![Project Banner](/public/assets/boss/adentus-banner.webp)
# 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 Banner](/public/metadata/readme-1.png)
![Project Banner](/public/metadata/readme-2.png)
![Project Banner](/public/metadata/readme-3.png)

## πŸ“Œ 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.

![Project Banner](/public/metadata/readme-8.png)

## ⚑ 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
- nextjs Next.js 15 – Framework for static site generation.
- framermotion Framer Motion – Used for animations.
- tailwindcss TailwindCSS 4 – Utility-first CSS framework for styling.
- typscript TypeScript – Strongly typed JavaScript for better maintainability.

![Project Banner](/public/assets/boss-items/3-0.webp)![Project Banner](/public/assets/boss-items/13-0.webp)![Project Banner](/public/assets/boss-items/10-0.webp)![Project Banner](/public/assets/boss-items/11-0.webp)

## πŸš€ Live Demo
Try it here: [Fireball TL](https://fireball-tl.vercel.app)

![Project Banner](/public/metadata/readme-4.png)
![Project Banner](/public/metadata/readme-5.png)
![Project Banner](/public/metadata/readme-6.png)
![Project Banner](/public/metadata/readme-7.png)

## πŸ“‚ Installation & Setup

To run this project locally, follow these steps:

### **1. Clone the repository**
```bash
git clone https://github.com/guysuvijak/fireball-tl.git
```
```bash
cd fireball-tl
```
### **2. Install dependencies**
```bash
npm install
```
### **3. Start the development server**
```bash
npm run dev
```
### **4. The app will be available**
[http://localhost:3000](http://localhost:3000)

![Project Banner](/public/assets/boss/aridus-banner.webp)

## πŸ—ΊοΈ Project Structure
```bash
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
```

![Project Banner](/public/assets/boss/nirma-banner.webp)

## πŸ“„ 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:
```bash
πŸ‘₯ Guild Members List
πŸ“ File: public/data/member.json
Modify this file to update the list of guild members.
```
```bash
🏹 Boss Loot Queue
πŸ“ File: public/data/queue.json
Update this file to change the queue order for boss loot distribution.
```
```bash
πŸ“’ Homepage News & Updates
πŸ“ File: public/data/update.json
Edit this file to change the announcements displayed on the homepage.
```
```bash
πŸ–ΌοΈ Adding Images
πŸ“ Folder: public/assets/
Add new images for bosses, boss items, or weapons in this directory.
```
```bash
βš™οΈ Website Configuration
πŸ“ Files:
src/app/layout.tsx – Modify general layout and metadata settings.
public/manifest.json – Update website metadata for PWA settings.
```

```bash
βš™οΈ Website Configs & Data
πŸ“ Files:
src/configs/ – Modify Configs & Data in website.
```

![Project Banner](/public/assets/boss/junobote-banner.webp)

## πŸ“œ License
This project is open-source under the MIT License.
Let me know if you need any modifications! πŸš€

![Project Banner](/public/assets/boss/malakar-banner.webp)

## πŸ™ Acknowledgments
Thank you for your interest in Fireball TL! Your support means a lot. :heart:
⭐ If you like this project, please consider giving it a star on GitHub to show your support and encouragement! πŸš€

![Project Banner](/public/assets/boss/cornelius-banner.webp)