## supply cart

install uv: [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/)

get a FIO API key from [https://fio.fnar.net/settings](https://fio.fnar.net/settings) and create a `config.toml` like:

    username = 'raylu'
    fio_api_key = 'uuid_here'
    punoted_api_key = ''

    [market.mm_items]
    TCL = 0

    [supply.promitor]
    ignore_materials = ['RAT']

`uv run supply.py promitor`

---

## Local Development

To work on the frontend (`ts/` directory) and test your changes locally, you will need to install **Bun** (the project's JavaScript runtime and bundler) in addition to `uv`.
install bun: [https://bun.sh/docs/installation](https://bun.sh/docs/installation)

To generate the backend data, compile the frontend, and serve the site locally, execute the following commands from your terminal:

1. **Generate the Backend Data:**
   Use `uv` to execute the Python script in its isolated environment (this utilizes `cbor2` for efficient API caching).

       uv run roi.py

2. **Install Frontend Dependencies:**
   Populate the `node_modules` directory with the required JavaScript libraries.

       bun install

3. **Build the Frontend:**
   Compile the TypeScript files into browser-ready JavaScript within the `www/` directory.

       bun run build

4. **Serve Locally:**
   Navigate into the web directory and spin up a local development server to view your changes at `http://localhost:8000`.

       cd www
       python3 -m http.server 8000