🏃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 & PRODUCT_BUNDLE_IDENTIFIER

  • Example: DEVELOPMENT_TEAM = IdNumber & PRODUCT_BUNDLE_IDENTIFIER = 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

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.

License

This project is licensed under MIT License.