/Basic-Car-Maintenance

A basic app to track your car's maintenance. Open source for Hacktoberfest 2023. Beginners are welcome!

Primary LanguageSwiftApache License 2.0Apache-2.0

Basic Car Maintenance

Welcome to my open source app! It is ready for contributors for Hacktoberfest! Use this app to gain experience getting started in open source for iOS and macOS development using Swift and SwiftUI.

Getting Started

Static Badge GitHub last commit (branch) GitHub contributors first-timers-only Unit Tests

  • Read the Code of Conduct
  • Read the CONTRIBUTING.md guidelines
  • Download Xcode 15 or later
  • Browse the open issues and comment which you would like to work on
    • It is only one person per issue, except where noted.
  • Fork this repo
  • Clone the repo to your machine (do not open Xcode yet)
  • In the same folder that contains the Basic-Car-Maintenance.xcconfig.template, run this command, in Terminal, to create a new Xcode configuration file (which properly sets up the signing information)
cp Basic-Car-Maintenance.xcconfig.template Basic-Car-Maintenance.xcconfig
  • Open Xcode

  • In the Basic-Car-Maintenance.xcconfig file, fill in your DEVELOPMENT_TEAM and PRODUCT_BUNDLE_IDENTIFIER.

    • You can find this by logging into the Apple Developer Portal
    • This works with both free or paid Apple Developer accounts. Do NOT run this app on a real device due to issues with the Sign in With Apple capability.
DEVELOPMENT_TEAM = ABC123
PRODUCT_BUNDLE_IDENTIFIER = com.mycompany.Basic-Car-Maintenance
  • Build the project ✅

  • Checkout a new branch (from the dev branch) to work on an issue

Contributing

To start contributing, review CONTRIBUTING.md. New contributors are always welcome to support this project.

👀 Please be sure to comment on an issue you'd like to work on and Mikaela Caron, the maintainer of this project, will assign it to you! You can only work on ONE issue at a time.

Checkout any issue labeled hacktoberfest to start contributing.

Issue Labels

  • first-timers-only is only for someone who has not contributed to the repo yet! (and is new to open source and iOS development)
  • good-first-issue is an issue that's beginner level

Please choose an appropriate issue for your skill level

Contributors

Made with contrib.rocks.

Star History

Star History Chart

License

This project is licensed under Apache 2.0.