Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brittanyarima/Steps
Open Source Step Counting App using HealthKit & SwiftUI
https://github.com/brittanyarima/Steps
hacktoberfest healthkit ios-swift swiftui
Last synced: 3 months ago
JSON representation
Open Source Step Counting App using HealthKit & SwiftUI
- Host: GitHub
- URL: https://github.com/brittanyarima/Steps
- Owner: brittanyarima
- License: mit
- Created: 2022-12-10T01:25:18.000Z (almost 2 years ago)
- Default Branch: dev
- Last Pushed: 2024-02-04T04:35:06.000Z (9 months ago)
- Last Synced: 2024-04-13T07:25:23.665Z (7 months ago)
- Topics: hacktoberfest, healthkit, ios-swift, swiftui
- Language: Swift
- Homepage:
- Size: 1.77 MB
- Stars: 69
- Watchers: 2
- Forks: 27
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- fucking-open-source-ios-apps - StepTracker
README
## 🏃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](https://github.com/brittanyarima/Steps/blob/main/CODE_OF_CONDUCT.md)
* Read the [CONTRIBUTING.md](https://github.com/brittanyarima/Steps/blob/main/CONTRIBUTING.md) guidelines
* Download Xcode 15 or later, and macOS 14.0 or later
* Browse the open [issues](https://github.com/brittanyarima/Steps/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)
```sh
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
```sh
cp StepsWidgetConfigTemplate.xcconfig StepsWidgetConfig.xcconfig
```
* ❗️Make sure you at .widget to this `PRODUCT_BUNDLE_IDENTIFIER` ie. com.name.steps.widget
* Build the project
* Checkout a new branch (from the `dev` branch) to work on an issue
Checkout any issue labeled `hacktoberfest` to start contributing.
* Start contributing!
* Submit PR to merge with `dev` branch
* 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-issue` are great for beginners.
**Tech Used**
- 🎨 SwiftUI
- ❤️🩹 HealthKit
- 📊 Swift Charts
- 🔔 Local Notifications
- 🗂️ MVVM
- 💾 App Storage
# Contributors
Made with [contrib.rocks](https://contrib.rocks).
# License
This project is licensed under [MIT License](https://github.com/brittanyarima/Steps/blob/main/LICENSE).