# READEASE

## Table of Contents

1. [App Overview](#App-Overview)
1. [Product Spec](#Product-Spec)
1. [Wireframes](#Wireframes)
1. [Build Notes](#Build-Notes)

## App Overview

### Description

**A camera-based OCR (Optical Character Recognition) reader designed to improve real-time reading comprehension for users with dyslexia or visual processing challenges. The user takes a picture of any text (menu, sign, document), and the app renders the text using customizable reading aids.**

### App Evaluation

<!-- Evaluation of your app across the following attributes -->

- **Category:** Accessibility/Productivity
- **Mobile:** Mobile-native because it relies on:
• Camera
• OCR scanning
• Real-time display modifications
This is not something a website can do well.
- **Story:** The value is extremely clear:
• Helps dyslexic or visually impaired users
• Real-time scanning + custom readability modes
• Helps students, children, and older adults
People respond strongly to apps that help real users.
- **Market:** Huge potential:
• 1 in 5 people have some level of dyslexia
• Millions struggle with reading processing
• Schools, accessibility groups, and parents would see value immediately
Defines a large niche with high need.
- **Habit:** Users will open it every time they need to read:
• Menus
• Signs
• Class readings
• Directions
Many will become daily users.
Users also create their own settings profiles—very sticky habit.
- **Scope:** The hardest parts:
• OCR (ML Kit makes easy)
• Custom text rendering modes (Bionic Reading, spacing, overlays)
Challenging but manageable.
MVP version is still impressive: take picture → extract text → display with custom font.

## Product Spec

### 1. User Features (Required and Optional)

Required Features:

- User can open camera and capture an image of text.

- OCR extracts text from the captured image using ML Kit.

- Extracted text is displayed in a large, readable text view.

-User can adjust:

Font size

Line spacing

Background color

Text contrast

-User can toggle:

Bionic Reading (bolding first half of each word)

Color Overlay (tinted background to reduce glare)

-User settings persist between sessions (SharedPreferences).

Stretch Features:

Text-to-speech reading of scanned text.

Save scanned pages to a “Reading History.”

Upload PDF or gallery images for OCR.

Automatic dyslexia profile detection via short reading test.

Multiple preset themes
- ...

### 2. Chosen API(s)

ML Kit – Text Recognition API

Used for OCR extraction from the captured image

CameraX API

Used to capture the image to be processed

Android SharedPreferences

Used to store user settings (font size, toggles, color modes)

SpannableString / Custom Text Rendering

Used for Bionic Reading style formatting
### 3. User Interaction

Required Feature

User taps “Scan Text”

=> Camera opens

=> User captures a photo

=> App runs OCR and navigates to the reading screen

User adjusts reading settings (sliders/toggles)

=> Text instantly re-renders with new visual formatting

User toggles Bionic Reading

=> Words re-render with bolded leading segments

User enables color overlay

=> Background tint applied to reduce line skipping and glare

## Wireframes


### [BONUS] Digital Wireframes & Mockups

### [BONUS] Interactive Prototype

## Build Notes

Here's a place for any other notes on the app, it's creation
process, or what you learned this unit!

For Milestone 2, include **2+ Videos/GIFs** of the build process here!

## License

Copyright **2025** **Isaiah Miller, Amarikiya Stephens, Harry Williams III**

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.