Sonar 🪙 — Live Gold Rate & Nifty 50 Radar for India

Sonar (सोनार) is a high-performance, open-source fintech radar built for the Indian market. Track live 22K & 24K gold rate today, silver price, Nifty 50 live, Sensex, and Bank Nifty across 50+ Indian cities — all in your preferred language (Hindi, Tamil, Telugu and 8 more).

---

📖 Table of Contents

• Overview
• Key Features
• Screenshots
• Architecture & Tech Stack
• Getting Started
• API Configuration
• Release Builds
• Branding & Metadata
• License

---

🌟 Overview

Sonar is your daily radar for wealth in India. Built for investors, jewelers, and families, it combines live precious metal rates (gold & silver) with major Indian equity indices (Nifty 50, Sensex, Bank Nifty) in one fast, beautiful app.

Whether you're checking gold rate in Delhi today for a wedding (shadi), tracking Nifty 50 live for your portfolio, or monitoring silver prices for business — Sonar gives you accurate, real-time data in 10+ Indian languages with minimal data usage.

---

🔍 Frequently Asked Questions (FAQ)

Does Sonar show gold rate for my city?

Yes! Sonar tracks accurate 22K and 24K gold rate today and silver rates for 50+ major Indian cities — Delhi, Mumbai, Bangalore, Hyderabad, Chennai, Kolkata, Pune, Ahmedabad, Jaipur, Lucknow and more. Updated in real-time.

Can I track Nifty 50, Bank Nifty and Sensex?

Yes. Sonar shows Nifty 50 live, BSE Sensex, Bank Nifty and key sectoral indices with clean charts.

Is Sonar free?

100% free, open-source (MIT), no ads, no tracking, no paywall. Built for Bharat.

Does it work on slow networks?

Yes. Sonar is offline-first with smart caching. Works beautifully even on 4G or patchy connections.

Which languages are supported?

Full support for 10+ Indian languages: Hindi, Tamil, Telugu, Bengali, Marathi, Gujarati, Kannada, Malayalam, Punjabi, and English. Switch anytime.

---

✨ Key Features

• Live Gold & Silver Rates — Real-time 22K/24K gold rate today and silver price per kg across 50+ Indian cities.
• Nifty 50 & Sensex Live — Clean tracking of Nifty 50, Bank Nifty, Sensex and major Indian indices.
• Sonar Design — Premium glass-morphic dark UI (#031427 navy) with buttery animations — built for daily use by Indian traders & families.
• 10+ Indian Languages — Native experience in Hindi, Tamil, Telugu, Bengali, Marathi, Gujarati, Kannada, Malayalam, Punjabi & English.
• Price Alerts & Watchlist — Get notified when gold or Nifty hits your target price.
• Lightweight & Private — Minimal data usage, offline caching, zero trackers or ads. Pure focus on rates.

---

📱 Screenshots

Premium Glass-morphic UI across all core features

---

🛠 Architecture & Tech Stack

Aureum follows modern Android development best practices and Clean Architecture:

• Language: Kotlin
• UI Framework: Jetpack Compose with Material 3
• Dependency Injection: Hilt
• Networking: Retrofit & OkHttp
• Reactive Programming: Kotlin Coroutines & Flow
• Data Management: DataStore (Preferences)
• Image Loading: Coil

---

🚀 Getting Started

Prerequisites

• Android Studio Hedgehog (2023.1.1) or higher.
• JDK 17 or higher.
• Android SDK 35 (compileSdk).
• Minimum SDK 24 (Android 7.0).

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/RateWatch.git

2. Open the project in Android Studio.
3. Sync Gradle and build the project.

---

📡 API Configuration

To protect sensitive endpoints and facilitate open-source contributions, Aureum uses a local.properties configuration system.

1. Locate local.properties in your root directory (automatically created by Android Studio).
2. Add your custom API base URLs:

   GOLD_SILVER_BASE_URL=https://your-api.com/
   STOCK_API_BASE_URL=https://your-api.com/

Note: The app expects these endpoints to follow the Scraper API Schema.

---

📦 Release Builds

To generate production-ready artifacts:

1. Android App Bundle (.aab)

./gradlew bundleRelease

Path: app/build/outputs/bundle/release/app-release.aab

2. APK (.apk)

./gradlew assembleRelease

Path: app/build/outputs/apk/release/app-release.apk

---

🔑 Signing Configuration

The project uses key.properties for release signing. Do NOT commit key.properties or *.jks files to version control.

Example key.properties:

storePassword=your_password
keyPassword=your_password
keyAlias=ratewatch
storeFile=ratewatch-release.jks

---

🎨 Branding & Metadata

• Brand: Sonar (सोनार) — Live Gold, Silver & Nifty Radar for India
• Play Store Listing: Fully ASO-optimized metadata in listing.md targeting Indian keywords (gold rate today, nifty 50 live, etc.)
• Assets: App icon, feature graphic and screenshots in playstore_listing/
• Recommended Title: Sonar - Gold Rate & Nifty 50 (29 chars)

---

📝 License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2026 Sonar (KwikTwik)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

---

Made with ❤️ for Bharat. Sonar — your daily radar for gold rate, silver price & Nifty 50.