Local Development Setup¶
Run the BigRAE portal locally for development.
Prerequisites¶
- uv
- Node 20.19 or later, with npm
First run¶
- Install the platform dependencies:
- Build the SPA so that Django can serve it:
- Prepare the local database and start the server:
The portal runs at http://localhost:8000. TESTING=1 selects the test posture:
DEBUG on and a SQLite database in shifter/shifter_platform/db.sqlite3.
Sign in at http://localhost:8000/dev-login/. Development login works only in a
development posture and only from a loopback or allowed admin address.
Tests and checks¶
Use the command matrix for every test, lint and policy command. It names the local command and the CI job for each lane.
Troubleshooting¶
- Port in use: check with
lsof -i :8000, or start on another port withTESTING=1 uv run python manage.py runserver 8001. - Missing dependencies: run
uv sync --group devagain fromshifter/shifter_platform.