Update README.md

README.md

@@ -1,5 +1,5 @@
 ---
-title: PoultryFeedCalc
+title: HowMuchFeed
 emoji: 🐔
 colorFrom: green
 colorTo: yellow
@@ -9,8 +9,112 @@ app_file: app.py
 python_version: 3.12
 ---
 
-# 🐔 PoultryFeedCalc
+# 🐔 How Much Feed?
 
-Broiler feed, weight and cost calculator for Nigerian poultry farmers.
+**Broiler feed calculator for farmers worldwide — estimate how many bags of feed you need before buying.**
 
-This MVP uses Ross 308 performance benchmarks for planning and keeps Nigerian farm-management guidance separate from the numerical benchmark.
+## 🎯 What This Tool Does
+
+Stop guessing feed quantities. How Much Feed uses breed and flock information to provide practical feed estimates in seconds.
+
+| What You Get | How It Helps |
+|--------------|--------------|
+| **Total feed needed** | Estimate how much feed your flock may require |
+| **Bags to buy** | Get a rounded-up purchasing recommendation |
+| **Starter/Finisher split** | See the estimated feed requirement for each stage |
+| **Feed cost estimate** | Plan your feed budget using your local bag price |
+| **Breed comparison** | Compare Ross 308, Cobb 500, and Arbor Acres |
+| **Expected performance** | View benchmark-based weight estimates |
+| **Share results** | Send results via WhatsApp, Email, Facebook, or X |
+
+---
+
+## 🚀 Quick Start
+
+### Live Demo
+
+👉 **[https://www.howmuchfeed.com](https://www.howmuchfeed.com)**
+
+### How to Use
+
+1. **Select your breed** — Ross 308, Cobb 500, or Arbor Acres
+2. **Enter flock details** — Number of birds and age
+3. **Set feed parameters** — Bag size and price per bag
+4. **Enter your email** — Where required by the calculator
+5. **Click Calculate** — Get your feed estimate instantly
+
+---
+
+## 📊 Features
+
+### 🐔 Breed Selection
+
+Choose from:
+
+- **Ross 308**
+- **Cobb 500**
+- **Arbor Acres**
+
+### 📈 Feed Calculation
+
+- Total estimated feed in kilograms
+- Exact bag equivalent
+- Rounded bags to buy
+- Starter feed — Day 0–21
+- Finisher feed — Day 22+
+
+### 💰 Cost Estimation
+
+- Estimated total feed cost
+- Cost based on your entered bag price
+- Local currency support where available
+
+### 📈 Expected Performance
+
+View benchmark-based estimates for:
+
+- Expected body weight
+- Expected flock weight
+- Feed conversion information where available
+
+### 📤 Share Results
+
+- Share on WhatsApp
+- Share via Email
+- Share on Facebook
+- Share on X (Twitter)
+
+### 📊 Benchmark Data
+
+- Weekly benchmark data for the selected breed
+- Breed comparison across supported breeds
+- Benchmark-based feed and performance estimates
+
+---
+
+## 🌍 Built for Farmers Worldwide
+
+How Much Feed is designed for farmers in different countries and markets.
+
+You can adapt the calculation to your own:
+
+- Country
+- Currency
+- Feed bag size
+- Feed price
+- Flock size
+- Bird age
+
+The goal is simple: **make broiler feed planning easier wherever you farm.**
+
+---
+
+## ⚠️ Important
+
+How Much Feed provides **planning estimates based on breed-performance benchmarks**. Actual feed consumption and bird performance can vary depending on feed quality, management, environment, bird health, genetics, stocking conditions, and other farm factors.
+
+Use the results as a planning guide and monitor your flock's actual performance.
+
+---
+
+**🐔 How Much Feed — making broiler feed planning simpler.**