CarCare Connect

CarCare Connect is a comprehensive platform dedicated to automotive spare parts. It provides a seamless interface for users to browse, search, and manage various types of automotive spare parts, ensuring that customers find exactly what they need.

Project Description
Installation
Usage
Contributing
License
Contact

Project Description

CarCare Connect is designed to streamline the process of finding and purchasing automotive spare parts. Whether you're looking for engine components, brake systems, electrical parts, or body parts, our platform offers a user-friendly interface to meet your needs. Built with a robust frontend using React and a powerful backend with Python and FastAPI, CarCare Connect ensures efficient performance and a smooth user experience.

Installation

To get started with CarCare Connect, follow these steps:

Prerequisites

Ensure you have the following installed on your machine:

Node.js
Python 3.x
FastAPI
npm (Node Package Manager)

Frontend Setup

Clone the repository:

git clone https://github.com/deerickkorir/carcare-connect.git

Navigate to the frontend directory:
```
cd carcare-connect/frontend
```
Install the required dependencies:
```
npm install
```
Start the frontend server:
```
npm start
```

Backend Setup

Navigate to the backend directory:
```
cd carcare-connect/backend
```

Create a virtual environment and activate it:

python -m venv venv
source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

Install the required Python packages:
```
pip install -r requirements.txt
```
Start the backend server:
```
uvicorn main:app --reload
```

Video

project video

Frontend

The frontend is built using React, React Bootstrap, React Router, and various other libraries to enhance the user experience. Navigate to the application in your web browser (usually http://localhost:3000).

Backend

The backend API is built using FastAPI. You can access the API documentation at http://localhost:8000/docs to explore available endpoints and their usage.

Forms and Validation

Forms in the application are managed using React Hook Form and validation is handled by Zod.

Contributing

We welcome contributions from the community. To contribute, please follow these steps:

Fork the repository.
Create a new branch (git checkout -b feature-branch).
Make your changes and commit them (git commit -m 'Add new feature').
Push to the branch (git push origin feature-branch).
Open a Pull Request.

Please ensure your code adheres to our coding standards and includes appropriate tests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For questions or support, please contact deerickkorir.

deerrickkorir/frontend