From 7511bd5832a038c2a114a540889bf6b38c58c0dd Mon Sep 17 00:00:00 2001
From: 202310715277 LALU MUHAMMAD ANGGANA SUBHAN
 <202310715277@mhs.ubharajaya.ac.id>
Date: Fri, 7 Nov 2025 17:12:03 +0700
Subject: [PATCH] Update README.md

---
 README.md | 121 ++++++++++++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 114 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 08d4aa4..c4c1b37 100644
--- a/README.md
+++ b/README.md
@@ -1,10 +1,117 @@
-Kalkulator BMI
-===============
+# 🧮 BMI Kalkulator (Body Mass Index)
 
-Silahkan kembangkan aplikasi ini untuk melakukan perhitungan BMI
+Aplikasi sederhana untuk menghitung **Indeks Massa Tubuh (BMI)** menggunakan **Kotlin** dan **Jetpack Compose**.  
+Proyek ini dibuat untuk latihan memahami **input form**, **state management**, dan **UI Compose Material 3** di Android.
 
-Petunjuk lebih detil dapat dibaca di
-https://docs.google.com/document/d/1iGiC0Bg3Bdcd2Maq45TYkCDUkZ5Ql51E/edit?rtpof=true
+---
 
-Starter dimodifikasi dan terinspirasi dari:
-https://developer.android.com/codelabs/basic-android-compose-calculate-tip#0
\ No newline at end of file
+## 📱 Fitur Utama
+- Input **berat badan (kg)** dan **tinggi badan (cm)**.
+- Tombol **Hitung BMI** dengan hasil langsung tampil di layar.
+- Menampilkan **kategori BMI** (Kurus, Normal, Gemuk, Obesitas).
+- Tema **Material 3 (Light & Dark Mode)**.
+- Tampilan UI responsif dan modern.
+
+---
+
+## ⚙️ Teknologi yang Digunakan
+- **Kotlin**
+- **Jetpack Compose**
+- **Material Design 3**
+- **Android Studio Iguana / Koala+**
+- **State Hoisting** dan **Composable Functions**
+
+---
+
+## 📊 Rumus BMI
+\[
+BMI = \frac{berat\ badan\ (kg)}{(tinggi\ badan\ (m))^2}
+\]
+
+### Contoh:
+Jika berat = 70 kg dan tinggi = 170 cm  
+→ BMI = 70 / (1.7 × 1.7) = **24.22**
+
+---
+
+## 💡 Kategori BMI
+| Rentang BMI | Kategori |
+|--------------|-----------|
+| < 18.5 | Kurus |
+| 18.5 – 24.9 | Normal |
+| 25.0 – 29.9 | Gemuk |
+| ≥ 30.0 | Obesitas |
+
+---
+
+## 🖼️ Screenshot
+(tambahkan screenshot hasil aplikasi di sini)
+
+---
+
+## 🚀 Cara Menjalankan
+1. Clone repository:
+   ```bash
+   git clone https://github.com/username/BMI-Kalkulator.git
+Lalu Muhammad Anggana Subhan
+Dibuat sebagai latihan proyek Kotlin Jetpack Compose.
+
+---
+
+## 🇺🇸 **README untuk BMI Amerika (Imperial Unit)**
+
+```markdown
+# 🇺🇸 BMI Calculator (Imperial Version)
+
+An Android app for calculating **Body Mass Index (BMI)** using **imperial units** (pounds & inches).  
+Built with **Kotlin** and **Jetpack Compose**, this app demonstrates form handling and Compose UI design.
+
+---
+
+## 📱 Features
+- Input **weight (lbs)** and **height (inches)**.
+- Instant **BMI calculation** with one button.
+- Displays **BMI category** (Underweight, Normal, Overweight, Obese).
+- Supports **dark and light themes**.
+- Clean Material 3 interface.
+
+---
+
+## ⚙️ Tech Stack
+- **Kotlin**
+- **Jetpack Compose**
+- **Material 3 Components**
+- **Android Studio (Koala or newer)**
+
+---
+
+## 📊 BMI Formula (Imperial)
+\[
+BMI = \frac{703 × berat\ (lbs)}{(tinggi\ (in))^2}
+\]
+
+### Example:
+If weight = 160 lbs and height = 70 in  
+→ BMI = 703 × 160 / (70 × 70) = **22.96**
+
+---
+
+## 💡 BMI Categories
+| Range | Category |
+|--------|-----------|
+| < 18.5 | Underweight |
+| 18.5 – 24.9 | Normal |
+| 25.0 – 29.9 | Overweight |
+| ≥ 30.0 | Obese |
+
+---
+
+## 🖼️ Screenshots
+(Add screenshots or preview images here)
+
+---
+
+## 🚀 How to Run
+1. Clone the repository:
+   ```bash
+   git clone https://github.com/username/BMI-Calculator-Imperial.git