Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nikhilkumarmishra/bmi_calculator


https://github.com/nikhilkumarmishra/bmi_calculator

Last synced: about 2 months ago
JSON representation

Awesome Lists containing this project

README

        

# BMI Calculator App 📱💪

Welcome to the BMI Calculator App project! This app is designed to help users quickly calculate their Body Mass Index (BMI) and gain insights into their health status. Built using Kotlin and Android Studio, this app is both user-friendly and informative.

## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Screenshots](#screenshots)
- [Contributing](#contributing)
- [License](#license)
- [Contact](#contact)

## Features 🌟
- **Instant BMI Calculation**: Input your height and weight to get your BMI instantly.
- **User-Friendly Interface**: Simple and intuitive design for easy navigation.
- **Health Insights**: Provides health tips based on your BMI category.
- **Responsive Design**: Works seamlessly on various Android devices.

## Installation 🛠
To get a local copy up and running, follow these steps:

1. **Clone the repository**:
```sh
git clone https://github.com/your-username/bmi-calculator-app.git
```

2. **Open the project in Android Studio**:
- Open Android Studio
- Click on `File` > `Open` and select the cloned repository folder.

3. **Build the project**:
- Click on `Build` > `Make Project` to build the project.

4. **Run the app**:
- Connect your Android device or start an emulator.
- Click on `Run` > `Run 'app'` to install and start the app.

## Usage 📈
1. Open the app on your Android device.
2. Enter your height and weight.
3. Click on the `Calculate BMI` button.
4. View your BMI and the corresponding health insights.

## Screenshots 📸

![c](https://github.com/Nikhilkumarmishra/BMI_Calculator/assets/87891556/59530733-cd6a-4e5b-8a17-cd935aac0c3e)

![2](https://github.com/Nikhilkumarmishra/BMI_Calculator/assets/87891556/cdb11d05-a1a1-43c1-bd01-10c2187665d3)

## Contributing 🤝
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the project
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## License 📝
Distributed under the MIT License. See `LICENSE` for more information.

## Contact 📬
Nikhil Kumar Mishra - [LinkedIn](https://www.linkedin.com/in/nikhil-kumar-mishra/)

Project Link: [https://github.com/Nikhilkumarmishra/BMI_Calculator](https://github.com/Nikhilkumarmishra/BMI_Calculator)