Documents
README.md
Project overview, quick start (file:// and bundle), embed instructions, controls summary, and file structure.
Open README.md →
ARCHITECTURE.md
Module responsibilities, layout, auto mode, game state machine, grid layer, dependency graph, and canvas layers.
Open ARCHITECTURE.md →
DEVELOPMENT.md
Bundle workflow, config reference, customization, deployment checklist, troubleshooting, and version history.
Open DEVELOPMENT.md →
help.html
Player-facing guide: controls (including auto mode), scoring, combos, strategy tips, and FAQ.
Open help.html →
Quick Reference
Live URL
linhtruong.com/game/tetris
Entry Point
Browser loads index.html → js/app.js (bundled IIFE). Works over file:// — no server required for players.
Source modules in js/*.js (except app.js) are ES modules. After editing, run node scripts/bundle.js.
Key Config File
js/config.js — board size, timing (DAS, lock delay), scoring, drop speeds, game states.
Project Tree
Tetris/
├── index.html
├── help.html
├── README.md
├── docs/
│ ├── index.html ← you are here
│ ├── ARCHITECTURE.md
│ └── DEVELOPMENT.md
├── css/
│ ├── style.css
│ └── help.css
├── scripts/
│ └── bundle.js builds js/app.js
└── js/
├── app.js bundled runtime (index.html loads this)
├── main.js bootstrap (dev / module mode)
├── tetris.js game engine
├── board.js board state
├── grid.js shared grid helpers (board + AI)
├── auto.js auto-play AI
├── board-scaling.js responsive canvas sizing
├── piece.js tetrominoes & SRS
├── config.js constants
├── scoring.js points & high score
├── das.js horizontal input
├── lock-delay.js lock timer
├── renderer.js canvas drawing
├── particles.js effects
├── ambience.js background
├── presentation.js DOM effects
├── ui.js UI controller
├── controls.js keyboard/touch
└── audio.js sound & music
Local Development
Play / test production build
# Double-click index.html, or:
open index.html
Edit source and rebuild
# After changing js/*.js (not app.js):
node scripts/bundle.js
# Then refresh index.html
Optional: ES module dev server
Temporarily point index.html at js/main.js with type="module", then serve over HTTP:
cd Tetris
python3 -m http.server 8080
# Open http://localhost:8080