tFrogger

A pick-up-and-play classic Frogger game in your terminal 🐸 grab a focused retro break without leaving the command line.

🚀 What is tFrogger?

tFrogger started as a weekend experiment to bring Frogger’s tension into my terminal flow. The game now ships as a polished Ink experience with smooth controls, level progression, and persistent high scores—perfect for quick dopamine hits between builds.

✨ Key Features

• Core Gameplay: Emoji-rendered boards, wraparound traffic, and river hazards keep each run punchy; adaptive obstacle speed and lilypad density ramp the stakes as levels progress.
• Developer Experience: Built with React + Ink so the entire UI is JSX; a --debug flag streams collision logs to stderr for fast tuning.
• Replay Value: Local high scores stick between sessions, menus scale to your terminal, and new runs take seconds to restart.

🎯 Perfect For

• Developers who crave a quick retro reset between git commits.
• Ink or React devs exploring real-time game loops in the terminal.
• Streamers looking for a quirky command-line showcase.

⚡ Quick Start

npx tfrogger

npx tfrogger

📈 Impact & Proof

• High scores persist locally (stored via Node’s fs API) so you can track improvements over time.
• Looking for community metrics—share your best runs via GitHub Issues so we can feature them here.

🧱 Technology Stack

• React, Ink, and TypeScript for the rendering layer.
• AVA snapshots for regression coverage.
• Node fs persistence via saves.json inside your config directory.

🔗 Links

• GitHub: https://github.com/gfargo/tfrogger
• npm: https://www.npmjs.com/package/tfrogger
• Issue Tracker: https://github.com/gfargo/tfrogger/issues

Give tFrogger a spin and let the 🐸 hops reset your focus for the next sprint.