Welcome to QueueMe, a powerful queue management system designed to enhance customer flow in various business environments, including restaurants, clinics, and service centers. With QueueMe, users can join virtual queues, track their status, and receive real-time notifications. This README will guide you through the features, installation, usage, and contributions to this project.
QueueMe provides a range of features to ensure a smooth customer experience:
- Virtual Queues: Users can join queues from their devices without needing to be physically present.
- Status Tracking: Customers can easily track their position in the queue.
- Real-Time Notifications: Receive updates on queue status via notifications.
- User Authentication: Secure user management with login and registration functionalities.
- Data Management: Efficient backend powered by Express and Prisma.
QueueMe leverages several technologies to deliver its features:
-
Frontend:
- Next.js
- React.js
- Tailwind CSS
- React Router DOM
-
Backend:
- Express.js
- Prisma
- PostgreSQL
-
Other:
- HTML5
- CSS3
- JavaScript
- JSON
- Node.js
To get started with QueueMe, follow these steps:
-
Clone the Repository:
git clone https://github.com/SaphirEduc/QueueMe.git cd QueueMe
-
Install Dependencies: For both frontend and backend, run:
npm install
-
Set Up Environment Variables: Create a
.env
file in the root directory and configure your database connection and other necessary environment variables. -
Run Migrations: If you are using Prisma, run the following command to set up your database schema:
npx prisma migrate dev
-
Start the Application: To run the application, use:
npm run dev
Now, you can access QueueMe at http://localhost:3000
.
Once the application is running, users can:
- Join a Queue: Navigate to the queue section and select the service you wish to join.
- Track Your Status: Check your position in the queue from the dashboard.
- Receive Notifications: Enable notifications to stay updated on your queue status.
For detailed instructions, refer to the documentation.
We welcome contributions to QueueMe! If you want to help improve the project, follow these steps:
- Fork the Repository: Click the "Fork" button at the top right of the repository page.
- Create a Branch:
git checkout -b feature/YourFeatureName
- Make Your Changes: Implement your feature or fix.
- Commit Your Changes:
git commit -m "Add your message here"
- Push to the Branch:
git push origin feature/YourFeatureName
- Open a Pull Request: Go to the original repository and click "New Pull Request".
QueueMe is licensed under the MIT License. See the LICENSE file for more information.
For the latest releases, visit our Releases section.
Feel free to explore the repository, and if you have any questions, don't hesitate to reach out. Happy queuing!