# BOX Unity App Notes

Date: 2026-06-11

This folder is reserved for the BOX Unity app.

The public site currently uses a dependency-free JavaScript canvas simulator in `../simulator.js` as the first visual preview. It is not the Unity app. It exists so `box.zweichain.net` can show the model-arena loop before the real Unity or WebGL source arrives.

## Web display path

1. Current: low-resolution JavaScript canvas simulator on `index.html`.
2. Next: import the boxing match sample app source as a reference.
3. Later: export a Unity WebGL build into a separate publish folder such as `unity-webgl/`.
4. Site: replace or supplement the JavaScript simulator with a link or embedded WebGL build only after file size, loading, mobile behavior, and model-arena data flow are clear.

## First app shape

Build the first Unity prototype around matching and a single drill loop:

1. Profile scene
   - Fighter profile.
   - Coach profile.
   - Gym profile.
   - Consent and public/private flags.

2. Matching scene
   - Match score between fighter, coach, gym, and sparring needs.
   - Reasons displayed in plain language.
   - Safety constraints shown before any contact recommendation.

3. Training scene
   - One boxer avatar.
   - One coach view.
   - One footwork drill.
   - Simple score for distance, stance recovery, rhythm, and guard position.

4. Replay scene
   - Timeline replay.
   - Coach notes.
   - AI drill recommendation.
   - Exportable session summary.

## Suggested MVP data

Use local JSON first:

- `fighter_profiles.json`
- `coach_profiles.json`
- `gym_profiles.json`
- `drills.json`
- `match_requests.json`
- `match_results.json`

Only connect accounts, payments, or token wallets after the matching loop and consent model are stable.

## Unity project note

When the actual Unity project is created, keep large generated folders out of source tracking unless this workspace has an agreed `.gitignore`.

Likely ignored directories:

- `Library/`
- `Temp/`
- `Obj/`
- `Build/`
- `Builds/`
- `Logs/`
- `UserSettings/`

## Prototype acceptance check

The first demo is good enough when it can show:

- one boxer profile,
- one coach profile,
- one gym profile,
- one clear match score,
- one recommended drill,
- one Unity ring/training scene,
- one replay summary that a real coach can critique.