# Browser playground — user instructions

**Product:** FX Options Playground  
**Book:** *FX Options: Pricing, Hedging, Exotics, Risk and Institutional Practice*  
**URL:** https://rondanini.com/fxoptionsplayground  
**Support:** fxoptions@rondanini.com

---

## What this is

An in-browser coding environment that runs the same worked-example scripts shipped with the book. No Python install is required. Code runs locally in your browser (Pyodide); it does **not** call live market data.

---

## First-time access

1. Complete purchase (book bundle, standalone playground, or redeem proof of book purchase).
2. Open https://rondanini.com/fxoptionsplayground
3. Sign in with the account email used at checkout (or the entitlement code from the product email).
4. If the gate rejects the login, wait a few minutes for entitlement sync, then retry. Still blocked? Email **fxoptions@rondanini.com** with your order ID and the email used at purchase.

Access notes published with the product:

- Book + playground bundle and standalone playground SKUs are sold on rondanini.com storefronts.
- Proof-of-purchase discounts may apply — follow the redemption link in your confirmation email.

---

## How to run an example (parametrise by default)

1. From the home screen, choose a **chapter**, or search for a worked-example ID (`WE-8.1`, `WE-9.4`, …).
2. Open the example. Book defaults load into the **Parameters** panel (or **Editable source** if the script has no structured inputs).
3. **Change at least one input** (spot, strike, vol, …) unless you only want to reproduce the printed case.
4. Click **Run with my parameters**.
5. Read the console / result panel.
6. Optional: **Reset to book example**, then **Download .py** or the full ZIP.

### Validation after you change inputs

Asserts that compare to printed book figures may fail once you change parameters. That is expected — you are exploring, not only checking the book reprint.

### From a printed QR or “Scan for code” link

1. Scan the QR (or open the toolkit URL printed in the worked example).
2. Sign in if prompted.
3. Confirm the example title matches the book section.
4. Adjust parameters if desired, then **Run**.

If the QR opens an unexpected example, note the book page + example number and email **fxoptions@rondanini.com**.

---

## What “good” looks like

- The script finishes without a red error banner.
- Output numbers match the book (or the printed correction / companion note) within normal rounding.
- Monte Carlo examples use a fixed seed — re-running should reproduce the same printed range.

---

## Common issues

| Symptom | What to try |
|---------|-------------|
| Sign-in but empty catalogue | Hard-refresh the page; try another browser; confirm entitlement email |
| Run button disabled | Wait for the runtime to finish loading (first visit can take ~30–60s) |
| `ModuleNotFoundError` / import error | Refresh; if it persists, report the example ID |
| Numbers disagree with the book | Check you opened the correct WE-ID; then report both book figure and playground output |
| Page blank on mobile | Use a recent Chrome/Safari desktop session for heavy Monte Carlo examples |

---

## Coverage

- **193** worked examples (Chapters **4** and **8–30**)
- Chapters **1–3** and **5–7**: explained in the book without playground scripts

Catalogue details are also in the download package file `manifest.json`.

---

## Privacy & offline behaviour

- Examples use **embedded / illustrative inputs** only (no live feeds).
- Prefer a current browser; disable aggressive script blockers for rondanini.com if the runtime fails to load.

---

## Report a problem

Email: **fxoptions@rondanini.com**

Subject line suggestion: `[Playground] WE-X.Y — short description`

Include: example ID, browser + OS, whether you used QR or catalogue, order/account email, and a screenshot of the error.

Other contacts:

- Education / content: education@rondanini.com  
- General support: support@rondanini.com  
- Site: https://education.rondanini.com