Steps
Open Source Step Counting App using HealthKit & SwiftUI
Install / Use
/learn @brittanyarima/StepsREADME
🏃Steps
This app is open source and ready for you to contribute! Built fully with SwiftUI and open to contributers of any experience level (beginners welcome🙂)!
Getting Started
- Read the Code of Conduct
- Read the CONTRIBUTING.md guidelines
- Download Xcode 15 or later, and macOS 14.0 or later
- Browse the open issues and comment which you would like to work on
- Fork this repo
- Clone the repo to your machine
- In the same folder that contains the
StepsConfigTemplate.xcconfig, run this command, in Terminal, to create a new Xcode configuration file (which properly sets up the signing information)
cp StepsConfigTemplate.xcconfig StepsConfig.xcconfig
- In the StepsConfig.xcconfig file, fill in your
DEVELOPMENT_TEAM&BUNDLE_ID- Example:
DEVELOPMENT_TEAM = IdNumber&BUNDLE_ID = com.name.steps - You can find your Team ID by logging into the Apple Developer Portal
- This is only needed when running on a real device for iOS, this works with both free or paid Apple Developer accounts.
- You will need to do this AGAIN to set up the Widget extension
- Example:
cp StepsWidgetConfigTemplate.xcconfig StepsWidgetConfig.xcconfig
-
❗️Make sure you at .widget to this
PRODUCT_BUNDLE_IDENTIFIERie. com.name.steps.widget -
Build the project
-
Checkout a new branch (from the
devbranch) to work on an issue Checkout any issue labeledhacktoberfestto start contributing. -
Start contributing!
-
Submit PR to merge with
devbranch -
If you've never contributed to open-source before there are a ton of great tutorials out there to help get you started
-
Issues labeled
good-first-issueare great for beginners.
Tech Used
- 🎨 SwiftUI
- ❤️🩹 HealthKit
- 📊 Swift Charts
- 🔔 Local Notifications
- 🗂️ MVVM
- 💾 App Storage
Contributors
<a href="https://github.com/brittanyarima/Steps/graphs/contributors"> <img src="https://contrib.rocks/image?repo=brittanyarima/Steps"/> </a>Made with contrib.rocks.
License
This project is licensed under MIT License.
