HooYooTracker is a web application that scrapes Genshin Impact and Zenless Zero codes from various sources and compiles them into one organized list. This app can be run on Windows, macOS, or Linux.

The app is run locally and is built with TypeScript, with frameworks using React and TailwindCSS for the app interface and Cheerio, Axios, and Express.js for scraping and easy access API endpoints.

• Node.js (version 22.13.0 or higher)
• Windows, macOS, or Linux

1. Install Node.js.

2. Open your terminal.

3. Clone this repository:

   git clone https://github.com/Scoofszlo/HooYooTracker.git

4. Run the start script:

   npm run start

   This script will install dependencies, build the frontend and backend, and start the servers.

5. After installation, open the HooYooTracker interface in your browser at http://localhost:4173.

To start, just run the start script in the terminal:

npm run start

On the very first run, it will install dependencies and build the frontend and backend, which might take a while so please be patient. On subsequent runs, it will be very fast as it will skip straight to starting the servers.

After the servers are running, you can access the app in your browser at http://localhost:4173 to view the latest codes. If the address is not accessible, use the address shown in the terminal that has this line:

[WEB]   ➜  Local:   http://<address>:<port>/

To stop the app, simply press Ctrl + C a few times in the terminal.

To refetch the latest codes, simply click the refresh button on the right side of the "List of Codes" header. This will trigger the backend to scrape the sources again and update the list with the latest codes.

To change the theme of the app, just click the night button on the navbar located at the upper right side of the browser interface.

Yes, it will work offline. However, you need to be connected to the internet just once to fetch the codes which will then be stored into your browser's local storage. After that, you can view the codes even when you're offline.

No, this app is designed to be run only in desktop running Windows, macOS, or Linux, although the design is already responsive for smaller screens.

Currently, I have no plans to support other games. However, I might consider it in the future.

The old one actually works even until today without updates. However, I decided to not continue updating it because the code is a lot messy in there. Refactoring could take a while. Plus, I want to retain the learnings I got from building our school project that involves React + TypeScript + Node.js and wanted to learn more about some design architecturing, so I decided to build a new one from scratch using this stack. I feel like this new version is way way better and is easier to maintain.

If you are a developer and want to contribute to the development of HooYooTracker, you can follow these steps:

1. On the project root, install the dependencies:

   npm install

2. Start the development server:

   npm run dev

   This will start both the frontend and backend development servers with hot reloading working so that you can see your changes real-time.

3. Make your changes and test them in the browser.

4. Once you're satisfied with your changes, you can commit and push them to your forked repository.

5. Finally, create a pull request for review.

HooYooTracker uses standard project versioning policy. Minor version is bumped for every new feature added, while patch version is bumped for bug fixes and minor changes. Major version is bumped for breaking changes.

HooYooTracker is licensed under the MIT License. See the LICENSE file for more details.

For questions or concerns, feel free to contact me via the following!:

• Gmail - [email protected]
• Discord - @scoofszlo
• Reddit - u/Scoofszlo
• X - @Scoofszlo