P5Tracker

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

★ 10 Open GitHub ↗

A tracker for Persona 5 Royal

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# P5 Tracker

**[👉 Open the Live Tracker](https://zucram.github.io/P5Tracker/)**

A modern, mobile-first companion app for **Persona 5 Royal**.

This interactive tracker helps you optimize your playthrough with a "Soft-Guide" approach. Instead of a rigid day-by-day checklist, it provides monthly strategic objectives, ensuring you never miss a deadline while giving you the freedom to play your way.

## Support & Feedback

This project is currently in **Public Beta (v2.0)**.

If you find this tracker helpful for your heist, consider supporting the maintenance and future updates:

[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/K3K11RWTSL)

Feedback, bug reports, and strategy corrections are welcome via [GitHub Issues](https://github.com/zucram/P5Tracker/issues).

## Gallery

### Mobile Experience
<p float="left">
  <img src="docs/assets/mobile-home.png" width="30%" />
  <img src="docs/assets/mobile-confidants.png" width="30%" /> 
  <img src="docs/assets/mobile-tasks.png" width="30%" />
</p>

### Desktop Command Center
![Desktop Home](https://raw.githubusercontent.com/zucram/P5Tracker/master/docs/assets/desktop-home.png)

## Features

### 📅 Phantom Calendar
*   **Smart Timeline:** Tracks your current position in the game.
*   **Intelligent Backlog:** Automatically carries over important tasks (Confidants, Mementos requests) if you miss them in previous months.
*   **Missable Filter:** Hides expired date-specific events (like classroom answers) to keep your dashboard clean.

### 🎭 Confidant Command Center
*   **Rank Roadmap:** Visualizes exactly what rank you need to be at for every month to stay on track for a 100% run.
*   **Interaction Guide:** Built-in cheat sheet for every Confidant. Tap to see the best dialogue choices and gifts for your current rank.
*   **Gate Awareness:** Automatically warns you if your Social Stats are too low to progress (e.g., "⚠️ Blocked: Requires Guts Lv.4").

### ⚔️ Palace & Mementos Intel
*   **Dynamic Filtering:** Automatically shows the Palace and Mementos path relevant to your current game month.
*   **Will Seed Locator:** Step-by-step guides to find every Will Seed.
*   **Boss Strategy:** Key tips and recommended Personas for every major boss.

### 📖 Persona Registry
*   **Complete Database:** A fully searchable compendium of all 232 Royal Personas.
*   **Smart Tracking:** Filter by Arcana and track your collection percentage directly from the new Registry view.
*   **Metaverse Sync:** Catching a Persona in a Palace guide automatically marks it as 'Registered'.

### 🧠 Social Stat Dashboard
*   Track your Knowledge, Guts, Proficiency, Kindness, and Charm.
*   See real-time feedback on which stats are bottlenecking your relationships.

## 🚀 Future Roadmap

*   **Resources & Reference Hub:** Centralized links to proven 100% walkthroughs and a searchable Classroom/Exam/Crossword cheat sheet.
*   **PWA Support:** Full offline access and installable app experience for iOS and Android.
*   **Fusion Calculator:** Integrated tool for checking fusion recipes and skill requirements.

## Tech Stack

*   **Frontend:** React 19 + Vite
*   **Styling:** Tailwind CSS (Glassmorphism UI)
*   **Icons:** Lucide React
*   **Persistence:** Local Storage (Privacy-first, no server required)

## Getting Started

### Prerequisites
*   Node.js (v18 or higher)

### Installation

1.  Clone the repository:
    ```bash
    git clone https://github.com/zucram/P5Tracker.git
    cd P5Tracker
    ```

2.  Install dependencies:
    ```bash
    npm install
    ```

3.  Run the development server:
    ```bash
    npm run dev
    ```

4.  Build for production:
    ```bash
    npm run build
    npm run preview
    ```

## Project Structure

*   `src/App.jsx`: Main application logic and UI controller.
*   `src/data/gameData.js`: The "Brain" of the guide. Contains all monthly tasks, palace details, and mementos requests.
*   `src/data/confidantData.js`: Detailed interaction guides (Dialogue choices & Gifts).
*   `src/data/socialStats.js`: Stat requirements and gate logic.

## Credits

Based on the comprehensive strategic analysis of Persona 5 Royal's mechanics.
Data sourced from community experts (GameFAQs, Samurai Gamers, RPG Site) and cross-referenced for the "Royal" edition.

### Changelog
View the full history of updates in [CHANGELOG.md](CHANGELOG.md).

### Transparency
This project was built with the assistance of AI (Google Gemini) to handle architectural refactoring and data synthesis. The strategy content itself was compiled by browsing public guides and walkthroughs to curate the most "essential" optimization path for players.

---
*Take your time.*

P5Tracker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README