Minor Update

Author: HRG-OFFICIAL

.gitignore

@@ -2,28 +2,83 @@
 *.apk
 *.ap_
 *.aab
+*.apks
+*.dex
 
-# Local configuration file (sdk path, etc)
-local.properties
+# Files for the ART/Dalvik VM
+*.class
 
-# Windows thumbnail db
-Thumbs.db
+# Generated files
+bin/
+gen/
+out/
+release/
 
-# OSX files
-.DS_Store
+# Gradle files
+.gradle/
+build/
+*/build/
+
+# Local configuration file (sdk path, etc)
+local.properties
+*.properties
+!gradle.properties
 
 # Android Studio
 *.iml
-.idea
-.gradle
-/build
-/captures
+.idea/
+.idea_modules/
+*.swp
+*.swo
+*~
 
 # NDK
 obj/
-.externalNativeBuild
-app/release/output-metadata.json
+.externalNativeBuild/
+.cxx/
+
+# IntelliJ IDEA
+*.iws
+/out/
+
+# User-specific configurations
+.idea/libraries
+.idea/workspace.xml
+.idea/tasks.xml
+.idea/.name
+.idea/compiler.xml
+.idea/copyright/profiles_settings.xml
+.idea/misc.xml
+.idea/modules.xml
+.idea/vcs.xml
+
+# OS-specific files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Captures
+/captures/
+
+# ProGuard
+*.pro
+
+# Release files
+/releases/
+*.mapping
+seeds.txt
+usage.txt
 
+# Kotlin
+*.kotlin_module
+.kotlin/
 
+# Miscellaneous
 *.salive
-/app/release/*
+*.log
+.cache/
+docs/

README.md

@@ -1,149 +1,129 @@
 # Android Calculator
 
-A modern, feature-rich calculator application for Android devices with a clean interface and powerful computation capabilities.
+An Android calculator application implementing basic and scientific mathematical operations with custom expression parsing.
 
-## ✨ Features
+## Features
 
-- **Basic Arithmetic**: Addition, subtraction, multiplication, and division
-- **Scientific Functions**: Trigonometric functions, logarithms, exponentials, and more
-- **Multiple Themes**: Light, dark, and AMOLED themes with Material Design 3 support
-- **Calculation History**: Keep track of previous calculations with persistent storage
-- **Expression Parsing**: Custom-built mathematical expression parser for accurate results
-- **Responsive Design**: Optimized for both portrait and landscape orientations
-- **Precision Control**: Configurable decimal precision and scientific notation
-- **Intuitive UI**: Clean, modern interface with haptic feedback support
+- Basic arithmetic operations (addition, subtraction, multiplication, division)
+- Scientific functions (trigonometric, logarithmic, exponential)
+- Expression parsing with operator precedence and parentheses
+- Multiple numbering system support (international, Arabic-Indic, etc.)
+- Calculation history with persistent storage
+- Theme configuration (light, dark, AMOLED)
+- Precision control for decimal output
+- Scientific notation support
+- Quick Settings tile integration
 
-## 🔧 Technical Details
+## Technical Details
 
-### Architecture
+### Technology Stack
 - **Language**: Kotlin
-- **UI Framework**: Android Views with View Binding
-- **Minimum SDK**: API 21 (Android 5.0)
-- **Target SDK**: API 34 (Android 14)
+- **Platform**: Android (API 21-34)
 - **Build System**: Gradle with Kotlin DSL
+- **UI**: Android Views with View Binding
+- **Architecture**: Activity-based with service components
 
-### Key Components
-- **Custom Calculator Engine**: Built-in mathematical expression evaluator using BigDecimal for precision
-- **Theme System**: Dynamic theming with support for system themes and custom color schemes
-- **History Management**: JSON-based calculation history with configurable storage limits
-- **Preference System**: Comprehensive settings with automatic migration support
+### Core Components
 
-## 📸 Screenshots
+#### Calculator Engine (`calculator/Calculator.kt`)
+- Mathematical expression evaluation using `BigDecimal` for precision
+- Supports trigonometric, logarithmic, and exponential functions
+- Handles special cases (division by zero, domain errors, syntax errors)
 
-### Light Theme
-<p align="center">
-  <img src="app/src/main/res/drawable/screenshots/Screenshot_20250905_235435.png" alt="Light Mode Portrait" width="250">
-</p>
+#### Expression Parser (`calculator/parser/Expression.kt`)
+- Converts user input into evaluable mathematical expressions
+- Handles symbol substitution (× → *, ÷ → /)
+- Manages operator precedence and parentheses
+- Formats percentage calculations
 
-### Dark Theme
-<p align="center">
-  <img src="app/src/main/res/drawable/screenshots/Screenshot_20250906_000106.png" alt="Dark Mode Portrait" width="250">
-  <img src="app/src/main/res/drawable/screenshots/Screenshot_20250906_000121.png" alt="Dark Mode Settings" width="250">
-</p>
+#### History Management (`history/History.kt`)
+- JSON-based storage using Gson
+- Persistent calculation records with timestamps
+- Configurable history limits
 
-### Scientific Mode & Features
-<p align="center">
-  <img src="app/src/main/res/drawable/screenshots/Screenshot_20250906_000718.png" alt="Scientific Mode" width="250">
-  <img src="app/src/main/res/drawable/screenshots/Screenshot_20250906_000742.png" alt="History View" width="250">
-  <img src="app/src/main/res/drawable/screenshots/Screenshot_20250906_001533.png" alt="Advanced Calculations" width="250">
-</p>
+### Project Structure
 
-## 🚀 Getting Started
+```
+app/src/main/
+├── java/com/android/calculator/
+│   ├── activities/           # Activity classes (MainActivity, SettingsActivity, AboutActivity)
+│   ├── calculator/           # Core calculation logic
+│   │   ├── Calculator.kt     # Mathematical operations implementation
+│   │   └── parser/           # Expression parsing utilities
+│   ├── history/              # Calculation history management
+│   ├── services/             # Background services (Quick Settings tile)
+│   └── util/                 # Utility classes (theme, preferences, scientific mode)
+└── res/                      # Android resources (layouts, values, drawables)
+```
+
+## Building the Project
 
 ### Prerequisites
-- Android Studio Arctic Fox (2020.3.1) or later
+- Android Studio Hedgehog (2023.1.1) or later
 - JDK 8 or higher
 - Android SDK with API 34
+- Gradle 8.0+
 
-### Building the Project
-
-1. Clone the repository:
-   ```bash
-   git clone <your-repository-url>
-   cd Android_Calculator
-   ```
+### Build Commands
 
-2. Open in Android Studio or build from command line:
-   ```bash
-   ./gradlew assembleDebug
-   ```
+```bash
+# Clone repository
+git clone https://github.com/HRG-OFFICIAL/Android-Calculator.git
+cd Android-Calculator
 
-3. Install on device:
-   ```bash
-   ./gradlew installDebug
-   ```
+# Build debug APK
+./gradlew assembleDebug
 
-## 🧪 Testing
+# Install on connected device
+./gradlew installDebug
 
-Run the test suite:
-```bash
-# Unit tests
+# Run unit tests
 ./gradlew testDebugUnitTest
 
-# Instrumented tests
+# Run instrumented tests
 ./gradlew connectedAndroidTest
-
-# All tests
-./gradlew test
 ```
 
-## 🎨 Customization
-
-The calculator supports extensive theming through:
-- **Color schemes**: Defined in `values/colors.xml` and `values-night/colors.xml`
-- **Typography**: Configurable font families and sizes
-- **Button styles**: Customizable button appearances and behaviors
+## Configuration
 
-## 📱 Supported Features
+### Supported Operations
+- Arithmetic: `+`, `-`, `×`, `÷`
+- Exponentiation: `^`, `E` (scientific notation)
+- Functions: `sin`, `cos`, `tan`, `ln`, `log`, `log₂`, `√`, `!`
+- Constants: `π`, `e`
+- Parentheses for precedence control
 
-### Mathematical Operations
-- Basic arithmetic (+, -, ×, ÷)
-- Parentheses for operation precedence
-- Percentage calculations
-- Square root and power operations
-- Factorial calculations
-- Trigonometric functions (sin, cos, tan)
-- Logarithmic functions (ln, log, log₂)
-- Constants (π, e)
+### Precision Settings
+- Configurable decimal places (0-15)
+- Scientific notation toggle
+- Rounding mode: HALF_UP
 
-### User Interface
-- Material Design 3 components
-- Adaptive layouts for different screen sizes
-- Smooth animations and transitions
-- Accessibility support
+## Testing
 
-## 🔒 Privacy
+Unit tests are located in `app/src/test/java/` and cover:
+- Expression parsing
+- Mathematical operations
+- Edge cases (division by zero, invalid operations)
 
-This calculator app:
-- **No network permissions**: All calculations are performed locally
-- **No data collection**: No user data is transmitted or stored externally
-- **Minimal permissions**: Only requests essential permissions for functionality
+Run tests:
+```bash
+./gradlew test
+```
 
-## 🤝 Contributing
+## Permissions
 
-Contributions are welcome! Please feel free to submit pull requests or open issues for bugs and feature requests.
+- `VIBRATE`: Haptic feedback on button presses
+- `SYSTEM_ALERT_WINDOW`: Display overlay for quick access
+- `USE_FULL_SCREEN_INTENT`: Quick Settings tile functionality
 
-### Development Guidelines
-- Follow Kotlin coding conventions
-- Write unit tests for new functionality
-- Update documentation for significant changes
-- Test on multiple screen sizes and orientations
+## Support
 
-## 📄 License
+If you find this project useful and would like to support its development, you can:
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+- Star this repository
+- Report bugs or suggest features
+- [Buy me a coffee](https://buymeacoffee.com/hrgofficial) to support continued development
 
-## 🏗️ Project Structure
+## License
 
-```
-app/
-├── src/main/
-│   ├── java/com/android/calculator/
-│   │   ├── activities/          # UI activities
-│   │   ├── calculator/         # Core calculation logic
-│   │   ├── history/            # History management
-│   │   ├── services/           # Background services
-│   │   └── util/              # Utility classes
-│   └── res/                   # Resources (layouts, strings, themes)
-└── src/test/                  # Unit and integration tests
-```
+This project is licensed under the MIT License - see [LICENSE](LICENSE) file for details.