jchrisjackson / basic-car-maintenance

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

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.

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
  • It is only one person per issue, except where noted.
• Fork this repo
• Clone the repo to your machine
• 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

• 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 is only needed when running on a real device for iOS, this works with both free or paid Apple Developer accounts.

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. Issues labeled good-first-issue are great for beginners.

👀 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.

Contributors

Made with contrib.rocks.

Star History

License

This project is licensed under Apache 2.0.