# AGENTS.md

## Repo Facts

- **Single-page app**: The entire dashboard is self-contained in `src/pages/index.astro` (~360 lines). It does not meaningfully use `Layout.astro` or `Welcome.astro` — those are leftover starter code and can be ignored or removed.
- **Bun** is the package manager (lockfile: `bun.lock`). Use `bun install` / `bun dev` / `bun build`.
- **No lint, test, or typecheck scripts** are defined in `package.json`. `tsconfig.json` extends `astro/tsconfigs/strict`.

## Token & API

- Dashboard fetches from a **hardcoded API base URL**: `https://bitfreedom.net/code/api/v1` (see `src/pages/index.astro:108`).
- Access token is passed as a query param: `?access_token=<token>&since=<ISO>`.
- Token is **injected at build time** via Vite `define` in `astro.config.mjs` (`ACCESS_TOKEN` → `import.meta.env.PUBLIC_ACCESS_TOKEN`).
- Set it in `.env` as `PUBLIC_ACCESS_TOKEN=...`. `.env` is gitignored.
- For deployments, the hosting platform must provide `PUBLIC_ACCESS_TOKEN` as a build env var.
- To change the API endpoint or token mechanism, edit `src/pages/index.astro`.

## Commands

```
bun install       # install deps
bun dev           # dev server at localhost:4321
bun build         # static output → dist/
bun preview       # serve dist/ locally
```

## Structure Notes

- `src/pages/index.astro` — the only meaningful page. Inline styles, inline JS, ApexCharts via CDN.
- `src/layouts/Layout.astro` and `src/components/Welcome.astro` — unused starter code.
- `public/` — only `favicon.ico` and `favicon.svg`.
- `.playwright-mcp/` — contains Playwright MCP artifacts (screenshots, page yamls); not part of the app.