LapProFix is a open source web application designed to provide users with a convenient way to book laptop repair services from certified service centers. The platform emphasizes user experience by allowing for easy service booking, real-time progress tracking, and interactive support through a built-in chatbot.
We welcome all contributors! Whether you're a seasoned developer or a newbie in open source, follow these steps to contribute:
- Fork the Repository
Click the Fork button at the top-right corner of this repository to create your own copy.
- Clone Your Fork
Once you've forked the repository, clone it to your local machine:
git clone https://github.com/VishnuAmit/LapProFix.git
- Create a New Branch
Always create a new branch for your changes:
git checkout -b your_branch
- Do staging in it
Make Your Changes
git add .
- Commit Your Changes:
git commit -m "Relevant message"
- Push to Your Branch:
git push origin your_branch
- Create a Pull Request:
Go to your forked repository on GitHub and create a pull request to the main repository and i'll merge it as soon as i can.
There are several ways you can help improve LapProFix:
- 🛠️ Bug Fixes: Found a bug? We’d love your help fixing it.
- 📦 New Features: Have a cool idea to make the platform better? Add it!
- 📜 Documentation: If you think our docs can be improved, feel free to enhance them.
- 💡 Ideas & Discussions: You can open an issue to discuss new features or improvements.
To maintain quality and consistency, please adhere to the following guidelines:
- Code Style: Follow the coding style used throughout the project. Clean, readable code with comments is always appreciated.
- Commits: Write meaningful commit messages.
- Pull Requests: Make sure PRs are focused, well-explained, and reference any issues they address.
- Testing: Ensure that your changes are well-tested locally and don’t break existing functionality.
- Environment Setup: Make sure your
.env
file and MongoDB connection are properly configured.
- User Authentication: Users can sign up and log in securely to manage their bookings.
- Dashboard: An intuitive dashboard displaying service options, user profile, and booking history.
- Service Booking:
- Instant Book for quick service requests.
- Specialized services for Windows, Apple, and other laptop types.
- Technician Scheduling:
- Automated scheduling of technicians based on the user's issues reported during the booking process.
- Users can select specific time slots for technician visits, enhancing convenience and flexibility.
- Progress Tracking:
- A visual progress bar indicating the current status of the service request:
- Booking
- Assigning
- Service Progress
- Complete
- A visual progress bar indicating the current status of the service request:
- Chatbot Assistance:
- A built-in chatbot to assist users with common queries and provide real-time support.
- Frontend:
- Next.js: For building dynamic user interfaces.
- Axios: For making HTTP requests to the backend.
- Backend:
- Node.js: JavaScript runtime for building the server.
- Express.js: Web framework for Node.js to handle requests and responses.
- MongoDB: NoSQL database for storing user and booking information.
- Mongoose: ODM for MongoDB to define models and schemas.
- Authentication:
- JWT (JSON Web Tokens): For user authentication and secure session management.
- Deployment:
- Vercel: For hosting the application.
- Other Libraries/Tools:
- dotenv: For managing environment variables.
- Bcrypt.js: For hashing user passwords.
We are proud participants of Hacktoberfest 2024! Here's how to get started:
- Register for Hacktoberfest to get started.
- Open at least 4 quality PRs during October and help us improve LapProFix!
Make sure your PRs are:
- Focused: Try to keep them small and meaningful.
- High-Quality: Test your changes and follow best practices.
- We extend our heartfelt gratitude for your invaluable contribution to our project! Your efforts play a pivotal role in elevating LapProFix to greater heights.
- Make sure you show some love by giving ⭐ to our repository.
Happy Coding 💻 and we look forward to your contributions during Hacktoberfest 2024! 🎃