Parchment

<div align="center">

#  Parchment

### A Soulful PDF Reading Experience for Android

[![CI](https://github.com/AhmadHassan-BTed/PDF-Reader/actions/workflows/ci.yml/badge.svg)](https://github.com/AhmadHassan-BTed/PDF-Reader/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
[![Android](https://img.shields.io/badge/Android-9.0%2B-green.svg)](https://developer.android.com)
[![Kotlin](https://img.shields.io/badge/Kotlin-2.0-purple.svg)](https://kotlinlang.org)
[![Maintainer](<https://img.shields.io/badge/Maintainer-Ahmad%20Hassan%20(B--Ted)-8B6914>)](https://github.com/AhmadHassan-BTed)

---

**Reading is a sacred act of connection.**  
Parchment was engineered to remove the digital friction between the reader and the text.  
It brings the warmth of physical paper to the precision of modern Android engineering.

[Explore Architecture](#-architecture-overview) • [View Roadmap](ROADMAP.md) • [Contribute](CONTRIBUTING.md)

</div>

---

##  The Vision

Digital PDF readers often feel cold and industrial. **Parchment**, envisioned and engineered by **Ahmad Hassan (B-Ted)**, prioritizes the human element. By utilizing a "Warm Paper" design system and a gesture-driven interface, it replicates the focused, undistracted environment of a physical library.

---

##  Feature Ecosystem

| Feature              | Technical Implementation                  | Human Value                                |
| :------------------- | :---------------------------------------- | :----------------------------------------- |
| **Warm Aesthetic**   | Custom HSL-tailored Design System         | Reduces digital eye strain                 |
| **Parchment Engine** | Android `PdfRenderer` + 2× Super-sampling | Keeps text crisp at any zoom level         |
| **Interactive TOC**  | Flexible `TocItem` Model                  | Quick, outline-based navigation            |
| **Smart HUD**        | Auto-hiding gesture-aware UI              | Maximum immersion, zero clutter            |
| **Fluid Navigation** | `LazyColumn` + Haptic Feedback loops      | Tactile sense of progress                  |
| **Persistence**      | Synchronized `SharedPreferences` layer    | Never lose your place in a text            |

---

##  Architecture Overview

The system is built on a strict **Modular Layered Architecture**. This ensures 100% cohesion and zero coupling between the rendering engine and the data source.

```mermaid
graph TD
    subgraph Presentation_Layer [UI & Presentation]
        Main[MainActivity] --> Viewer[PdfViewerScreen]
        Viewer --> Comp[Extracted UI Modules]
        Comp --> Tokens[Design Tokens]
    end

    subgraph Domain_Layer [Business Logic]
        Viewer --> Repo[BookRepository]
        Viewer --> Prefs[ReadingPreferences]
    end

    subgraph Data_Layer [Resources]
        Repo --> Config[BookConfig Model]
        Config --> Assets[PDF Assets]
    end

    style Presentation_Layer fill:#F8F1E4,stroke:#8B6914,stroke-