Neon Stackfall

Neon Stackfall is a small browser-based falling-block arcade game built as a personal coding and design exercise. It runs as static HTML, CSS, and JavaScript, with a canvas playfield, keyboard controls, touch controls, scoring, levels, hold/next panels, glow effects, and line-clear particles.

Personal Use And Protected Content Notice

This project is an independent personal learning exercise inspired by classic falling-block puzzle mechanics. The game mechanics, visual conventions, names, trade dress, and other associated protected content that inspired this exercise may be protected by their respective rights holders.

This project is not affiliated with, endorsed by, or connected to The Tetris Company or any other rights holder. It is not intended for commercial release, distribution as an official clone, or use in a way that suggests ownership of protected intellectual property. This notice is informational only and is not legal advice.

Play

Open index.html in a browser, or run a tiny local server:

python -m http.server 5173

Then visit:

http://127.0.0.1:5173/index.html

Controls

• Move: ArrowLeft / ArrowRight
• Soft drop: ArrowDown
• Rotate: ArrowUp or X
• Counter-rotate: Z
• Hard drop: Space
• Hold piece: C
• Pause: P or Escape
• Restart: R

Phone controls use gestures on the game board: tap to rotate, drag left or right to move sideways by columns, swipe down and hold/drag to soft-drop faster, and swipe up to hard drop.

Platform Builds

This repo also includes native app wrappers in platforms/:

• platforms/windows packages the game as a Windows desktop app with Electron and can build a portable .exe folder; an optional NSIS/MSI installer script is included too.
• platforms/android packages the game as a native Android WebView app with phone-first touch controls.
• platforms/ios packages the game as a SwiftUI iPhone/iPad wrapper using WKWebView.

The platform apps reuse the same core game files so gameplay stays consistent. To refresh the bundled mobile assets after changing the root web game, run:

.\scripts\sync-platform-assets.ps1

GitHub Actions builds the portable Windows app, Android debug APK, and an unsigned iOS simulator build when changes are pushed to main. A signed iPhone device build requires an Apple Developer account, signing identity, and provisioning profile.

Published builds are attached to the repository's GitHub Releases:

• Windows: portable .zip containing Neon Stackfall.exe
• Android: debug .apk
• iOS: unsigned iOS Simulator .app zip

Game Mechanics

• Seven-bag randomizer for tetromino pieces
• Ghost piece preview
• Hold piece slot with one hold per spawned piece
• Next piece preview
• Line clears with score rewards
• Level increases every 8 cleared lines
• Drop speed increases as the level rises
• Best score saved locally in the browser

Project Files

• index.html contains the game UI structure.
• styles.css contains the responsive neon arcade interface.
• game.js contains the canvas renderer and game loop.
• favicon.ico and favicon.svg provide browser favicons.
• assets/neon-stackfall-concept.png is the generated visual concept reference.

License

No open-source license is granted at this time. All rights are reserved by the repository owner, except for any rights held by third-party rights holders for protected source material, concepts, trademarks, trade dress, or related intellectual property referenced by this personal exercise.