# Parcel Empire Phase 5.0 Beta Testing Checklist

Use this list when testing the beta build on desktop, laptop, iPhone, Android, and tablet.

## Setup

- Run through `localhost` or HTTPS. GPS and PWA features may not work from `file:///`.
- Open `beta.html` first.
- Open `dashboard.html` to test the main game.
- Allow location permission when asked.
- Hard refresh after replacing files.

## Core gameplay

- [ ] Map loads without the Mapbox error panel.
- [ ] GPS button moves the camera to the player.
- [ ] Buy-range circle appears around GPS location.
- [ ] Player can tap a parcel.
- [ ] Parcel card updates with parcel ID, price, and range state.
- [ ] Player can buy an in-range parcel.
- [ ] Out-of-range parcel cannot be bought.
- [ ] Rarity reveal appears after purchase.
- [ ] Rent and parcel count increase.
- [ ] Owned parcel appears in My Land.

## Daily gameplay

- [ ] Daily checklist opens.
- [ ] Claim Rent button works.
- [ ] Login reward calendar displays.
- [ ] Daily Spin opens and spins once per day.
- [ ] Free parcel token, if won, works on an in-range parcel.

## Retention and progression

- [ ] XP increases from normal actions.
- [ ] Level-up popup appears when threshold is reached.
- [ ] Achievement popup appears for first parcel.
- [ ] Tutorial can be replayed from More.

## Safety and rewards

- [ ] Safety screen shows GPS trust score.
- [ ] Cashout screen shows locked/eligibility rules.
- [ ] Real payout controls remain locked unless deliberately configured.
- [ ] Ads panel shows demo/simulator mode.

## Visuals and responsiveness

- [ ] UI fits on a laptop screen.
- [ ] UI fits on mobile portrait.
- [ ] Bottom nav scrolls/works on mobile.
- [ ] More → Map Visuals settings save correctly.
- [ ] No panels overlap the BUY LAND button badly.

## Reporting

For bugs, open `beta.html`, fill the bug report, then copy or download the JSON report. Include a screenshot or screen recording when possible.


## Phase 5.2 Feedback Tracker

- Open `beta-feedback.html`.
- Add at least one feedback item.
- Filter issues by priority and status.
- Export JSON and CSV.
- Import a JSON feedback file if needed.


## Phase 5.4 performance pass

- [ ] Open the game and confirm the map loads.
- [ ] Buy/inspect parcels and open all main panels.
- [ ] Open `beta-performance.html`.
- [ ] Confirm no JavaScript errors are logged.
- [ ] Confirm map canvas was detected.
- [ ] Export the performance JSON for any serious bug report.


## Production setup checks

- [ ] Open `beta-production.html`.
- [ ] Complete production readiness checklist.
- [ ] Confirm Supabase production keys are configured only when ready.
- [ ] Confirm payout and real ad flags are locked for beta.


## Phase 5.7 Final QA

- [ ] Open `beta-qa.html`.
- [ ] Run Full QA.
- [ ] Fix any failures.
- [ ] Export QA JSON and keep with release notes.
- [ ] Test GPS buying on at least one mobile device.
- [ ] Test PWA install/uninstall or service-worker unregister.