KrocPDF

An all-in-one file converter and PDF toolkit built with Flutter.

---

Toolchain & Versions (Pinned)

• Flutter SDK: 3.44.6 (channel stable, revision ee80f08bbf)
• Dart SDK: 3.12.2
• Application ID / Bundle ID: com.krocpdf.app

---

Platform Status

• Android: Verified. minSdkVersion = 24, targetSdkVersion = 35. Release builds require zero runtime permissions. Debug builds include android.permission.INTERNET solely for Flutter tooling/debugging.
• iOS: Configured. Deployment target 13.0, bundle identifier com.krocpdf.app. Note: iOS is unbuilt and unverified in Phase 1 and will be validated on a macOS host using this repository in a later phase.

---

Setup & Running Locally

Prerequisites

Ensure Flutter 3.44.6 and Dart 3.12.2 are installed and available on your PATH:

flutter --version

1. Install Dependencies

Dependencies are strictly pinned in pubspec.yaml:

flutter pub get

2. Run Static Analysis

Ensure zero issues:

flutter analyze

3. Run Tests

Execute the automated test suite:

flutter test

4. Run the Application

Launch on a connected Android device or emulator:

flutter run

5. Re-generating Native Splash Screen

If the logo image or splash background colors are modified, update flutter_native_splash.yaml and regenerate the native Android & iOS splash assets:

dart run flutter_native_splash:create

---

Architectural Guidelines

• Decisions: All architectural decisions are documented in docs/DECISIONS.md. Every change is tracked using sequential ADRs.
• Architecture: Complete structure, navigation, and service interfaces are documented in docs/ARCHITECTURE.md.
• Git Policy: Local commits only. Do not push to remote repositories until explicitly approved.