PLAN.md

Tokenforge Plan

Goals

• Make Tokenforge feel like a premium, fast dashboard for multi‑provider usage + cost.
• Keep the app local‑first with optional serverless proxy for live pulls.
• Preserve neutral, light‑first theming with clean card layout and strong hierarchy.

Near‑term improvements (high impact)

• Add a left nav or top tabs (Overview / Providers / Models / Imports / Settings).
• Add a time‑series chart (tokens + cost) using lightweight SVG (no heavy chart libs).
• Add provider health indicators (last pull, errors, missing cost data).
• Improve empty states with guided CTAs (Add provider, Import CSV, Use sample).
• Add quick filters (provider, date range, cost vs tokens) + clear reset.
• Improve export UX (export current filters, include summary footer).

Data + ingestion

• Add a local proxy endpoint for OpenAI/Anthropic pulls to avoid CORS.
• Support Gemini CSV presets for multiple export formats (AI Studio + Billing).
• Normalize project/workspace naming and allow user-defined labels.
• Add a “dedupe preview” when importing large CSVs.

Security + storage

• Default to session‑only API keys with a “remember locally” toggle.
• Add a warning banner when keys are stored in localStorage.
• Add a “wipe local data” button with confirmation modal.

Analytics + insights

• Budget thresholds with alerts (daily/weekly/monthly).
• Cost breakdown by provider/model/project with % share.
• “Top deltas” view: week‑over‑week change.

Testing + quality

• Add RTL flow test for provider add → import CSV → summary updates.
• Add unit tests for CSV preset mapping edge cases.
• Add CI workflow (test + build) on push.

Nice‑to‑have

• Snapshot sharing (export a static HTML report).
• Personalization: customizable dashboard cards.
• “Pinned” model/provider comparisons.