BitFlip

A modern offline Android app for number-system conversion and binary arithmetic

BitFlip v4.0 is a modern, fast, and completely offline Android application designed to convert numbers between different bases, perform binary arithmetic, and solve complex math equations with a full scientific calculator — all with precision and clarity. Built with Kotlin and Jetpack Compose, this app provides not just the final result, but also the logical steps taken to reach it.

---

Features

Base Conversion

• Real-time Conversion: Instant results as you type. No "Convert" button required.
• Fractional Number Support: Full support for floating-point numbers (e.g., 12.625, A.8) across all bases.
• Integrated Step-by-Step Working: Full mathematical working shown automatically beneath your results (Repeated Division for integers, Multiplication for fractions).

Binary Arithmetic

• Addition (+): Binary addition with carry-chain walkthrough.
• Subtraction (−): Binary subtraction with borrow-chain walkthrough, supporting negative results.
• Multiplication (×): Binary multiplication with partial-product breakdown.
• Division (÷): Binary long division showing quotient and remainder with aligned-subtraction steps.
• Step-by-Step Working: Every operation displays bit-level steps so you can learn the process.

Scientific Calculator (New in v4.0)

• Advanced Math: Perform complex equations with sin, cos, tan, log, ln, √, powers, and absolute values.
• Degrees & Radians: Switch seamlessly between DEG and RAD modes.
• Smart Formatting: Instant error detection and clean mathematical result formatting.

General

• Persistent History: Automatically tracks and categorizes your conversions and calculations so you never lose your work.
• One-Tap Copy: Quickly copy results to your clipboard.
• Quick Reference: Built-in lookup table for Binary/Decimal/Hex equivalents (0–15).
• AMOLED Dark Theme: Elegant, battery-friendly interface designed for modern screens.
• Auto Update Check: Notifies you when a new version is available on GitHub.
• Privacy First: Core features work 100% offline. Internet is only used to check for updates. No tracking. No ads.

Permissions

Permission	Required For	Note
INTERNET	Update notification check	The app checks GitHub Releases on launch to notify you of new versions. All conversion and arithmetic features work fully offline without internet.

---

Installation

Recommended (Direct Install)

The fastest way to get the app on your phone:

1. Download the APK: Click here to download the latest .apk (or go to the Releases section).
2. Open the file: Tap the downloaded .apk file on your Android device.
3. Allow Installation: If prompted, allow "Install from unknown sources" in your security settings.
4. Done! You're ready to start converting.

---

Building from Source

If you want to contribute or build the app yourself:

Prerequisites

• Android Studio Ladybug (2024.2.1) or newer.
• JDK 17 or higher.
• Android SDK 35 installed.

Steps

1. Clone the repo:

   git clone https://github.com/cybersaad/BitFlip.git

2. Open in Android Studio: Choose Open and select the project folder.
3. Sync Gradle: Wait for the project to download all necessary dependencies.
4. Run: Connect your device/emulator and click the Run button.

---

Project Architecture

The app follows a clean, modular structure for maintainability:

com.bitflip.app/
├── ConversionEngine.kt       # Pure Kotlin logic for base conversions
├── CalculatorEngine.kt       # Engine for the scientific calculator expression parsing
├── HistoryManager.kt         # Local SharedPreferences persistence for activity tracking
├── UpdateChecker.kt          # GitHub Releases version checker
├── MainActivity.kt           # App entry point, bottom navigation & screen routing
└── ui/
    ├── screens/
    │   ├── DashboardScreen.kt          # Main hub with categorized tools
    │   ├── ScientificCalculatorScreen.kt # Scientific Calculator UI
    │   ├── ConverterScreen.kt          # Base conversion UI
    │   ├── ArithmeticScreen.kt         # Binary arithmetic UI
    │   ├── HistoryScreen.kt            # Categorized activity history UI
    │   ├── ReferenceScreen.kt          # Quick-reference lookup table
    │   └── AboutScreen.kt              # Developer info & app version
    └── theme/
        └── Theme.kt                    # Material3 glassmorphism AMOLED dark theme

• ConversionEngine.kt: Pure Kotlin logic for base conversions (reusable outside Android).
• ArithmeticScreen.kt: Self-contained binary arithmetic with step-by-step working.
• ui/screens/: UI components for Converter, Arithmetic, Reference, and About screens.
• ui/theme/: Theme definitions using Material3 design system.
• Bottom Navigation: Seamless transitions between four app sections.

---

Tech Stack

Component	Technology
Language	Kotlin 2.0+
UI Framework	Jetpack Compose (Material3)
Architecture	MVVM (State-driven UI)
Arithmetic	BigInteger for arbitrary-precision binary ops
Min SDK	API 24 (Android 7.0)
Target SDK	API 35 (Android 15)

---

Version History

Version	Highlights
4.0	Scientific Calculator, History Activity Tracking, Glassmorphism UI, Categorized Dashboard
3.0	Binary arithmetic operations (+, −, ×, ÷) with step-by-step working
2.0	Fractional number support, merged Converter + Steps into single screen
1.0	Initial release — integer base conversions with step-by-step working

---

Contribution

Contributions are welcome! If you find a bug or have a feature request, please open an Issue or submit a Pull Request.

---

License

© 2026 Saad Khan. All rights reserved. Developed with ❤️ by Saad Khan.