Apache License 2.0

项目介绍

mikaelacaron/Basic-Car-Maintenance 是一个托管在 GitHub 上的开源项目,主要使用 Swift 编写,采用 Apache License 2.0 许可证,目前获得 340 个 Star、198 次 Fork。

仓库全名
mikaelacaron/Basic-Car-Maintenance
开源许可证
Apache License 2.0
Star 数
340
Fork 数
198
未关闭 Issue
14

README 摘要

Basic Car Maintenance Welcome to Basic Car Maintenance, an open-source app designed to help you get started with iOS development using Swift and SwiftUI. This project is beginner-friendly and open to contributions, especially during Hacktoberfest! App Features and Tech Stack Features and Tech Stack Maintenance Tracking - Log & monitor oil changes, tire rotations, brake checks, etc. Multiple Vehicle Support - Manage…

完整内容见 GitHub 原始 README 或本页 。

常见问题

Basic-Car-Maintenance 用什么语言开发?

主要使用 Swift 编写,采用 Apache License 2.0 许可证,目前有 340 个 Star。

Basic-Car-Maintenance 可以免费商用吗?

仓库采用 Apache License 2.0 许可证,可免费使用与修改,商业使用请遵守许可证条款(例如保留版权声明与许可声明)。

如何获取 Basic-Car-Maintenance 的源码?

可以直接克隆仓库:git clone https://github.com/mikaelacaron/Basic-Car-Maintenance.git,默认分支为 main;安装与运行步骤见仓库 README。

Basic-Car-Maintenance 最近还在维护吗?

仓库最近一次更新为 7月31日,当前有 14 个未关闭 Issue;Star 数为 340,可作为社区活跃度的参考。

关于

GitHub 原始描述(英文)

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

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

语言占比

Ruby
Shell
Swift

README

Basic Car Maintenance

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

Alt

Welcome to Basic Car Maintenance, an open-source app designed to help you get started with iOS development using Swift and SwiftUI. This project is beginner-friendly and open to contributions, especially during Hacktoberfest!

App Features and Tech Stack

Features and Tech Stack
  • Maintenance Tracking - Log & monitor oil changes, tire rotations, brake checks, etc.
  • Multiple Vehicle Support - Manage maintenance records for all your vehicles in one place.
  • Dark Mode Support - Sleek dark theme for better nighttime usability.

Tech Stack

  • Swift and SwiftUI - the programming language and UI framework
  • Firebase and Firestore - backend for user authentication and data storage
  • GitHub Actions - CI/CD for automated unit testing and deploying the DocC documentation
  • Fastlane - running the unit tests

Getting Started

Before contributing, follow these steps:

  • Read the Code of Conduct
  • Read the CONTRIBUTING.md guidelines
  • Download Xcode 16.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 (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 ✅

  • Setup the Firebase emulator, following the steps in CONTRIBUTING.md

Warning 警告

DO NOT skip setting up the emulators! or your app won’t work

  • Start the emulator with: firebase emulators:start --import=./local-data --export-on-exit

    • Be sure to be in the backend folder that contains the firebase.json file.
  • Checkout a new branch, from the main branch, to work on an issue

Contributing

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

:eyes: 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.

Important 重要

View the GitHub Discussions for the latest information about the repo.

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.

评论

暂无评论