YOUR QUICKSTART GUIDE

A little less scrolling.
A little more stacking.

Make a little space in your day. Here's everything you need to play, install, and share Katelyn's personal portrait-tile puzzle.

01 / Find your flow

  1. Watch the landing-page preview, then select Play the game and Let's play. No sign-up needed.
  2. Move and rotate the falling shapes to fill complete horizontal rows. Full rows clear, creating room for the next pieces.
  3. Use the outlined ghost piece to see where your piece will land. Save a useful shape with Hold once per falling piece; Up next shows the next three pieces.
  4. Every 10 cleared lines brings a new level and faster falling pieces. There is no piece limit or preset puzzle. The game ends when a piece cannot spawn or locks above the board.

Classic endless play is back. Keep clearing rows and improving your personal best. Start fresh resets the board after confirmation; it does not erase your best score.

On a keyboard

← → Move
↑ / X Rotate clockwise
Z Rotate counterclockwise
↓ Soft drop
space Hard drop
C / Shift Hold
P / Esc Pause or resume

On your phone

Use the buttons below the board. Hold the left, right, or down button to repeat.

Or use the board itself: tap to rotate, drag sideways to move, and swipe down to hard drop. A down swipe must travel at least 55 pixels with less than 40 pixels of sideways motion.

A few little comforts: sound is off by default. The music-note button enables gentle synthesized tones. Switch off Portrait tiles for plain colors. The game automatically pauses when you switch tabs or apps. Return and press Keep playing.

The board is a visual canvas game. Controls support keyboard and touch, and important events are announced to assistive technology; this is not a fully nonvisual playable game.

02 / See it fall into place

A 35-second simulated classic game recorded from this app. No audio. The video needs a connection or a separate download; the game itself works offline.

Video description: A computer-controlled game rotates and drops Katelyn's colorful portrait pieces onto the board. Complete rows disappear, the score and line counts rise, and new pieces keep arriving. The side panels show the next pieces, level, and score. This is a demonstration, not a recording of a human player.

On the landing page, this preview starts automatically, muted and inline. Use Pause preview or the video controls to stop it. Reduced-motion preferences keep it paused; browsers that block autoplay show a manual Play preview option. Starting the game pauses the preview. The video in this guide starts only when you press play.

Try the live simulated game (works offline after setup), or save the video to watch later. Demo scores never replace your personal best.

03 / Your game, to go

Visit the HTTPS-hosted game online once and wait for Ready for offline play below the board. Install from that same URL. Opening the HTML file directly will not enable installation or offline support.

iPhone & iPad

Open the site in Safari. Tap Share, select Add to Home Screen, then Add. If offered, keep Open as Web App enabled. Launch it from the new home-screen icon.

Android

Open the site in Chrome and tap Install app. If no prompt appears, open Chrome's menu and choose Install app or Add to Home screen. Menu wording varies by browser version.

Desktop Chrome

Click Install app on the page or the install icon in Chrome's address bar. Alternatively, open Chrome's menu and look for the install option under Cast, save, and share.

Offline & updates

After setup, the game, portraits, and this guide are cached locally. Browser storage eviction or clearing site data removes that cache. Reopen online to restore it. When an update is ready, close all game windows and reopen.

This is an installable website, not an App Store or Google Play package. A browser can decline or hide installation; the normal website still works. Browser and installed-app storage may be separate, especially on iOS.

04 / The little details

ActionPoints
Clear 1 / 2 / 3 / 4 lines at once100 / 300 / 500 / 800 × current level
Soft drop1 per cell
Hard drop2 per cell

Pieces come from shuffled sets of seven. Rotation uses SRS wall kicks. A grounded piece gives you a half-second to adjust, with up to 15 grounded movement/rotation resets. There are no combo, back-to-back, or T-spin bonuses.

Your classic personal best and portrait setting stay in this browser's local storage. Older puzzle-mode records are left untouched but are not used. There is no tracking, analytics, account, cloud save, or server-side data collection. A refresh starts a new game; an in-progress board is not saved.

05 / Code is open. Joy is shared.

The original game code is MIT licensed. The supplied portrait, its crops, recolors, and photo-containing screenshots/video have a separate game-only redistribution license: share them with Katelyn's Tetris and its documentation, not as standalone photos or unrelated assets. Modified versions of this game may retain the photos under the same terms.

The repository's LICENSE and PHOTO-LICENSE.md contain the terms. The combined package is not entirely MIT-licensed, and the restricted photos are not open-source assets. To reuse the code for an unrelated game, replace the photos and photo-containing media with assets you can license yourself.

This is an independent personal project, not affiliated with or endorsed by The Tetris Company. Tetris is a trademark of its respective owners; the code and photo licenses grant no trademark rights. Review naming rights before public or commercial distribution.

Your next little break is waiting.

Let's play

Preparing offline guide...