https://github.com/fccview/devil-fruits-tracker
Next application to keep track of devil fruit in a curated, spoiler free manner.
https://github.com/fccview/devil-fruits-tracker
Last synced: 4 months ago
JSON representation
Next application to keep track of devil fruit in a curated, spoiler free manner.
- Host: GitHub
- URL: https://github.com/fccview/devil-fruits-tracker
- Owner: fccview
- Created: 2025-03-15T20:30:18.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-16T09:07:31.000Z (about 1 year ago)
- Last Synced: 2025-03-16T10:18:56.342Z (about 1 year ago)
- Language: TypeScript
- Homepage: https://fruitsbychapter.vercel.app
- Size: 51.2 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# One Piece Devil Fruit Tracker
## Support the Project
This project is open source and completely free to use. If you find it helpful, please consider supporting its development by contributing to the codebase, curating the data or simply giving a small donation:
## About
A comprehensive tracker for One Piece Devil Fruits that allows you to:
- View devil fruits by chapter/episode number
- Search and filter fruits by various criteria
- Avoid spoilers based on your reading/watching progress
- See detailed information about each fruit and its users
## Features
- **Progressive Content Reveal**: Only see information up to where you've read/watched
- **Dual Mode**: Switch between manga chapters and anime episodes
- **Advanced Search**: Filter by fruit type, name, or current owner
- **Spoiler Protection**: Carefully curated data to prevent spoilers
- **Responsive Design**: Works great on both desktop and mobile
- **Arc-based Filtering**: Filter fruits based on major story arcs
## Requirements
- Node 20+
- Yarn
## Getting Started
1. Clone the repository:
```bash
git clone git@github.com:fccview/devil-fruits-tracker.git
```
2. Install dependencies:
```bash
cd devil-fruits-tracker
yarn install
```
3. Add your MongoDB URI to `.env.local`:
```
MONGODB_URI=
LATEST_CHAPTER=
LATEST_EPISODE=
```
4. Populate the database and download latest images:
```bash
yarn populate:fruits
yarn populate:owners
yarn download:images
```
5. Run the development server:
```bash
yarn dev
```
## Database Setup
The project uses MongoDB to store devil fruit and owner data. To populate your database:
1. Ensure your MongoDB instance is running
2. Check the data files in `scripts/data/`:
- `fruits.json`: Devil fruit information
- `owners.json`: Character information
3. Run the population scripts:
```bash
yarn populate:fruits # Populates devil fruits collection
yarn populate:owners # Populates owners collection
```
## Contributing
We welcome contributions! Here's how you can help:
### Data Curation
The most valuable way to contribute is by helping maintain accurate spoiler data:
1. Check the `spoilers` array in fruit entries
2. Verify chapter/episode numbers for reveals
3. Ensure previous values are accurate
4. Submit PRs with corrections
### Spoiler Format
Each fruit entry can have multiple spoiler thresholds:
```json
{
"spoilers": [
{
"threshold": {
"chapter": 744,
"episode": 678
},
"previousValues": {
"description": "Pre-reveal description",
...
}
}
]
}
```
### Code Contributions
Please ensure your PR:
- Follows the existing code style
- Updates documentation as needed
- Maintains spoiler protection
## Acknowledgments
- Background artwork by [zzyzzyy](https://zzyzzyy.deviantart.com/)
- Code by [fccview](https://fccview.dev)
- All One Piece content and images are property of their respective owners