From 22cdc561c113eecdc2fbc0fb8f9ca4ff5449648c Mon Sep 17 00:00:00 2001 From: Fadzel <202310715220@mhs.ubharajaya.ac.id> Date: Fri, 7 Nov 2025 15:30:38 +0700 Subject: [PATCH] update: perbaiki isi README --- README.md | 71 +++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 56 insertions(+), 15 deletions(-) diff --git a/README.md b/README.md index ac6fa6d..01de4e2 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,63 @@ -# BMI Calculator +A simple **Body Mass Index (BMI) Calculator** Android app built using **Kotlin** and **Jetpack Compose**. +This project was created for the **UTS 2025–2026** Android development coursework. -Aplikasi kalkulator BMI (Body Mass Index) sederhana untuk Android yang dibuat dengan Jetpack Compose. Aplikasi ini membantu pengguna untuk menghitung dan memantau kesehatan tubuh berdasarkan tinggi dan berat badan. +--- -## ✨ Fitur +## 📱 Features -- **Kalkulasi BMI**: Menghitung BMI berdasarkan tinggi dan berat badan pengguna. -- **Dukungan Sistem Satuan**: Mendukung satuan Metrik (kg/cm) dan Imperial/US (lb/inch). -- **Kategori BMI**: Menampilkan kategori BMI (misalnya Kurus, Normal, Gemuk, Obesitas) berdasarkan hasil perhitungan. -- **Umpan Balik Visual**: Menampilkan gambar ilustratif yang sesuai dengan setiap kategori BMI. -- **Antarmuka Pengguna yang Ramah**: UI yang bersih dan sederhana dengan layar pembuka dan kalkulator interaktif. +- 🧍‍♂️ Input height and weight +- ⚖️ Choose between **Metric (SI)** and **US Customary (USC)** units +- 💡 Automatic BMI calculation and category detection +- 🖼️ Dynamic illustration based on BMI category (e.g., underweight, normal, overweight, obese) +- 🎨 Clean modern UI built with **Material 3 (Jetpack Compose)** +- 🏁 Simple navigation with a **Get Started** screen and **About Developer** page -## 🛠️ Dibangun Dengan +--- -- **[Kotlin](https://kotlinlang.org/)**: Bahasa pemrograman utama. -- **[Jetpack Compose](https://developer.android.com/jetpack/compose)**: Toolkit modern dari Android untuk membangun UI native. +## 🧩 Screens -## 👨‍💻 Tentang Pengembang +1. **Get Started** – App logo, welcome message, and start button +2. **BMI Calculator** – Input fields for height/weight, unit selection, and live BMI result with category & image +3. **About Developer** – Information about the developer/team -- **Nama**: Fadzel -- **Universitas**: Universitas Bhayangkara Jakarta Raya -- **Tahun**: © 2025 +--- + +## ⚙️ Tech Stack + +- **Language:** Kotlin +- **UI Framework:** Jetpack Compose +- **Theme:** Material Design 3 +- **IDE:** Android Studio (Giraffe+ recommended) + +--- + +## 🚀 How to Run + +1. Clone this repository: + ```bash + git clone https://github.com/username/Starter-UTS-2025-2026.git + + +Open the project in Android Studio + +Sync Gradle & install dependencies + +Run the app on an emulator or physical device + +📊 BMI Categories +Category BMI Range +Underweight < 18.5 +Normal 18.5 – 24.9 +Overweight 25 – 29.9 +Obese ≥ 30 +👨‍💻 Developer + +Name: Muhammad Fadzel Hadean Rukrus +Institution: Universitas Bhayangkara +Project: UTS Mobile Programming – BMI Calculator App +Year: 2025 + +⚠️ Disclaimer + +This project was developed with the assistance of AI (ChatGPT by OpenAI) to accelerate learning, improve Kotlin and Jetpack Compose implementation, and refine UI/UX design. +All logic, structure, and testing have been reviewed and adapted manually to ensure correctness and originality. \ No newline at end of file