Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/itxsaaad/kariger.com-app-mern

A Technician Booking App built using MERN Stack for FYP of Batch-23 PUGC
https://github.com/itxsaaad/kariger.com-app-mern

bcryptjs expressjs jwt-token mongodb nodejs reactjs tailwindcss vitejs

Last synced: about 1 month ago
JSON representation

A Technician Booking App built using MERN Stack for FYP of Batch-23 PUGC

Awesome Lists containing this project

README

        

# Kariger.com - Find any Karigers Nearby

> A MERN Web Application that lets the User to Make Appointments with a Kariger nearby to solve his daily life problems..








Explore the docs »





View Demo
·
Report Bug
·
Request Feature


[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]

## Live Preview Project

[Live Preview](https://kariger-com-app-mern.vercel.app//)

## Features

- Home Screen: Landing page with an overview of the app's features and navigation options.
- Dashboards: Admin can create, edit, and delete user accounts, assign roles, and manage permissions from admin dashboard. Kariger's can see their orders on Kariger Dashboard.
- Login/Register Screen: Allows users to sign in or register with their email and password or social media accounts.
- User Profile Screen: Displays user information and allows them to edit their profiles, change their passwords, or delete their accounts.
- Navbar and Footer Component: Navigation components that appear on all screens and allow users to access help or log out of their accounts.
- Technician Screen: Displays a list of Karigers and allows users to filter them by Categories.
- Technician Details Screen: Displays detailed information about a Kariger, including their location, reviews, and the services they provide.
- User Dashboard Screen: Displays a list of the user's orders and allows them to create, edit, or delete orders.
- Technician Dashboard Screen: Displays a list of the Kariger's orders and allows them to accept or reject orders.
- Admin Dashboard Screen: Displays a list of all users and allows the admin to create, edit, or delete users.

## Tech Stack

KAriger.com uses a number of open source projects to work properly:

- [React.Js] - HTML enhanced for web apps!
- [React Router] - A library for managing routing in React applications.
- [Redux.Js] - A predictable state container for JavaScript apps.
- [Redux Thunk] - A middleware for Redux that allows you to write action creators that return a function instead of an action.
- [Redux-Devtools-Extension] - A live-editing time travel environment for Redux with hot reloading, action replay, and customizable UI.
- [React-Redux] - Official React bindings for Redux.
- [Font Awesome] - The web's most popular icon set and toolkit.
- [Axios] - Promise based HTTP client for the browser and node.js.
- [TailwindCSS] - A utility-first CSS framework for designing responsive and customizable UI components.
- [Vite.Js] - BoilerPlate for React Application
- [Node.js] - Evented I/O for the backend
- [Express] - Fast node.js network app framework
- [MongoDB] - A document-oriented NoSQL database used for high volume data storage.
- [Mongoose] - An Object Data Modeling (ODM) library for MongoDB and Node. js.
- [JWT] - JSON Web Token (JWT) is a compact URL-safe means of representing claims to be transferred between two parties.
- [Bcrypt] - A library to help you hash passwords.
- [Body-Parser] - Node.js body parsing middleware.
- [Concurrently] - Run multiple commands concurrently.
- [Dotenv] - A zero-dependency module that loads environment variables from a .env file into process.env.
- [Nodemon] - A utility that will monitor for any changes in your source and automatically restart your server.
- [ESLint] - A tool for identifying and reporting on patterns found in ECMAScript/JavaScript code.
- [Router] - A middleware for routing requests to different handlers depending on the request URL.
- [Cors] - A middleware for handling Cross-Origin Resource Sharing (CORS).
- [Email-Vaildator] - A library for validating email addresses.
- [GitHub] - GitHub, Inc. is a provider of Internet hosting for software development and version control using Git.
- [Thunder Client] - A REST client extension for VS Code.

## Getting Started

### Prerequisites

You need to have Node.js and npm installed on your machine.

### Installation

Clone the repository to your local machine and navigate to the project directory.

```bash
git clone https://github.com/itxSaaad/kariger.com-app-mern.git
cd kariger.com-app-mern
```

Install the dependencies by running the following command:

```bash
npm run install
```

Start the development server:

```bash
npm run dev
```

## Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## Contact

- Junaid Ahmad - [@junaid-ahmad-a07950203](https://www.linkedin.com/in/junaid-ahmad-a07950203) - [email protected]
- Muhammad Saad - [@itxSaaad](https://www.linkedin.com/in/itxsaaad/) - [email protected]

Project Link: [https://github.com/itxSaaad/kariger.com-app-mern](https://github.com/itxSaaad/kariger.com-app-mern)

## License

Kariger.com is licensed under the [Creative Commons Zero v1.0 Universal](./LICENSE)

## Support

Give ⭐️ if you like this project!

[contributors-shield]: https://img.shields.io/github/contributors/itxSaaad/kariger.com-app-mern.svg?style=for-the-badge
[contributors-url]: https://github.com/itxSaaad/kariger.com-app-mern/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/itxSaaad/kariger.com-app-mern.svg?style=for-the-badge
[forks-url]: https://github.com/itxSaaad/kariger.com-app-mern/network/members
[stars-shield]: https://img.shields.io/github/stars/itxSaaad/kariger.com-app-mern.svg?style=for-the-badge
[stars-url]: https://github.com/itxSaaad/kariger.com-app-mern/stargazers
[issues-shield]: https://img.shields.io/github/issues/itxSaaad/kariger.com-app-mern.svg?style=for-the-badge
[issues-url]: https://github.com/itxSaaad/kariger.com-app-mern/issues
[license-shield]: https://img.shields.io/github/license/itxSaaad/kariger.com-app-mern.svg?style=for-the-badge
[license-url]: https://github.com/itxSaaad/kariger.com-app-mern/blob/main/LICENSE.md