Dev environment lives in .venv at the repo root

This commit is contained in:
spoopyghosty0 committed 2026-09-29 12:50:54 -04:00
1 parent 182b3ad5fb
commit 69889f0ad8
2 files changed
+3 -3

No files matched your search

+1 -1
View File
@@ -6,7 +6,7 @@ description: Port a Meta Quest standalone game (APK + OBB dump) to the Valve Ste
# Port a Quest game to the Steam Frame
Work from the repo root (`frameport/`). Read `CLAUDE.md` (facts) and `docs/PLAYBOOK.md` (symptom → fix) first.
Set `UV_PROJECT_ENVIRONMENT=~/.cache/frameport-venv` (the repo is on NTFS).
The dev environment is `.venv` in the repo root (`UV_LINK_MODE=copy uv sync --extra dev` if it's missing).
## 1. Setup (once)
```
+2 -2
View File
@@ -32,8 +32,8 @@ Read `docs/PLAYBOOK.md` (symptom → fix) before debugging a game, and `docs/FRA
## Dev commands
```
export UV_PROJECT_ENVIRONMENT=~/.cache/frameport-venv # keep the venv off NTFS (repo lives on D:)
uv sync --extra dev # or: uv pip install -e .[dev]
# the dev venv is .venv in the repo root (git-ignored); on the NTFS drive uv needs UV_LINK_MODE=copy
UV_LINK_MODE=copy uv sync --extra dev # creates/updates ./.venv
uv run pytest # unit tests (no device, no game files)
uv run frameport --help # CLI; uv run frameport-gui for the GUI
uv run frameport parity --known-good <PATCHED/_known-good-*> --sources "<VR CyberDeck downloads>"