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: 5 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 3 years ago)
Default Branch: dev
Last Pushed: 2024-02-04T04:35:06.000Z (over 1 year ago)
Last Synced: 2024-11-12T21:39:01.775Z (11 months ago)
Topics: hacktoberfest, healthkit, ios-swift, swiftui
Language: Swift
Homepage:
Size: 1.77 MB
Stars: 81
Watchers: 3
Forks: 32
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.