https://github.com/aaronjohnson/step_quest
Gamified step counter for Android and Wear OS
https://github.com/aaronjohnson/step_quest
Last synced: 2 months ago
JSON representation
Gamified step counter for Android and Wear OS
- Host: GitHub
- URL: https://github.com/aaronjohnson/step_quest
- Owner: aaronjohnson
- Created: 2026-01-24T23:00:33.000Z (5 months ago)
- Default Branch: shoes
- Last Pushed: 2026-01-25T10:45:37.000Z (5 months ago)
- Last Synced: 2026-01-25T12:20:00.482Z (5 months ago)
- Language: Dart
- Size: 515 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Security: SECURITY.md
- Support: SUPPORTERS.md
Awesome Lists containing this project
README
# Step Quest
*"The fortress grows not through great plans, but through countless small steps."*
---
## The Legend
In the dark days before Step Quest, many a noble adventurer would set forth with grand ambitions of health and fitness, only to abandon their quest before the first moon had waned. Their step counters gathered dust. Their motivation crumbled like poorly-supported mine shafts.
**Step Quest is different.**
This is not an app that fills your bucket with numbers and graphs and guilt. This is an app that **lights the fire**. Every step you take is not merely recorded—it is *celebrated*. You do not simply walk. You **level up**. You **earn XP**. You **unlock achievements**. You **build streaks that would make a dwarf's beard envious**.
The journey of ten thousand steps begins with a single tap.
## Features
### The Phone Citadel
- **Level Progression** — Watch your character grow stronger with every journey
- **XP System** — Every step feeds the eternal flame of progress
- **Streak Tracking** — Maintain your daily ritual; the fortress rewards consistency
- **Achievements** — Unlock glory through dedication (and occasionally, stubbornness)
- **Manual Logging** — For the times when your phone rests while you do not
### The Watch Outpost (Wear OS)
- **Quick Glance** — Your level and steps, always at hand
- **Ambient Mode** — Low power display for the long watches of the night
- **Rapid Logging** — Log steps with a tap when adventure calls
## The Philosophy
> *"Education is not the filling of a pail, but the lighting of a fire."* — W.B. Yeats
Traditional fitness apps treat you as a vessel to be filled with data. Step Quest treats you as a **hero to be forged**. We don't nag. We don't guilt. We don't send passive-aggressive notifications about how you haven't moved in 47 minutes.
We simply wait. And when you walk, **we celebrate**.
Your steps become XP. Your XP becomes levels. Your levels become a testament to your perseverance. Like a dwarf fortress rising from the mountain, your progress is measured not in days, but in dedication.
## Free and Open Source
Step Quest is **completely free** with no ads, no subscriptions, and no paywalls. All features are available to everyone.
The app includes an optional **tip jar** for those who wish to support development. Tips are one-time purchases that help keep the fortress running—but they're never required.
**[Get Step Quest](https://step.quest.mqqn.net)** | [Blog](https://aaronjohnson.github.io/) | [Patreon](https://patreon.com/mqqn) | [View Source](https://github.com/aaronjohnson/step_quest)
### The Origin Story
A friend built a step counter in React.js using Claude.ai — on her first day trying it. A day later, this Flutter app was running on three phones and a watch. [Read the full story →](https://www.patreon.com/posts/149109253)
## Installation
```bash
# Clone the fortress blueprints
git clone https://github.com/aaronjohnson/step_quest.git
cd step_quest
# Summon the dependencies
flutter pub get
# Deploy to your device
flutter run
```
## Requirements
- Flutter 3.38+
- Android device (API 23+) or Wear OS watch
- A willingness to walk
- Optional: A beard (dwarven or otherwise)
## The Road Ahead
- [x] Health Connect integration — Samsung Health, Google Fit, Fitbit all flow through here
- [ ] Achievements gallery — Display your glory
- [ ] Historical charts — For those who wish to gaze upon their journey
- [ ] Walking with friends — See fellow adventurers' progress without compromising privacy
- Opt-in only, no location data, just ranks and streaks
- Friend codes instead of accounts — no email, no phone number
- Could be local-first (no server) or end-to-end encrypted
- Your steps, your choice to share
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Remember: *Losing is fun.* Bugs are merely unexpected features waiting to be documented in the changelog.
## License
[MIT](LICENSE) — Free as in freedom, free as in beer, free as in the open sky above the mountainhome.
---
*Strike the earth. One step at a time.*