https://github.com/great-visions-code/step-by-step

A gamified step counter that transforms your real-world steps into energy for a thrilling text based RPG adventure. Track your steps, earn energy, and make choices that shape your story in a post-apocalyptic world. Perfect for staying active while immersing yourself in interactive fiction with multiple endings.
https://github.com/great-visions-code/step-by-step

adventure-game fitness-tracker gamification health interactive-fiction ios mobile-app rpg-game stepcounter storytelling swift swiftui zombie

Last synced: 6 months ago
JSON representation

A gamified step counter that transforms your real-world steps into energy for a thrilling text based RPG adventure. Track your steps, earn energy, and make choices that shape your story in a post-apocalyptic world. Perfect for staying active while immersing yourself in interactive fiction with multiple endings.

• Host: GitHub
• URL: https://github.com/great-visions-code/step-by-step
• Owner: Great-Visions-Code
• Created: 2024-11-22T06:20:10.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-23T01:01:36.000Z (11 months ago)
• Last Synced: 2025-05-08T07:52:14.644Z (11 months ago)
• Topics: adventure-game, fitness-tracker, gamification, health, interactive-fiction, ios, mobile-app, rpg-game, stepcounter, storytelling, swift, swiftui, zombie
• Language: Swift
• Homepage:
• Size: 41.3 MB
• Stars: 9
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🚶‍♂️ 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](https://great-visions-code.github.io/)  

Thanks for following the journey! 🚶‍♂️