Skip to content

RoadCare is a React + Firebase platform for smarter cities, where citizens report potholes or garbage with GPS and photos, fixers resolve issues, and admins validate. A GPS vehicle tracking wing adds transparency by monitoring municipal fleets and fixers in real time, ensuring accountability and community trust.

License

Notifications You must be signed in to change notification settings

Kavin4cK/RoadCare

Repository files navigation

Flutter

A modern Flutter-based mobile application utilizing the latest mobile development technologies and tools for building responsive cross-platform applications.

📋 Prerequisites

  • Flutter SDK (^3.29.2)
  • Dart SDK
  • Android Studio / VS Code with Flutter extensions
  • Android SDK / Xcode (for iOS development)

🛠️ Installation

  1. Install dependencies:
flutter pub get
  1. Run the application:

To run the app with environment variables defined in an env.json file, follow the steps mentioned below:

  1. Through CLI
    flutter run --dart-define-from-file=env.json
  2. For VSCode
    • Open .vscode/launch.json (create it if it doesn't exist).
    • Add or modify your launch configuration to include --dart-define-from-file:
    {
        "version": "0.2.0",
        "configurations": [
            {
                "name": "Launch",
                "request": "launch",
                "type": "dart",
                "program": "lib/main.dart",
                "args": [
                    "--dart-define-from-file",
                    "env.json"
                ]
            }
        ]
    }
  3. For IntelliJ / Android Studio
    • Go to Run > Edit Configurations.
    • Select your Flutter configuration or create a new one.
    • Add the following to the "Additional arguments" field:
    --dart-define-from-file=env.json

📁 Project Structure

flutter_app/
├── android/            # Android-specific configuration
├── ios/                # iOS-specific configuration
├── lib/
│   ├── core/           # Core utilities and services
│   │   └── utils/      # Utility classes
│   ├── presentation/   # UI screens and widgets
│   │   └── splash_screen/ # Splash screen implementation
│   ├── routes/         # Application routing
│   ├── theme/          # Theme configuration
│   ├── widgets/        # Reusable UI components
│   └── main.dart       # Application entry point
├── assets/             # Static assets (images, fonts, etc.)
├── pubspec.yaml        # Project dependencies and configuration
└── README.md           # Project documentation

🧩 Adding Routes

To add new routes to the application, update the lib/routes/app_routes.dart file:

import 'package:flutter/material.dart';
import 'package:package_name/presentation/home_screen/home_screen.dart';

class AppRoutes {
  static const String initial = '/';
  static const String home = '/home';

  static Map<String, WidgetBuilder> routes = {
    initial: (context) => const SplashScreen(),
    home: (context) => const HomeScreen(),
    // Add more routes as needed
  }
}

🎨 Theming

This project includes a comprehensive theming system with both light and dark themes:

// Access the current theme
ThemeData theme = Theme.of(context);

// Use theme colors
Color primaryColor = theme.colorScheme.primary;

The theme configuration includes:

  • Color schemes for light and dark modes
  • Typography styles
  • Button themes
  • Input decoration themes
  • Card and dialog themes

📱 Responsive Design

The app is built with responsive design using the Sizer package:

// Example of responsive sizing
Container(
  width: 50.w, // 50% of screen width
  height: 20.h, // 20% of screen height
  child: Text('Responsive Container'),
)

📦 Deployment

Build the application for production:

# For Android
flutter build apk --release

# For iOS
flutter build ios --release

🙏 Acknowledgments

Built with ❤️ on Rocket.new

About

RoadCare is a React + Firebase platform for smarter cities, where citizens report potholes or garbage with GPS and photos, fixers resolve issues, and admins validate. A GPS vehicle tracking wing adds transparency by monitoring municipal fleets and fixers in real time, ensuring accountability and community trust.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •