Skip to content

ak0586/BhuMitra

Repository files navigation

BhuMitra - Land Area Measurement App (NestJS Ready) 🌾

Flutter NestJS PostgreSQL Version

BhuMitra is a professional land measurement application built with Flutter. It has been upgraded to a high-performance, enterprise-ready architecture capable of supporting 100,000+ simultaneous users.


📱 App Screenshots


✨ Features (Enterprise Edition)

🚀 Scalability & Performance

  • NestJS Core: Migrated from Firebase to a custom optimized NestJS + PostgreSQL backend.
  • 100k User Ready: Architected for high-concurrency with Redis-backed caching and database indexing.
  • Gzip Data Compression: API responses are compressed to save mobile bandwidth and accelerate loading.
  • Fast Local Storage: Uses Hive for synchronous, lightning-fast local data management.

🛡️ Advanced Security

  • App Secret Handshake: Every request is signed with a unique x-app-id to block unauthorized clients.
  • JWT Protection: Secure token-based authentication with session displacement detection.
  • Secure Storage: Sensitive tokens are stored in Android Keystore / iOS Keychain via flutter_secure_storage.

🗺️ GIS & Mapping

  • Interactive Boundary Marking: Precision polygon marking with dynamic distance labels.
  • Pro PDF Engine: Generates 2-page GIS reports with satellite imagery 85% faster than previous versions.
  • Multi-Unit Precision: Automatic conversion between Acres, Hectares, Sq. Feet, Sq. Yards, and more.
  • Dual Map Modes: Seamless switching between OpenStreetMap and Google Satellite imagery.

🏗️ Architecture

State Management (Riverpod)

BhuMitra follows a declarative state management pattern using Riverpod. This ensures the UI is always in sync with the backend data without the complexity of BuildContext.

Networking (Dio)

Enterprise-grade HTTP client implementation:

  • Interceptors: Automatic JWT injection for authenticated routes.
  • Security Checksums: Automatic x-app-id header injection for every API call.
  • Error Mapping: User-friendly error messages for connection timeouts and server issues.

🚀 Getting Started

1. Prerequisites

  • Flutter SDK 3.10+
  • BhuMitra NestJS Backend (Running locally or on AWS)

2. Environment Setup

Create a .env file in the project root:

# Backend Base URL
BASE_URL=https://your-api-url.com/api

# Security Handshake Key (Must match Backend)
APP_ID=BhuMitra_Secure_Alpha_2026_X9z7Pq2Km

3. Installation

flutter pub get
flutter run

🤝 Project Links


Built with ❤️ for Land Professionals.

About

BhuMitra is a comprehensive Flutter application for accurate land area measurement using GPS coordinates and interactive map marking. Designed for farmers, surveyors, and land professionals.

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors