prakruthics/KsheeraSagara

ksheera sagara android app # Ksheera-Sagara — Android (Kotlin + Jetpack Compose) Dairy Profit/Loss calculator for farmers, with English + Kannada, voice input, PDF milk slips & monthly reports, charts, and an in-app rule-based assistant. ## Open in Android Studio 1. Unzip `KsheeraSagara.zip` somewhere. 2. Open Android Studio (Hedgehog or newer recommended) → **Open** → select the `KsheeraSagara` folder. 3. Studio will prompt to **install Android SDK 34** and download Gradle 8.7. Accept all. 4. Create a `local.properties` file at the project root (next to `settings.gradle.kts`) with: - macOS/Linux: `sdk.dir=/Users/ /Library/Android/sdk` - Windows: `sdk.dir=C\:\\Users\\ \\AppData\\Local\\Android\\Sdk` (Studio usually writes this for you on first sync.) 5. **Sync Gradle**, then press ▶ Run on an emulator or device (Android 7.0+). > Internet is required on first build — Gradle pulls AndroidX, Compose BOM, Room, > and **MPAndroidChart** (via JitPack, already configured in `settings.gradle.kts`). ## Tech - **Kotlin 1.9.24**, **Jetpack Compose** (Material 3), Navigation Compose - **Room** (offline DB, seeded with sample data on first run) - **MPAndroidChart** (Pie + Line charts) - **Android PDF** (`PdfDocument`) for milk slips & monthly reports — shared via `FileProvider` - **SpeechRecognizer** (built-in) for voice input on the Liters field - MVVM with `ViewModel` + `StateFlow` ## Features - Splash with logo & animation (~2.4s) - Dashboard: income / expense / profit cards, 14-day profit line chart, expense pie, smart suggestions - Add Milk Entry (auto amount = liters × rate) + voice mic - Add Expense (categories: fodder/medical/labor/electricity/other) - Cows: add/delete, ⭐ best cow highlight - Reports: per-entry milk slip PDF (share via WhatsApp/Email/Drive), monthly summary PDF - Assistant chat: profit / best cow / cost reduction (rule-based, bilingual) - Settings: language toggle (EN / ಕನ್ನಡ), dark mode, reset data ## Notes - Currency printed as `Rs.` in PDFs to avoid font issues, `₹` u …