Change settings

README.md

@@ -1,16 +1,29 @@
-# Asset Choice Simulation (React + Vite)
+---
+title: Asset Choice Simulation
+emoji: 📈
+colorFrom: gray
+colorTo: blue
+sdk: static
+pinned: false
+---
 
-Interactive simulation where users pick daily assets and evaluate portfolio performance.
+Interactive web app to elicit asset preferences and risk tolerance:
+- Shows **all assets on one chart** (last 7 days visible at start).
+- User picks **one asset per day** (via line click, legend, or hotkeys).
+- App rolls forward one day and logs **next-day return**.
+- After 60 picks (to day 67), shows **Final Summary** (metrics, preference ranking, heatmap) and auto-downloads a **run summary JSON**.
 
-## Run locally
-```bash
-npm install
-npm run dev
-```
+## How to use (in this Space)
+1. If provided, click **Load Example** to generate a randomized 5-asset, 67-day dataset.
+2. Or **Upload JSON** with historical series (format below).
+3. Click a line (or press `1..N`) to select; press **Confirm & Next Day** (or hit **Enter**).
+4. Review the **Portfolio** and **Daily Selections** panels as you go.
+5. After the last pick, the app auto-saves to `localStorage` and downloads:  
+   `run_summary_YYYY-MM-DD.json`
 
-## Build
-```bash
-npm run build
-```
-
-Deploy to [Hugging Face Spaces](https://huggingface.co/spaces) as a Static Space.
+## JSON data format (upload)
+```json
+{
+  "TICK1": [{"date": "2024-01-02", "close": 101.23}, ...],
+  "TICK2": [{"date": "2024-01-02", "close": 87.50}, ...]
+}