Adaptive leadership assessment tool for 1PWR Africa
# 1PWR Leadership Assessment
Single-page React assessment (`src/App.jsx`). Run locally or deploy the static build to any host.
## Where is the UI hosted?
| Environment | URL | Notes |
|-------------|-----|--------|
| **1PWR production (EC2 + Caddy)** | **
cc.1pwrafrica.com | Primary cloud UI for the team. Deploy steps: DEPLOY.md. |
| **GitHub Pages** |
mso9999.github.io | Serves the **`gh-pages`** branch (Vite `dist/`). The home screen is the domain grid (“dashboard”); use **`#start`** to open the first question:
mso9999.github.io — Redeploy with `npm run deploy:gh-pages` after changes. |
The Vite app in this repo (`npm run build` → `dist/`) is the bundled React assessment. The older single-file build under `public/index.html` may still be used by some deployments; prefer updating EC2 with `dist/` contents if you want the latest Vite build live at `/assessment/`.
## Question bank quality (POE)
Scenario items are vulnerable to **pattern matching** (e.g. longest option) if distractors are weak. The app **shuffles** options at display time; item authors should still keep distractors **plausible** and **similar length** where possible. Run:
```bash
npm run audit:questions
```
to list rows where the keyed answer is still much longer than alternatives (review queue).
## Local
```bash
npm install
npm run dev
```
Open the URL Vite prints (usually `
localhost`).
## Cloud (GitHub Pages)
1. Push this repo to GitHub.
2. **Settings → Pages → Build and deployment → Source:** GitHub Actions.
3. Push to `master` or `main` (or run the workflow manually). The Deploy to GitHub Pages workflow builds with `npm run build` and publishes `dist/`.
Your site URL will be:
`https:// .github.io/ /`
(For a user/org site named ` .github.io`, set `base: '/'` in `vite.config.js` instead of `./`.)
## Other hosts
`npm run build` outputs `dist/`. Upload that folder to Netlify, Vercel, Cloudflare P …