Skip to Content
HeviFi Rentals Released 🥳🎉 Download Version 1.0 →

Release v1.0.0

Release Date: June 1, 2025 Application: HeviFi – Heavy Vehicle Rental Platform Supported Platforms: Android, Windows, Web (experimental) Version Tag: v1.0.0

💡

Download the HeviFi app to manage your heavy vehicle rentals on the go. Available for both Android and Windows.

Overview

v1.0.0 is the first stable release of HeviFi. It introduces the foundational architecture for a role-based heavy vehicle rental application targeting customers, owners, and drivers. This version includes full support for Android and Windows platforms, with web support in experimental phase. The application delivers core functionality for user authentication, vehicle listing, real-time booking, and multilingual interface, built using a cross-platform UI framework.

The release incorporates over 230 development commits, extensive integration of third-party modules, and a modular service-based backend.

Major Features

1. Authentication and Onboarding

  • Secure authentication with support for email and phone number verification using OTP.
  • Role-specific user onboarding flows for Customer, Owner, and Driver.
  • Persistent login using local session management with token refresh support.

2. Role-Based User Dashboards

  • Three distinct UI dashboards:

    • Customers can browse available vehicles, create bookings, and track their order status.
    • Owners can list new vehicles, respond to booking proposals, and manage ongoing assignments.
    • Drivers receive booking assignments and can update job status and locations.
  • Navigation and functionality are restricted based on the authenticated role to prevent privilege escalation.

3. Booking and Proposal Lifecycle

  • Unified booking screen with constraint-based filtering and auto-syncing of vehicle availability.
  • Proposal system allowing owners to bid or respond to booking requests.
  • System state transitions managed using status flags and socket-based real-time communication.

4. Vehicle and Inventory Management

  • Owners can register and manage their heavy vehicle inventory via dedicated forms.
  • Vehicles are linked to bookings and proposals through backend data models.
  • Availability status is automatically updated based on assignment state.

5. Real-Time Notification System

  • Live updates using WebSockets with auto-reconnect and session tracking.
  • Push notifications for Android devices.
  • Badge indicators within UI for unread or pending events.

6. Localization and Internationalization

  • Interface supports multiple languages using .arb localization files.
  • Language can be selected during onboarding or updated later in settings.
  • English is used as the fallback language across all screens.

7. UI/UX and Theming

  • Material Design 3 implemented with dark/light mode support.
  • Theming system based on HEX color tokens for consistency across roles and devices.
  • Responsive design supports tablets and small-screen devices.

Technical Stack

Frontend

  • Framework: Flutter 3.32.0
  • Packages: provider, intl, flutter_local_notifications, socket_io_client, google_fonts, permission_handler

Backend

  • Architecture: REST API
  • Technologies: Node.js, Express.js, MongoDB
  • Features: JWT authentication, role-based access control, real-time event broadcasting

Deployment Targets

  • Android: SDK 21+
  • Windows: Flutter Desktop (.exe build)
  • Web: Experimental with limited functionality

Configuration and Build

  • Manual build pipelines for Android (.apk) and Windows (.exe) using Flutter stable channel.
  • Separate environment files for development and production deployment.
  • Server endpoints configured via secure .env files, consumed through build-time injection.
  • GitHub repository used for version control, issue tracking, and release tagging.

Known Limitations

  • Web build lacks advanced socket stability and may not support all real-time interactions consistently.
  • Location accuracy and permission behavior may vary across Android versions.
  • Admin dashboard is not included in this version; backend is pre-configured for role-based interaction only.

Development Metrics

  • Commits: ~230
  • Modules: 25+
  • Screens: 35+ across all user roles
  • Total LOC (Flutter only): Approx. 19,000

Full commit history is available on the official repository.

Repository and Resources

Planned Features (Roadmap Preview)

  • Administrative dashboard for internal system control
  • Integrated payment system for online bookings
  • Offline sync support for unstable network regions
  • Advanced reporting and analytics module
  • Route tracking for drivers using GPS

Let me know if you want this reformatted as .mdx, split by feature module, or linked to changelogs automatically.



Last updated on