Fortnite Panel

All‑in‑one desktop dashboard for Fortnite – track stats, shop rotations, and match history in real time.

---

What is Fortnite Panel?

Fortnite Panel is a lightweight desktop application that gives you instant access to:

• Live statistics (wins, kills, K/D, win rate) for any player
• Daily / weekly item shop with prices and rarity
• Current season details – battle pass progress, challenges
• Match history with detailed breakdowns
• Friend activity – see who's online and what they're playing

Built with modern web technologies, it runs on both Windows and macOS without any external dependencies.

---

Features

Feature	Description
Player Stats	Search any Epic username – view overall and per‑season stats
Shop Viewer	Live item shop with V‑Buck prices, rarity colors, and release dates
Season Tracker	Current season level, battle pass tiers, and weekly challenge progress
Match History	Last 20 matches with eliminations, placement, and weapon usage
Friend List	See online friends, their current mode, and party status
Dark / Light Theme	Toggle between themes – eye‑friendly for day and night
Auto‑Refresh	Updates every 5 minutes while the app is open
Cross‑Platform	Runs on Windows 10/11 and macOS 11+ (Intel + Apple Silicon)

---

Requirements

• Windows 10 / 11 (64‑bit) or macOS 11+ (Intel / M1/M2)
• Internet connection (to fetch data from Epic Games API)
• No additional software needed – the app bundles everything

Linux is not officially supported, but you may run the source code with Node.js.

---

Installation

1. Click the button above or go to Releases
2. Download the installer for your OS:
   • FortnitePanel-Setup.exe for Windows
   • FortnitePanel.dmg for macOS
3. Run the installer – on Windows, if SmartScreen appears, click More info → Run anyway
4. Launch the app and start exploring Fortnite data instantly

---

How it works

The application follows a simple pipeline:

1. Launch – Electron shell starts and loads the main user interface.
2. Read configuration – Loads saved preferences (username, theme, refresh interval) from local storage.
3. On startup or manual refresh:
   • Query Epic Games public API (via Fortnite-API.com or official endpoints) to fetch:
     • Player statistics (overall and per‑season)
     • Current item shop with prices and rarity
     • Season information (battle pass, challenges)
     • Match history (last 20 matches)
   • Cache all responses locally with a 5‑minute time‑to‑live (TTL) for offline viewing.
4. Render data – Display everything in a clean, responsive dashboard.
5. Listen for user actions – Search for new players, toggle dark/light theme, or force a manual refresh.
6. Logging – All API calls and errors are written to a local log file for debugging purposes.

---

Project Structure

The source code is organised as follows:

• src/main/ – Electron main process files.

  • main.js – Application entry point.
  • api.js – Fortnite API client (stats, shop, seasons, etc.).
  • cache.js – In‑memory caching layer with TTL.
  • logger.js – Logging utility.

• src/renderer/ – Frontend (HTML, CSS, JavaScript).

  • index.html – Main dashboard page.
  • style.css – Dark and light theme styles.
  • app.js – UI logic and state management.
  • assets/ – Icons, fonts, and other static resources.

• src/preload/ – Preload scripts for secure IPC communication.

• resources/ – Application icons and preview image.

  • icon.icns – macOS icon.
  • icon.ico – Windows icon.
  • preview.png – Repository social preview.

• .github/workflows/ – CI configuration.

  • build.yml – Builds installers for Windows and macOS.

• Root files: package.json, LICENSE, README.md.

---

FAQ

Q: Do I need a Fortnite account to use this panel?
A: No. You only need a username to look up stats – no login required.

Q: Is the data real‑time?
A: The app refreshes every 5 minutes by default. You can manually refresh at any time. Data comes from Epic's public API, so it's as accurate as the official game.

Q: Does this app store my data?
A: Only locally – your search history and theme preference are saved on your machine. No data is sent anywhere else.

Q: Can I use it offline?
A: The app caches the latest data, so you can view previously fetched stats without internet, but fresh data requires a connection.

Q: Is there a portable version?
A: Yes – the Windows build includes a portable .exe that doesn't require installation. Grab it from the releases page.

---

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/your-feature
3. Commit your changes
4. Open a Pull Request

---

License

Distributed under the MIT License. See LICENSE for details.

---

_{Made for Windows & macOS · Fortnite data at your fingertips · Open Source}