Inspiration

Most of us have downloaded a step counter, checked it for a week, and forgotten it existed. A number on a screen isn't a reason to get up and walk. But we've all spent hours raising a virtual pet or grinding a battle game just to see something grow. So we asked: what if your steps were the thing that raised your pet, and your pet was the reason you kept walking? That idea became PetPal.

What it does

PetPal is a step-powered pet battler for Android. Your phone's step counter automatically feeds a pixel companion. Every 1,000 steps earns 120 XP (up to 20,000 steps a day), and daily streaks reward you for showing up.

  • Collect: There are 36 pets to unlock. A random pet hatches every 10,000 steps, and at 50,000 steps you pick any pet you want. Each pet has its own types, a signature trait (Dragon Hide, Tunneler, Vampire, Bamboo Snack…), and life stages from Baby to Kid to Teen. Switching pets keeps every pet's level and moves.
  • Battle in real time: Pets roam the arena on their own, so it's about timing, not button-mashing. Strike when your opponent is in range, manage cooldowns, and Evade to back off. Dealing and taking hits charges an energy bar that unleashes your pet's unique move.
  • Arenas that change the rules: On Volcano Rim, for example, scorching heat gives every hit a chance to burn.
  • Learn moves: Pets learn new moves as they level up, but they can only keep four. Every new move means choosing one to forget.
  • Play anywhere: Ranked 1v1 online, Teams, Free-for-all, co-op Raids, practice against the CPU, or offline battles with a friend over a hotspot or Wi-Fi, with no internet needed.
  • Never stuck waiting: If nobody joins within 25 seconds, a Lv 50 bot with double HP steps in for an unranked match.
  • Compete: Ranked wins raise your rating, the top 10 make the leaderboard, and the #1 player on the last day of every month wins a free pet.

How we built it

PetPal is a full-stack Kotlin project: a native Android app and a backend, both written in Kotlin.

  • Android app: The UI is built entirely in Jetpack Compose, from the pet collection screens to the real-time battle arena.
  • Step tracking: PetPal reads Android's built-in step counter sensor, so steps turn into XP automatically, with nothing to log and very little battery cost.
  • Local multiplayer: Friends can battle phone-to-phone over a hotspot or Wi-Fi using Android's networking, with no internet connection required.
  • Backend: A Spring Boot server written in Kotlin and deployed on Render handles ranked matchmaking, ratings, and the top-10 leaderboard.
  • Real-time battle engine: Written in Kotlin, it handles roaming movement, range checks, move cooldowns, status effects like burn, and the energy-bar ultimate. Compose draws it every frame.
  • Pixel-art identity: Custom sprites for all 36 pets and a retro pixel font, built into a consistent Compose design system.

Using Kotlin on both the client and the server meant we could move between the app and the backend without switching languages. We also used Claude Code as a development partner throughout, including writing features and fixing bugs against our test suite.

Challenges we ran into

  • Real-time sync: Keeping two phones in agreement about where roaming pets are and whether an attack landed, both online and over a local hotspot.
  • Real-time rendering in Compose: Running a smooth game loop with animated sprites, hit effects and a live battle log in a UI toolkit that was designed mainly for app screens.
  • Empty matchmaking queues: Early on, there often wasn't another player online. The 25-second bot fallback solved this without making ranked play feel cheap.
  • Balance: Tuning 36 pets, their types and traits, cooldowns, and arena effects so no single move or pet dominates. We also had to make a Lv 50 bot challenging without being impossible.
  • Fair XP from steps: Capping daily steps and giving online wins, draws and losses different XP so the game rewards walking and playing without being easy to farm.

Accomplishments that we're proud of

  • A full loop where walking earns progress, progress unlocks pets, and pets fuel competition.
  • Real-time battles that work both online and fully offline between nearby phones.
  • A full-stack Kotlin product, from a Jetpack Compose client to a Spring Boot backend live on Render.
  • 36 collectible pets with distinct types, traits, life stages and move sets.
  • A ranked season with a real monthly reward.

What we learned

  • Habit apps work best when the habit powers something you care about, instead of being the goal itself.
  • Jetpack Compose can do much more than forms and lists. With careful state management, it can run a real-time game.
  • Kotlin works well across the whole stack, from the Android app to a Spring Boot server.
  • Android's built-in sensors and local networking let us ship features like step tracking and offline multiplayer without extra hardware.
  • Small decisions like the four-move limit or the bot fallback have a big effect on whether players come back.

What's next for PetPal

  • Launch on the Google Play Store.
  • Health Connect integration so steps from smartwatches and other fitness apps count too.
  • Friends lists, guilds, and team step challenges that feed into co-op Raids.
  • More arenas, seasonal events, and evolutions past the Teen stage.
  • Home-screen widgets showing your pet and today's steps.
  • Cosmetic customization, with the core game always free to play.

Built With

  • android
  • android-studio
  • gamification
  • hotspot
  • jetpack-compose
  • kotlin
  • leaderboard
  • matchmaking
  • multiplayer
  • pixel-art
  • real-time
  • render
  • rest-api
  • sensors
  • spring-boot
  • step-counter
  • wi-fi
Share this project:

Updates

Submission history