# GridRun

> A free browser-based memory grid game with roasts, daily challenges, and sprint mode. No accounts, no ads, no downloads.

GridRun is a lightning-fast memory challenge where each level briefly flashes the entire grid, revealing the star cell, bonuses, and traps. Players must memorize positions during the flash, then find the star before time runs out. Wrong clicks reveal proximity hints. Losing triggers humorous roasts that scale with difficulty.

## Game Features

- **Memory Flash**: Each level starts with a brief flash showing all cell positions. Duration scales with difficulty: Easy (1.2s), Medium (0.8s), Hard (0.5s).
- **Proximity Hints**: Wrong clicks reveal colored border hints showing distance to the star — red means very close, amber is warm, yellow is tepid, blue means far away.
- **Streak System**: Find the star on the first click to build streaks. Streaks earn time bonuses: +3s for perfect level, +2s at 2+ streak, +5s at 5+ streak.
- **Reveal Tokens**: Every 3 consecutive perfect levels earns a Reveal Token (max 3). Use one to safely reveal a random non-star cell, narrowing the search.
- **Roast System**: Run out of time or hit a Level Down cell? The game shows where the star was hiding, then delivers a savage, humorous roast. Roasts scale from gentle (Easy) to brutal (Hard).

## Game Modes

- **Classic**: Endless mode — survive as long as you can, chasing your personal best level.
- **Sprint**: Race through 10 levels. Your score is how much time remains when you finish.
- **Daily Challenge**: Same grid sequence for everyone each day. Compare scores with friends — no accounts needed, just share your score.

## Difficulty Levels

- **Easy**: 35 seconds start, smaller grids, 1.2-second memory flash, gentle roasts.
- **Medium**: 32 seconds start, medium grids, 0.8-second flash, spicy roasts.
- **Hard**: 28 seconds start, large grids, 0.5-second flash, savage roasts.

## Cell Types

- ★ **Next Level (Star)**: Primary target. Finding it advances to the next level and grants +6 seconds.
- + **Time Bonus**: Extends the clock by variable seconds. Scales with difficulty and level.
- − **Time Penalty**: Steals variable seconds from remaining time. Harsher at higher levels.
- ↑ **Level Up**: Catapults +2 levels forward without needing the star. Breaks streak.
- ↓ **Level Down**: Forces back -1 level and delivers a roast. Breaks streak.
- · **Empty**: Contains nothing. A wasted click that costs precious time.

## Key Mechanics

- **Deterministic Levels**: Each level number always generates the same grid layout, star position, and cell placement. Players can memorize specific levels.
- **First-Click Bonus**: Finding the star on the first click earns a perfect level and time bonus.
- **Progressive Difficulty**: As levels increase, grids expand and flash times can shrink.
- **Tab Pause**: Timer pauses when the browser tab is not visible.

## Technical Info

- Free to play, no accounts or sign-up required
- No ads, no in-app purchases
- Works on all modern browsers (desktop and mobile)
- Supports English and Albanian languages
- PWA-ready for home screen installation

## URL

https://gridrun.vercel.app