For Developers

For Developers

TestLab 29119 is a static web application with no build step and no backend.

---

Architecture

flowchart TB
  subgraph browser [Browser]
    HTML[index.html]
    CSS[css/style.css]
    Data[js/data.js]
    Main[js/main.js]
    LS[localStorage]
  end
  HTML --> Data
  Data --> Main
  Main --> LS
  HTML --> CSS

Loading

File	Responsibility
index.html	UI shell, screens, onclick handlers
js/data.js	Techniques, scenarios, scoring constants, tutorial
js/main.js	Game state, navigation, scoring, audio, certificate
css/style.css	Themes, layout, phase styles

Design pattern: Content (data.js) is separated from logic (main.js). Global GameState object holds runtime state.

---

Local development

git clone https://github.com/ismaiidogan/TestLab-29119.git
cd TestLab-29119
npm install
npm start

Open http://localhost:3000.

npm scripts

Script	Command	Purpose
start	npx serve . -p 3000	Local static server
test	playwright test	Smoke + screenshot tests

---

Testing

Playwright end-to-end tests live in tests/:

• smoke.spec.js — welcome, tutorial, glossary

Run: npm test

---

Extending content

To add a Phase 2 scenario, edit PHASE2_SCENARIOS in js/data.js and ensure SCORING.phase2.maxScore equals the sum of scenario points values.

To add a technique to Phase 1, add an entry to both TECHNIQUES and PHASE1_CARDS, then update SCORING.phase1.maxScore (15 × 6 + 20 bonus).

---

Persistence keys

Key	Purpose
testlab-best	Highest total score
testlab_leaderboard	Top scores (local)
testlab_theme	light or dark

---

Related pages

• Deployment
• Home