Files
buildpath/README.md
Valentin Haudiquet 50bd0d216d
All checks were successful
pipeline / lint-and-format (push) Successful in 5m2s
pipeline / build-and-push-images (push) Successful in 3m11s
readme: added readme
2026-02-04 19:49:25 +01:00

42 lines
1.4 KiB
Markdown

# BuildPath
a tool for League of Legends champions runes and build paths
https://buildpath.win
## Architecture
BuildPath is made of four components:
- a MongoDB document database
- `patch_detector`, a daemon which runs periodically to detect new League of Legends patch from official APIs
- `match_collector`, a daemon which runs periodically to collect matches from League of Legends challenger players on current patch, and generate statistics from those matches, saving them in the database
- `frontend`, which is a Nuxt.JS project hosting an API serving the statistics but also the full web frontend (Vue.JS)
## Development
### Getting started
Developing BuildPath requires Docker for a local MongoDB instance, and a NodeJS/npm installation.
BuildPath needs data to work, either for generating statistics in the `match_collector` or for the frontend.
In order to download a production snapshot with data, import them into a local MongoDB instance and re-generate champion statistics, just use:
```bash
node dev/scripts/setup-db.js
```
You can re-run the script to re-generate statistics, and it won't re-download data.
Afterwards, if you want to run the frontend:
```bash
cd frontend && npm run dev
```
### Code quality
Every subproject has `lint` and `format` targets:
```
npm run format # Format code
npm run lint # Run the linter
```
Please make sure those are run without errors before committing.