/imc-calculator-react-native

This mobile application helps you calculate your Body Mass Index (BMI) easily and quickly using React Native Expo and NativeWind for a sleek and responsive design.

Primary LanguageJavaScript

BMI Calculator 📱

This mobile application helps you calculate your Body Mass Index (BMI) easily and quickly using React Native Expo and NativeWind for a sleek and responsive design.

Table of Contents

Introduction

The IMC Calculator is a simple and efficient tool designed to help users monitor their body mass index (BMI). The BMI is a useful indicator of whether an individual has a healthy body weight for a given height. This app is built with React Native using Expo for easy cross-platform development and NativeWind for beautiful, responsive designs.

What is IMC?

IMC, or Índice de Massa Corporal (Body Mass Index - BMI), is a value derived from the mass (weight) and height of a person. The BMI is defined as the body mass divided by the square of the body height and is universally expressed in units of kg/m², resulting from mass in kilograms and height in meters. IMC on Wikipedia

BMI Categories:

  • Underweight: BMI < 18.5
  • Normal weight: BMI 18.5–24.9
  • Overweight: BMI 25–29.9
  • Obesity: BMI ≥ 30

Features

  • Instant BMI Calculation: Enter your weight and height to get your BMI instantly.
  • Responsive Design: Smooth and adaptive UI designed with NativeWind.
  • Health Tips: Get basic tips based on your BMI category.
  • Cross-Platform: Available on both Android and iOS.

Installation

To test it in your mobile app, you can download it troughout this link: Download Here

To run this project locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/OumarouSandaSouley/imc-calculator-react-native.git
cd imc-calculator-react-native

  2. Install dependencies:

    npm install

  3. Start the project:

    npx expo start

Usage

  1. Open the app: Launch the app on your device or simulator.
  2. Enter your details: Input your weight in kilograms and height in meters.
  3. Calculate: Press the calculate button to see your BMI and category.
  4. Health Tips: View personalized health tips based on your BMI result.

Screenshots

Home Screen Result Screen

Technologies

  • React Native: For building native apps using React.
  • Expo: For a fast development process and easy build tools.
  • NativeWind: For responsive and beautiful UI design.

Contributing

I welcome contributions! Please follow these steps to contribute:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/your-feature).
  3. Make your changes.
  4. Commit your changes (git commit -m 'Add some feature').
  5. Push to the branch (git push origin feature/your-feature).
  6. Open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

Created by Oumarou Sanda Souley. Feel free to contact me!