Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mahmoudelsayed7/body-metrics
Flutter-based BMI calculator app using Riverpod for state management, featuring an intuitive interface, multi-language support, and customizable text styles for a personalized user experience
https://github.com/mahmoudelsayed7/body-metrics
bmi bmi-calc bmi-calculator bmicalculator calculator flutter flutter-android flutter-apps flutter-riverpod hooks-river localization multi-language-support riverpod sharedpreferences
Last synced: 6 days ago
JSON representation
Flutter-based BMI calculator app using Riverpod for state management, featuring an intuitive interface, multi-language support, and customizable text styles for a personalized user experience
- Host: GitHub
- URL: https://github.com/mahmoudelsayed7/body-metrics
- Owner: MAHMOUDELSAYED7
- Created: 2023-08-17T23:20:02.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-06T08:03:50.000Z (about 1 month ago)
- Last Synced: 2025-01-01T05:44:03.799Z (6 days ago)
- Topics: bmi, bmi-calc, bmi-calculator, bmicalculator, calculator, flutter, flutter-android, flutter-apps, flutter-riverpod, hooks-river, localization, multi-language-support, riverpod, sharedpreferences
- Language: Dart
- Homepage:
- Size: 1.42 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Body Metrics
Body Metrics is a user-friendly Body Mass Index (BMI) calculator application built using Flutter and managed with Riverpod for state management. The app provides an intuitive interface for users to calculate their BMI and understand their health status based on the BMI value. With support for multiple languages and customizable text styles, Body Metrics ensures a personalized experience for every user.
## Features
### BMI Calculation
Body Metrics calculates your Body Mass Index (BMI) based on your weight and height. BMI is a simple index of weight-for-height that is commonly used to classify underweight, overweight, and obesity in adults. The app provides the following functionalities:
- Input fields for `weight(kilograms)` and `height(centimeters)`.
- Instant calculation of BMI upon entering the required values.
- Clear display of the BMI result with a classification `(Underweight, Normal weight, Overweight, Obese)`.
- User-Friendly UI
The app is designed with a focus on simplicity and ease of use. The clean layout ensures that users can quickly enter their details and view their BMI results without any hassle.
### Multi-Language Support
BodyMetrics supports `two languages`:
- **`Arabic`**
- **`English`**
Users can easily switch between languages from the settings menu, making the app accessible to a broader audience.
### Customizable Text Styles/Font Families
To enhance user experience, Body Metrics `offers three different font families`:
- **`Poppins:`** A modern and clean font family.
- **`GermaniaOne:`** A unique and eye-catching font family.
- **`MetalMania:`** A bold and dynamic font family.
Users can select their preferred text style from the settings menu.
## Screenshots
## Getting Started
To get started with BodyMetrics, follow these steps:
**`Step 1:`** Clone the Repository
First, you'll need to clone the repository from GitHub. Open your terminal and run the following command:
```
https://github.com/MAHMOUDELSAYED7/Body-Metrics.git
```
Replace with the actual URL of your repository if it was changed.
**`Step 2:`** Install Dependencies
After navigating to the project directory, you need to install all the necessary dependencies. Run:
```
flutter pub get
```
This command fetches all the dependencies listed in the `pubspec.yaml` file.
**`Step 3:`** Configure the App
Ensure all necessary configurations are done. This includes adding your assets and setting up environment variables if needed. Verify that your `pubspec.yaml` file includes all required `assets` and `fonts`.
**`Step 4:`** Run the Application
Finally, run the application on your desired device using the following command:
`
```
flutter run
```
This command compiles your Flutter app and deploys it to the connected device or simulator.
Additional Tips
**`Updating Dependencies:`** If there are any updates to the dependencies, you can update them using:
```
flutter pub upgrade --major-versions
```
Flutter Doctor: Run flutter doctor to ensure that your development environment is set up correctly.
```
flutter doctor
```
This command checks your environment and displays a report of the status of your Flutter installation, dependencies, and connected devices.
By following these steps, you'll have the Body Metrics app and running on your device. If you encounter any issues during installation, please refer to the Flutter documentation.
## Dependencies
- **`flutter_riverpod:`** State management using Riverpod.
- **`flutter_screenutil:`** Responsive UI design utility.
- **`intl:`** Internationalization and localization support.
- **`shared_preferences:`** Persistent local storage management.
- **`vertical_weight_slider:`** Vertical slider widget for weight.
## Usage
### Calculate (BMI):
- Enter your weight and height:
- Input your weight in the provided weight slider.
- Input your height in the provided height slider.
### View your BMI result:
- The app will automatically calculate and display your BMI along with the respective classification.
### Change language:
- Go to the settings menu.
- Select your preferred language `(Arabic or English)`.
### Change font family:
- Go to the settings menu.
- Choose from the available font family `(Poppins, GermaniaOne, MetalMania)`.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## Contact
For any questions or feedback, please reach out via email: [[email protected]]([email protected])