🌱 Vegan Rehber

A Progressive Web App to help users find vegan products in supermarkets in Turkey. Built with React, TypeScript, and Tailwind CSS.

✨ Features

• 📱 Progressive Web App (PWA) with offline support
• 🔍 Search products by name, brand, or category
• 📸 Barcode scanner for quick product lookup
• ❤️ Save favorite products
• 🏷️ Browse products by categories
• 📝 Report issues or suggest new products
• 💫 Beautiful, responsive UI with smooth animations

🚀 Getting Started

Prerequisites

• Node.js 18 or higher
• npm or yarn

Installation

1. Clone the repository:

git clone https://github.com/UmutHasanoglu/vegan-rehber.git
cd vegan-rehber

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

4. Build for production:

npm run build

🛠️ Built With

• React - UI Framework
• TypeScript - Type Safety
• Vite - Build Tool
• Tailwind CSS - Styling
• React Router - Routing
• HTML5-QRCode - Barcode Scanner

📱 PWA Features

• Installable on mobile devices
• Offline support
• Fast loading times
• Push notifications (coming soon)

🗄️ Project Structure

src/
├── components/     # Reusable UI components
├── context/       # React Context for state management
├── data/          # Data and data loading utilities
├── pages/         # Page components
└── types/         # TypeScript type definitions

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🙏 Acknowledgments

• Lucide for the icon set
• All contributors who help make this project better

📬 Contact

Project Link: https://github.com/UmutHasanoglu/vegan-rehber Email: [email protected]

Made with ❤️ for the vegan community