stardew-tracker/README.md

# Valley Yearbook

A small, shared tracker for the first two years of Stardew Valley. It combines:

- the standard Community Center bundles;
- crop growth times and last safe planting dates;
- birthday previews and gift tips, festivals, seasonal events, and weekly reminders; and
- one server-side checklist that stays in sync across phones and computers.

Every actionable card and checklist row uses the same shared checkbox behavior. Date and season selection remain local to each device, so two players can look at different days without moving each other's calendar.

Community Center filters distinguish all unfinished items, items available in the selected season, season-exclusive items, and fish that require a rain or sun window. Choose-N bundles stop treating unused alternatives as required once their target is met.

The app is deliberately dependency-free at runtime: Python's standard library serves the site and stores progress in SQLite. Nginx/Authelia are expected to provide the public access boundary.

## Run locally

```sh
python3 app.py --database /tmp/stardew-progress.sqlite3
```

Then open `http://127.0.0.1:8089`.

## NixOS module

Add this repository as a flake input, import `nixosModules.default`, and enable:

```nix
services.stardew-tracker.enable = true;
```

The service listens on loopback port `8089` by default and stores its SQLite database in `/var/lib/stardew-tracker`.

When proxying through Nginx, protect the complete origin with Authelia and pass its authenticated username as `Remote-User`. Progress is shared by everyone who can access the site; the username is retained only as lightweight update metadata.

## Data scope

The planner targets Stardew Valley 1.6 and standard bundles, not remixed bundles. Calendar and bundle data is based on the [Stardew Valley Wiki calendar](https://stardewvalleywiki.com/Calendar); birthday gift suggestions use its [gift reference](https://stardewvalleywiki.com/List_of_All_Gifts).

Stardew Valley is © ConcernedApe. This is an unofficial fan-made utility and includes no game art or assets.