EXPLORE SIMULACRA TOWN.
BATTLE UX FRICTION.
EARN USABILITY CRESTS.
Ditch brittle selectors. Dispatch an autonomous party of 16-bit RPG townspeople to explore your web application, discover cognitive friction traps, rage-click deceptive buttons, and award ISO-standard System Usability Scale (SUS) Crests.
HOW THE SIMULACRA ENGINE WORKS
SIMULACRA TOWN RESIDENTS
Synthetic personas inhabit a full 2D retro RPG town with the Guild UAT Lab, Town Hall Archives, and cottages. Personas wander, voice thoughts in emote bubbles, and receive testing dispatches.
RETRO COMBAT BATTLE SCREEN
When an audit launches, personas battle your web application in turn-based combat! Real actions trigger combat damage (💥 JITTER CLICK!, ⚡ A11Y AUDIT!), draining website friction HP.
HEADLESS PLAYWRIGHT BROWSER TELEMETRY
Behind the retro 16-bit aesthetic is a rigorous enterprise Playwright fleet with human typing delays (25-65ms), reading hesitations, screenshot capture at every milestone, and strict SQLite ACID event logging.
INTERACTIVE SIMULACRA TOWN MAP
Click on the town canvas or click the direction buttons to walk the UAT Trainer around!
RETRO UAT BATTLE SIMULATOR
Select battle commands below to audit the target website and deplete its UX Friction!
What will SARAH JENKINS do to audit this web application?
EARN ALL 8 USABILITY CRESTS
Audit campaigns award verified crests when your application meets strict cognitive usability thresholds.
Awarded when personas navigate the entire critical flow and complete their primary business goal.
Evaluates System Usability Scale. Requires industry Grade B or above across synthetic customer feedback.
Recognizes seamless transitions without hesitation pauses or dead-end layout shifts.
Earned when keyboard navigation, focus management, and screen-reader ARIA trees pass inspection.
Zero deceptive, unresponsive, or delayed click targets registered during mobile testing.
Flawless execution on mobile viewports (390x844) without broken tap targets or side-scrolling.
Resists boundary-condition attacks, special characters, and form fuzzing by senior dev personas.
Full compliance with Systems Engineering Anti-Mirage Invariants and SQLite persistence.
MEET THE SYNTHETIC AUDITORS
SARAH JENKINS
"If a website asks me to fill out five separate pages just to see a price, I close the tab immediately. I need buttons that actually look like buttons, not invisible grey text!"
COMPREHENSIVE DEPLOYMENT GUIDE
Deploy the Next.js visual 16-bit RPG studio, headless Playwright runner, or Docker containers.
CLONE GUILD LAB & SETUP PYTHON ENVIRONMENT
Ensure Python 3.11+ and Node 20+ are installed on your workstation.
git clone https://github.com/MuzikayiseKhuzwayo/simulacra-uat-tester.git
cd simulacra-uat-tester
python -m venv venv
# Windows:
.\venv\Scripts\activate
# Linux/macOS:
source venv/bin/activate
INSTALL REQUIREMENTS & CHROMIUM BROWSER
Install all backend Python requirements and Playwright headless browser engines:
pip install -r requirements.txt
playwright install chromium
INSTALL FRONTEND NEXT.JS 15 DEPENDENCIES
Install Next.js, React 19, and Tailwind CSS dependencies in frontend/:
cd frontend
npm install
cd ..
LAUNCH UNIFIED FULL STACK WITH ONE COMMAND
Launches FastAPI Backend (port 8000), Next.js RPG Studio (port 3000), and Demo Target (port 8585):
python run_dev.py
• FastAPI REST Docs: http://127.0.0.1:8000/docs
• Offline Target App: http://127.0.0.1:8585
FREQUENTLY ASKED QUESTIONS
python -m src.simulacra.cli) with zero display requirements, generating markdown briefs and excel spreadsheets automatically.
READY TO AUDIT YOUR WEB APP?
Deploy Simulacra UAT locally or connect it to your automated GitHub Actions CI/CD pipeline today.