WolfBite 🐺

A modern food delivery application with WIC eligibility verification

Features • Quick Start • Documentation • Contributing • License

📖 About

WolfBite is a cross-platform food delivery application developed for the CSC510 Software Engineering course at NC State University. The app features an innovative barcode scanning system that helps users verify WIC (Women, Infants, and Children) product eligibility in real-time.

Key Highlights

• 🔍 Smart Scanning: Real-time barcode scanning with WIC eligibility verification
• 🔐 Secure Authentication: Firebase-powered user authentication
• 🎨 Modern UI: Intuitive and responsive design

✨ Features

• Barcode Scanner: Scan product barcodes to check WIC eligibility instantly
• User Authentication: Secure sign-up and login with Firebase
• Shopping Cart: Add items and manage your cart seamlessly
• Order Management: Track your orders in real-time
• Responsive Design: Optimized for mobile and web platforms

🚀 Quick Start

Prerequisites

Before you begin, ensure you have the following installed:

• Flutter SDK (3.9.2 or higher)
• Dart SDK (included with Flutter)
• Git
• A code editor (VS Code, Android Studio, or IntelliJ IDEA recommended)

Installation

1. Clone the repository

   git clone https://github.com/SuyeshJadhav/CSC510_G19.git
   cd CSC510_G19/Project2
   

2. Install dependencies

   flutter pub get
   

3. Configure Firebase (if applicable)

   • Add your google-services.json (Android) and GoogleService-Info.plist (iOS)
   • Update Firebase configuration in the project

4. Run the application

   # For web
   flutter run -d chrome
   
   # For mobile (with device connected)
   flutter run
   
   # For specific platform
   flutter run -d <device_id>
   

5. Build for production

   # Android APK
   flutter build apk --release
   
   # iOS
   flutter build ios --release
   
   # Web
   flutter build web --release
   

📦 Dependencies

Our project leverages these carefully selected packages:

Note: All dependencies are automatically installed via `flutter pub get

🧪 Testing

Run the test suite to ensure code quality:

# Run all tests
flutter test

# Run tests with coverage
flutter test --coverage

# Run specific test file
flutter test test/screens/signup_page_test.dart

📚 Documentation

• User Guide - Comprehensive user documentation
• Contributing Guidelines - How to contribute to this project
• Code of Conduct - Community guidelines

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details on:

• Setting up the development environment
• Code style and standards
• Submitting pull requests
• Reporting issues

Development Workflow

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

👥 Team

CSC510 - Group 19

📄 License

This project is licensed under the MIT License - see the LICENSE.md file for details.

📄 Demo

📞 Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Email: Contact Team

Made with ❤️ by CSC510 Group 19

_{Built with Flutter • Powered by Firebase}