Garage Buddy - Open Source Garage Management System

Garage Buddy is a comprehensive, open source garage management system built on the ASP.NET Core MVC platform. Designed to cater to the needs of auto mechanics and workshops, Garage Buddy simplifies the process of managing service records and parts for every customer's car. Everything can be easily tracked and organized within the application.

Key Features

• Cloud-Based Solution: Garage Buddy is a fully-featured, cloud-based application, eliminating the need for complex installations. Mechanics can access the system by simply navigating to the login page using their web browser and entering their login details. This ensures hassle-free accessibility from anywhere with an internet connection.

• Scalability: With its cloud-based nature, Garage Buddy offers easy scalability to suit garages or workshops of any size. Whether you run a small repair shop or a large-scale auto service center, the system adapts to your requirements, making it a perfect fit for your business.

• User Management: Garage Buddy supports multiple user accounts, allowing mechanics and employees to have their own personalized access. Adding additional users is a breeze, making it convenient for your solution to grow as your business expands.

• Service Tracking: Keep a detailed log of every service performed on a customer's vehicle. From routine maintenance to complex repairs, Garage Buddy helps you maintain a complete history of each car, ensuring better customer service. (Work in progress)

Install and Run

To get started with Garage Buddy, follow the instructions below:

1. Clone the repository: git clone https://github.com/dimitar-grigorov/GarageBuddy
2. Install the required dependencies. Visual Studio 2022 and SQL Server 2019.
3. Configure the database settings to fit your environment.

Configure Database Settings

Garage Buddy uses different than the default configuration file (appsettings.json). It looks like this:

{
  "DatabaseSettings": {
    "DbProvider": "mssql",
    "DefaultConnection": "Server=.;Database=GarageBuddy;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

Also the same format should be used in the User Secrets.

4. Apply the database migrations: Update-Database

• In Visual Studio, open the Package Manager Console and select the Data\GarageBuddy.Data project as the Default project.
• Execute the Update-Database command.

5. On the first run the application will seed the database. The first registered user will be an administrator.

For more detailed instructions on installation and setup, please refer to the Installation Guide.

It is way easier to use Docker and Docker Compose which are included and preconfigured as launch profile.

Don't forget to change the password in docker-compose.override.yml

Technologies used

• ASP.NET Core 6
• ASP.NET Core Identity
• Entity Framework Core

Third-Party

• Based on ASP.NET Core MVC template by Nikolay Kostov
• Theme Mazer Dashboard by Zuramai
• Custom npm package build on top of the Mazer theme.

Contributing

Garage Buddy is an open source project, and we welcome contributions from the community. If you find any bugs, have feature suggestions, or want to help improve the system, please feel free to submit issues and pull requests.

License

Garage Buddy is released under the MIT License.