gridfall
v0.0.1
Published
A modern, terminal Tetris-like built with React and Ink.
Readme
Gridfall
A modern, terminal Tetris-like built with React and Ink.
- Fast, responsive, keyboard-driven gameplay
- Unicode and ASCII modes
- Helpful overlays, reduced-motion mode
Install / Run
- Quick play (no install):
npx gridfall@latest
- Global install:
npm i -g gridfall- Then run:
gridfall
Requires Node.js 18+ and a modern terminal.
Controls
- Arrows: left/right to move, down to soft drop, up or space to hard drop
- Z / X: rotate counter-clockwise / clockwise
- C: hold piece
- P: pause
- S: settings overlay
- U: toggle Unicode
- ?: help overlay
- Esc / Q: quit
Environment toggles
GRIDFALL_ASCII=1– force ASCII renderingGRIDFALL_UNICODE=1– force Unicode renderingGRIDFALL_REDUCED_MOTION=1– enable reduced motion (also auto-enabled on low color depth)
Examples:
GRIDFALL_ASCII=1 npx gridfallGRIDFALL_UNICODE=1 gridfall
Troubleshooting
- Windows: use Windows Terminal or a modern terminal emulator
- Fonts: if some glyphs look off, toggle Unicode with
U - Colors: low color depth may reduce visual fidelity; reduced motion engages automatically
License
MIT © 2025 Dhruv Sharma
