VendPal is a modern web application designed to streamline vending operations. It provides a user-friendly interface to manage products, monitor sales, and optimize business performance. This project leverages cutting-edge technologies to deliver a seamless user experience.
Access the application live here: VendPal
- Product Management: Add, edit, and delete vending products effortlessly.
- Sales Tracking: Monitor and analyze sales performance in real-time.
- Customizable Settings: Tailor features to fit business needs.
- Responsive Design: Fully optimized for desktop and mobile devices.
- Analytics Dashboard: Visual insights to make data-driven decisions.
-
Frontend:
- Next.js 15.0.3 (with Turbopack for performance)
- React 18
- TypeScript
- Tailwind CSS for styling
- ShadCN UI components
-
Backend:
- Integration with data storage
-
State Management:
- Zustand for local state management
- React Query for server-state synchronization
-
Others:
- Formik & Yup for form management and validation
- Vercel for deployment
Ensure you have the following installed on your machine:
- Node.js (>= 16.0.0)
- npm or yarn package manager
-
Clone the Repository
git clone https://github.com/your-username/vendpal.git cd vendpal -
Install Dependencies
npm install # OR yarn install -
Run the Development Server
npm run dev # OR yarn devOpen http://localhost:3000 to view the app in your browser.
To ensure the application runs smoothly:
-
Run Tests:
npm test # OR yarn test
-
Lint and Format Code:
npm run lint npm run format
This application is hosted on Vercel. To deploy:
- Push changes to the
mainbranch (or a designated production branch). - Vercel will automatically trigger a build and deploy the latest changes.
Contributions are welcome! Follow these steps:
- Fork the repository.
- Create a feature branch.
git checkout -b feature/your-feature-name
- Commit your changes.
git commit -m "Add your message here" - Push to your fork.
git push origin feature/your-feature-name
- Submit a Pull Request.
- Integration with payment gateways.
- Enhanced analytics and reporting.
- Support for multiple languages.
- Offline mode for mobile devices.
This project is licensed under the MIT License.
- ShadCN UI for pre-designed components.
- Vercel for seamless deployment.
For issues, suggestions, or feature requests, please open an issue in the GitHub repository.
Enjoy using VendPal! 🎉