Skip to content

Sadi5/unit_converter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โšก Unit Converter

A modern Flutter Android application for converting between multiple units instantly.
Built with clean architecture, GetX state management, and responsive design.


๐Ÿš€ Overview

Unit Converter lets you convert units in real time โ€” even offline.
Itโ€™s fast, precise, and designed with a clean Material 3 interface that adapts beautifully to all screen sizes.


โœจ Features

๐Ÿ”ง Core Functionality

  • โšก Unit Conversion: Real-time conversion as you type
  • ๐ŸŒ 6 Categories: Comprehensive list of units
    • Length: cm, m, km, inch, foot, yard, mile
    • Weight: g, kg, lb, oz, ton
    • Volume: ml, L, cup, pint, gallon
    • Temperature: ยฐC, ยฐF, Kelvin
    • Area: mยฒ, kmยฒ, acre, hectare
    • Speed: km/h, m/s, mph, knots
  • ๐Ÿ” Swap Units: Quickly swap โ€œfromโ€ and โ€œtoโ€ values
  • ๐Ÿ“ด Offline Ready: Works without internet access

๐Ÿ’ก User Experience

  • ๐Ÿ•“ Recent Conversions: Automatically saves the last 5 conversions
  • ๐Ÿ“‹ Copy Results: One-tap copy to clipboard
  • ๐Ÿ“ฑ Responsive Design: Optimized for small to large Android devices
  • ๐ŸŽจ Modern UI: Material 3 with gradients and clean typography
  • ๐ŸงŠ Splash Animation: Smooth transitions and minimal startup delay

๐Ÿง  Technical Features

  • ๐Ÿงฉ Clean Architecture: Organized with controllers, models, and utilities
  • โšก GetX: Reactive state management and navigation
  • ๐Ÿ’พ SharedPreferences: Local storage for conversion history
  • ๐Ÿงฎ Accurate Formulas: Centralized and reusable conversion logic
  • โœ… Validation: Real-time input validation and error handling

๐Ÿ› ๏ธ Tech Stack

Component Technology
Framework Flutter 3.x
State Management GetX
Responsive UI Sizer
Local Storage SharedPreferences
Architecture Clean Architecture

โš™๏ธ Getting Started

Prerequisites

  • Android Studio or VS Code
  • Android SDK

Installation

# Clone the repository
git clone <repository-url>
cd unit_converter

# Install dependencies
flutter pub get

# Run the app
flutter run

Build for Release

# Build APK
flutter build apk --release

# Build App Bundle (for Play Store)
flutter build appbundle --release

๐Ÿ“ฑ Screenshots


๐Ÿ”ง Configuration

  • App Name: Unit Converter

๐Ÿงช Testing

# Run unit tests
flutter test

# Run integration tests
flutter drive --target=test_driver/app.dart

โšก Performance

Metric Result
Startup Time < 2 seconds
Conversion Speed < 50 ms
App Size < 20 MB
Memory Usage Optimized for low-end devices

๐Ÿ”ฎ Future Enhancements

  • Currency conversion with live exchange rates
  • Scientific units (physics, chemistry)
  • Dark mode
  • Custom unit creation
  • Export conversion history
  • Voice input
  • Multi-language support

๐Ÿค Contributing

  1. Fork this repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit changes (git commit -m 'Add amazing feature')
  4. Push to branch (git push origin feature/amazing-feature)
  5. Open a Pull Request ๐Ÿš€

๐Ÿ™ Acknowledgments

  • Flutter team for the amazing framework
  • GetX community for simplicity and reactivity
  • Material Design for inspiration
  • Contributors and testers

Made with โค๏ธ by Sadia Liaqat

Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

For help getting started with Flutter development, view the online documentation, which offers tutorials, samples, guidance on mobile development, and a full API reference.

About

A modern Flutter Android application for converting between multiple units instantly. Built with clean architecture, GetX state management, and responsive design.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors