Chalokart User App

Chalokart is a Flutter-based mobile application that provides a seamless user experience for location-based services. The app integrates with Firebase for authentication and real-time data management, and uses Google Maps for location services.

Here is the link to download the apk file for ChaloKart User : https://drive.google.com/drive/folders/1cog-fnsOMIzHFqsGPa9Fu4xEjQx_iyDy?usp=sharing

Features

• User Authentication with Firebase
• Real-time Location Tracking
• Google Maps Integration
• Dark/Light Theme Support
• Push Notifications
• Payment Integration (Razorpay)
• Rating System
• Location-based Services

Prerequisites

Before you begin, ensure you have the following installed:

• Flutter SDK (version 3.7.0 or higher)
• Android Studio / VS Code
• Git
• Firebase CLI (optional, for Firebase setup)

Installing Flutter SDK

For macOS:

1. Download the Flutter SDK from Flutter's official website
2. Extract the downloaded file to a desired location (e.g., ~/development/flutter)
3. Add Flutter to your PATH by adding the following line to your ~/.zshrc or ~/.bash_profile:

   export PATH="$PATH:[PATH_TO_FLUTTER]/flutter/bin"

4. Run source ~/.zshrc or source ~/.bash_profile to reload the terminal
5. Verify the installation by running:

   flutter doctor

For Windows:

1. Download the Flutter SDK from Flutter's official website
2. Extract the zip file to a desired location (e.g., C:\src\flutter)
3. Add Flutter to your PATH by adding C:\src\flutter\bin to your system's PATH environment variable
4. Open a new terminal and verify the installation:

   flutter doctor

For Linux:

1. Download the Flutter SDK from Flutter's official website
2. Extract the file to a desired location (e.g., ~/development/flutter)
3. Add Flutter to your PATH by adding the following line to your ~/.bashrc:

   export PATH="$PATH:[PATH_TO_FLUTTER]/flutter/bin"

4. Run source ~/.bashrc to reload the terminal
5. Verify the installation:

   flutter doctor

Setting up the Project

1. Clone the repository:

   git clone [YOUR_REPOSITORY_URL]
   cd chalokart_user

2. Install dependencies:

   flutter pub get

Running the App

1. Open an emulator or connect a physical device

2. Run the app:

   flutter run

3. Select your target device when prompted

Project Structure

chalokart_user/
├── lib/
│   ├── main.dart              # App entry point
│   ├── screens/               # UI screens
│   ├── models/                # Data models
│   ├── services/              # Business logic
│   └── utils/                 # Utility functions
├── assets/                    # Static assets
├── android/                   # Android-specific files
├── ios/                       # iOS-specific files
└── pubspec.yaml              # Project dependencies

Dependencies

The app uses several key packages:

• firebase_core: Firebase core functionality
• firebase_auth: User authentication
• google_maps_flutter: Maps integration
• provider: State management
• geolocator: Location services
• razorpay_flutter: Payment processing

Troubleshooting

If you encounter any issues:

1. Run flutter doctor to check for any system configuration issues
2. Ensure all dependencies are up to date with flutter pub get
3. Clean the project with flutter clean and rebuild
4. Check the Firebase configuration files are properly set up
5. Verify your Google Maps API key is correctly configured

Contributing

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