🚶‍♂️ Step By Step 🎮

A Fitness-Powered Text-RPG Adventure

---

Overview

Step By Step is a gamified step counter that transforms your real-world movement into energy for interactive storytelling. It's part fitness tracker, part narrative RPG — empowering users to walk, earn energy, and survive through immersive storylines.

The flagship story, Survive, drops players into a zombie apocalypse where every choice costs energy and survival depends on how much you've walked. New stories, genres, and experiences are planned for future releases.

---

⚙️ Features

🧠 Core Functionality

• Apple HealthKit Integration

  • Automatically pulls real-time step data
  • No manual input needed — just walk!

• Energy System

  • Steps convert into energy
  • Energy fuels story decisions
  • Encourages consistent daily movement

• Dashboard View

  • View daily steps, energy, distance, and conversion stats
  • One-tap step-to-energy conversion
  • Circular progress ring for visualizing step goals
  • Dynamic feedback tied to walking progress

📖 Story-Based Gameplay

• Interactive, Text-Based RPG

  • Choose-your-adventure style format
  • Each decision costs energy or affects health
  • Branching paths, reactive consequences, and replayability
  • In-progress 5-day challenge in the Survive storyline
  • Story progress tied directly to real-world step count

• Step-Powered Progression

  • You can't move forward unless you move in real life
  • Energy limitations require walking to continue the story
  • Multiple attempts encouraged — death is part of the journey

📊 Visual Step Insights

• Stats View
  • Displays today's steps, best day, and 7-day step average
  • Longest walking streak shown dynamically
  • Animated, scrollable graph of daily step history
  • Highlights best step count with a trophy icon
  • (Planned) Dotted line showing 7-day average on graph

🏆 Achievements & Milestones

• Fitness Achievements

  • Max steps in a day
  • Total cumulative steps
  • Total distance walked

• Story Achievements

  • Unlock badges for completing story days
  • Tracks how far you’ve made it and how many times you've tried
  • Shows date earned and milestone history

---

✅ Current Status

Finished Features

• Real-time HealthKit syncing
• Step-to-energy conversion
• Player stat management (energy, health, streaks, averages)
• Story + fitness achievement systems with persistent tracking
• Animated stat views and progress cards
• Story progress view with resume/restart/history
• Bar graph with trophy icon for best day

---

📸 Screenshots

Chapter View	Decision View
Story Progress	Dashboard

---

🧭 Roadmap

Short-Term Goals

• Finish all 5 in-game days of the Survive storyline
• Add 7-day average line to graph (visual indicator)
• Refine UI/UX for streaks, stats, and conversion feedback
• Complete Settings tab (accessibility, personalization)
• Finalize and save story checkpoints with decision history

Long-Term Goals

• Expand with new interactive stories (sci-fi, fantasy, mystery)
• Visual story map with branching paths and milestones
• iCloud sync for step history and story progress across devices
• Shareable achievements and social walking challenges

---

🤝 Let's Connect

Have suggestions or want to collaborate?

📫 Great Visions Code – GitHub Page

Thanks for following the journey! 🚶‍♂️