README.md

# Swift iOS Calculator

A comprehensive, professional-grade calculator application for iOS featuring advanced mathematical capabilities, AI-powered problem solving, and modern platform integration.

## 📱 Features

### Core Calculators
- **Basic Calculator** - Standard arithmetic operations with memory functions
- **Scientific Calculator** - Advanced mathematical functions and constants
- **Programmer Calculator** - Binary, hexadecimal, octal, and decimal conversions
- **Unit Converter** - Convert between 50+ units across 7 categories
- **Currency Converter** - Real-time currency exchange rates for 20+ currencies
- **Graphing Calculator** - 2D function plotting with zoom and pan
- **3D Graphing Calculator** - Multivariable surface visualization with SceneKit

### Advanced Mathematics
- **AI Math Solver** - Step-by-step solutions for algebra, calculus, and more
- **Matrix Calculator** - Complete linear algebra operations
- **Equation Solver** - Algebraic and differential equation solving
- **Statistics Calculator** - Data analysis and statistical computations

### Specialized Calculators
- **Financial Calculator** - Investment, retirement, and loan calculations
- **Geometry Calculator** - 2D and 3D shape calculations
- **Physics Calculator** - Mechanics, optics, and thermodynamics
- **Chemistry Calculator** - Molar mass, reactions, and stoichiometry
- **Engineering Calculator** - Circuit analysis and material calculations

### Platform Integration
- **iOS Widgets** - Home screen quick access widgets
- **Apple Watch App** - Companion calculator for Apple Watch
- **Siri Shortcuts** - Voice commands and deep linking
- **Camera Scanning** - Scan math problems with your camera
- **Voice Input** - Enter equations using voice commands

### User Experience
- **5 Beautiful Themes** - Light, Dark, Blue, Green, and Sunset themes
- **Calculation History** - Track and reuse previous calculations
- **Haptic Feedback** - Tactile feedback for better user experience
- **Animations** - Smooth transitions and micro-interactions
- **Accessibility** - Full VoiceOver and accessibility support

## 🚀 Installation

1. Clone the repository
2. Open `Swift iOS Calculator.xcodeproj` in Xcode
3. Select your target device or simulator
4. Build and run the project

## 📋 Requirements

- iOS 14.0+
- Xcode 12.0+
- Swift 5.0+

## 🏗️ Project Structure

```
Swift iOS Calculator/
├── AppDelegate.swift # App lifecycle management
├── SceneDelegate.swift # Scene management
├── MainTabBarController.swift # Main navigation
├── Core Calculators/
│ ├── CalculatorViewController.swift
│ ├── ScientificCalculatorViewController.swift
│ ├── ProgrammerCalculatorViewController.swift
│ └── GraphingCalculatorViewController.swift
├── Advanced Mathematics/
│ ├── AIMathSolverViewController.swift
│ ├── Graphing3DViewController.swift
│ ├── MatrixCalculatorViewController.swift
│ └── EquationSolverViewController.swift
├── Converters/
│ ├── UnitConverterViewController.swift
│ └── CurrencyConverterViewController.swift
├── Specialized/
│ ├── FinancialCalculatorViewController.swift
│ ├── GeometryCalculatorViewController.swift
│ ├── PhysicsCalculatorViewController.swift
│ ├── ChemistryCalculatorViewController.swift
│ └── EngineeringCalculatorViewController.swift
├── Platform Integration/
│ ├── CalculatorWidget.swift
│ ├── WatchCalculatorViewController.swift
│ └── SiriShortcutsManager.swift
├── Utilities/
│ ├── CalculatorLogic.swift
│ ├── CalculatorTheme.swift
│ ├── CalculatorSettingsViewController.swift
│ ├── CalculatorHistoryViewController.swift
│ └── CalculatorUtils.swift
├── Resources/
│ ├── Assets.xcassets/
│ ├── Base.lproj/ (Storyboards)
│ └── Info.plist
└── Swift iOS Calculator.xcodeproj/
```

## 🎨 Themes

The app includes 5 beautiful themes:
- **Light** - Clean, bright interface
- **Dark** - Easy on the eyes in low light
- **Blue** - Professional blue color scheme
- **Green** - Nature-inspired green theme
- **Sunset** - Warm orange and red tones

## 🧮 Calculator Types

### Basic Calculator
- Addition, subtraction, multiplication, division
- Memory functions (M+, M-, MR, MC)
- Percentage calculations
- Square root and power functions

### Scientific Calculator
- Trigonometric functions (sin, cos, tan, asin, acos, atan)
- Logarithmic functions (log, ln, exp)
- Power and root functions
- Mathematical constants (π, e)
- Angle unit conversions (degrees/radians)

### Programmer Calculator
- Number base conversions (binary, octal, decimal, hexadecimal)
- Bitwise operations (AND, OR, XOR, NOT)
- Shift operations (<<, >>)
- 8, 16, 32, and 64-bit support
- Signed and unsigned integer support

### Unit Converter
Categories include:
- **Length**: Meter, Kilometer, Mile, Yard, Foot, Inch
- **Weight**: Kilogram, Gram, Pound, Ounce, Ton
- **Temperature**: Celsius, Fahrenheit, Kelvin, Rankine
- **Volume**: Liter, Gallon, Quart, Pint, Cup
- **Area**: Square Meter, Square Foot, Hectare, Acre
- **Speed**: m/s, km/h, mph, knot
- **Time**: Second, Minute, Hour, Day, Week, Month, Year

### Currency Converter
- 20+ major world currencies
- Real-time exchange rate updates
- Favorite currency pairs
- Historical rate tracking

### Graphing Calculator
- Multiple function plotting
- Zoom and pan functionality
- Grid and axis display
- Function color coding
- Export capabilities

### 3D Graphing Calculator
- Multivariable surface plotting
- Interactive 3D rotation
- Multiple color schemes
- Adjustable resolution
- Preset mathematical functions

### AI Math Solver
Categories include:
- **Algebra**: Equation solving, factoring, simplification
- **Calculus**: Derivatives, integrals, limits
- **Trigonometry**: Identities, equations, proofs
- **Geometry**: Area, volume, perimeter calculations
- **Statistics**: Mean, median, mode, standard deviation
- **Physics**: Formulas and problem solving

Features:
- Step-by-step solutions
- Camera problem scanning
- Voice input support
- Problem history
- Difficulty levels

### Matrix Calculator
- Matrix operations (addition, subtraction, multiplication)
- Scalar multiplication
- Transpose, determinant, inverse
- Rank calculation
- Eigenvalue computation
- Support for 2×2, 3×3, 4×4 matrices

## 🔧 Technical Features

### Architecture
- **MVC Pattern** - Clean separation of concerns
- **Modular Design** - Easy to extend and maintain
- **Protocol-Oriented** - Leverages Swift protocols
- **Memory Management** - Efficient resource usage

### Platform Integration
- **iOS 14 Widgets** - Home screen quick access
- **Apple Watch** - Native watchOS app
- **Siri Shortcuts** - Voice command integration
- **Deep Linking** - URL scheme support
- **Background Updates** - Currency rate updates

### User Experience
- **Theme System** - Dynamic theme switching
- **Haptic Feedback** - Tactile responses
- **Animations** - Smooth transitions
- **Accessibility** - VoiceOver support
- **Localization Ready** - Multi-language support

## 📊 Data Storage

- **UserDefaults** - Settings and preferences
- **Core Data** - Calculation history (optional)
- **Keychain** - Secure data storage
- **iCloud Sync** - Cross-device synchronization

## 🔒 Privacy & Security

- **Local Processing** - All calculations done locally
- **No Data Collection** - No user data sent to servers
- **Secure Storage** - Sensitive data encrypted
- **Permissions** - Minimal app permissions required

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

## 📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

## 👥 Team

- **Developer**: Molla Samser (Founder, RSK World)
- **Designer & Tester**: Rima Khatun

## 📞 Contact

- **Email**: info@rskworld.com
- **Phone**: +91 93305 39277
- **Website**: https://rskworld.in
- **Address**: Nutanhat, Mongolkote, Purba Burdwan, West Bengal, India - 713147

## 🗓️ Version History

### Version 1.0.0 (January 2026)
- Initial release with all core calculator types
- AI-powered math solver
- 3D graphing capabilities
- Matrix calculator
- Platform integration (widgets, watch, Siri)
- 5 beautiful themes
- Comprehensive documentation

---

**Made with ❤️ by RSK World**

*© 2026 RSK World. All rights reserved.*