{"id":21668445,"url":"https://github.com/great-visions-code/step-by-step","last_synced_at":"2025-10-05T17:21:03.433Z","repository":{"id":264129196,"uuid":"892453077","full_name":"Great-Visions-Code/Step-by-Step","owner":"Great-Visions-Code","description":"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.","archived":false,"fork":false,"pushed_at":"2025-04-23T01:01:36.000Z","size":43322,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-08T07:52:14.644Z","etag":null,"topics":["adventure-game","fitness-tracker","gamification","health","interactive-fiction","ios","mobile-app","rpg-game","stepcounter","storytelling","swift","swiftui","zombie"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Great-Visions-Code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-11-22T06:20:10.000Z","updated_at":"2025-04-25T06:48:05.000Z","dependencies_parsed_at":"2024-11-22T07:22:45.869Z","dependency_job_id":"bd2edfc9-8b1f-4544-bf4a-4f60a71ffabd","html_url":"https://github.com/Great-Visions-Code/Step-by-Step","commit_stats":null,"previous_names":["great-visions-code/step-by-step"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Great-Visions-Code%2FStep-by-Step","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Great-Visions-Code%2FStep-by-Step/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Great-Visions-Code%2FStep-by-Step/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Great-Visions-Code%2FStep-by-Step/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Great-Visions-Code","download_url":"https://codeload.github.com/Great-Visions-Code/Step-by-Step/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253025337,"owners_count":21842409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adventure-game","fitness-tracker","gamification","health","interactive-fiction","ios","mobile-app","rpg-game","stepcounter","storytelling","swift","swiftui","zombie"],"created_at":"2024-11-25T12:15:52.902Z","updated_at":"2025-10-05T17:21:03.416Z","avatar_url":"https://github.com/Great-Visions-Code.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚶‍♂️ Step By Step 🎮  \n**A Fitness-Powered Text-RPG Adventure**\n\n---\n\n## Overview  \n**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.\n\nThe 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.\n\n---\n\n## ⚙️ Features  \n\n### 🧠 Core Functionality  \n- **Apple HealthKit Integration**  \n  - Automatically pulls real-time step data  \n  - No manual input needed — just walk!\n\n- **Energy System**  \n  - Steps convert into energy  \n  - Energy fuels story decisions  \n  - Encourages consistent daily movement\n\n- **Dashboard View**  \n  - View daily steps, energy, distance, and conversion stats  \n  - One-tap step-to-energy conversion  \n  - Circular progress ring for visualizing step goals  \n  - Dynamic feedback tied to walking progress  \n\n### 📖 Story-Based Gameplay  \n- **Interactive, Text-Based RPG**  \n  - Choose-your-adventure style format  \n  - Each decision costs energy or affects health  \n  - Branching paths, reactive consequences, and replayability  \n  - In-progress 5-day challenge in the _Survive_ storyline  \n  - Story progress tied directly to real-world step count  \n\n- **Step-Powered Progression**  \n  - You can't move forward unless you move in real life  \n  - Energy limitations require walking to continue the story  \n  - Multiple attempts encouraged — death is part of the journey\n\n### 📊 Visual Step Insights  \n- **Stats View**  \n  - Displays today's steps, best day, and 7-day step average  \n  - Longest walking streak shown dynamically  \n  - Animated, scrollable graph of daily step history  \n  - Highlights best step count with a trophy icon  \n  - (Planned) Dotted line showing 7-day average on graph  \n\n### 🏆 Achievements \u0026 Milestones  \n- **Fitness Achievements**  \n  - Max steps in a day  \n  - Total cumulative steps  \n  - Total distance walked  \n\n- **Story Achievements**  \n  - Unlock badges for completing story days  \n  - Tracks how far you’ve made it and how many times you've tried  \n  - Shows date earned and milestone history  \n\n---\n\n## ✅ Current Status\n\n### Finished Features  \n- Real-time HealthKit syncing  \n- Step-to-energy conversion  \n- Player stat management (energy, health, streaks, averages)  \n- Story + fitness achievement systems with persistent tracking  \n- Animated stat views and progress cards  \n- Story progress view with resume/restart/history  \n- Bar graph with trophy icon for best day  \n\n---\n\n## 📸 Screenshots  \n\n\u003ctable\u003e  \n  \u003ctr\u003e  \n    \u003ctd align=\"center\"\u003e\u003cb\u003eChapter View\u003c/b\u003e\u003cbr\u003e\u003cimg src=\"ReadMe Images/IMG_4093.jpg\" width=\"300\"\u003e\u003c/td\u003e  \n    \u003ctd align=\"center\"\u003e\u003cb\u003eDecision View\u003c/b\u003e\u003cbr\u003e\u003cimg src=\"ReadMe Images/IMG_4094.jpg\" width=\"300\"\u003e\u003c/td\u003e  \n  \u003c/tr\u003e  \n  \u003ctr\u003e\u003ctd colspan=\"2\" style=\"height: 20px;\"\u003e\u003c/td\u003e\u003c/tr\u003e  \n  \u003ctr\u003e  \n    \u003ctd align=\"center\"\u003e\u003cb\u003eStory Progress\u003c/b\u003e\u003cbr\u003e\u003cimg src=\"ReadMe Images/IMG_4095.jpg\" width=\"300\"\u003e\u003c/td\u003e  \n    \u003ctd align=\"center\"\u003e\u003cb\u003eDashboard\u003c/b\u003e\u003cbr\u003e\u003cimg src=\"ReadMe Images/IMG_4096.jpg\" width=\"300\"\u003e\u003c/td\u003e  \n  \u003c/tr\u003e  \n\u003c/table\u003e\n\n---\n\n## 🧭 Roadmap  \n\n### Short-Term Goals  \n- Finish all 5 in-game days of the _Survive_ storyline  \n- Add 7-day average line to graph (visual indicator)  \n- Refine UI/UX for streaks, stats, and conversion feedback  \n- Complete Settings tab (accessibility, personalization)  \n- Finalize and save story checkpoints with decision history  \n\n### Long-Term Goals  \n- Expand with new interactive stories (sci-fi, fantasy, mystery)  \n- Visual story map with branching paths and milestones  \n- iCloud sync for step history and story progress across devices  \n- Shareable achievements and social walking challenges  \n\n---\n\n## 🤝 Let's Connect  \n\nHave suggestions or want to collaborate?\n\n📫 [Great Visions Code – GitHub Page](https://great-visions-code.github.io/)  \n\nThanks for following the journey! 🚶‍♂️","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreat-visions-code%2Fstep-by-step","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgreat-visions-code%2Fstep-by-step","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgreat-visions-code%2Fstep-by-step/lists"}