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.
- Host: GitHub
- URL: https://github.com/guysuvijak/fireball-tl
- Owner: guysuvijak
- License: mit
- Created: 2024-10-27T16:18:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-05T16:35:19.000Z (over 1 year ago)
- Last Synced: 2025-03-20T09:36:52.536Z (over 1 year ago)
- Topics: client-side, frontend, guildmanagement, nextjs, no-database, open-source, static-site, throneandliberty, typescript, website
- Language: TypeScript
- Homepage: https://fireball-tl.vercel.app
- Size: 5.1 MB
- Stars: 17
- Watchers: 1
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README

# 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](https://fireball-tl.vercel.app)




## π 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 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
```

## π 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.
```

## π 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. :heart:
β If you like this project, please consider giving it a star on GitHub to show your support and encouragement! π
