LensApp

A small React Native document scanner. Point it at a page, it crops the edges, lets you review, and saves a PDF you can share.

Built on react-native-document-scanner-plugin with a custom native PDF generator and react-native-share for export.

What's in it

• Scan multi-page documents with automatic edge detection (Google ML Kit on Android, VisionKit on iOS)
• Review pages and apply filters (Original, Grayscale, B&W, Enhanced)
• Persist scans locally, rename and delete them
• Export as PDF — share a single page or the whole document

Screens live in src/screens/ — Home, Scan, Review, Viewer. Navigation is plain state in App.tsx; there's no router dependency. Document storage is a simple hook (src/hooks/useDocumentStore.ts).

Requirements

• Node 18+
• JDK 17, Android SDK (for Android)
• Xcode + CocoaPods (for iOS)

The usual React Native 0.73 setup. If you haven't done this before, the RN environment guide is the canonical reference.

Running it

Install:

npm install

iOS only — install pods:

cd ios && pod install && cd ..

Start Metro in one terminal:

npm start

Then in another:

npm run android
# or
npm run ios

Tests

Unit tests (Jest + React Native Testing Library):

npm test

Builds

Android release APKs are split per-ABI (armeabi-v7a, arm64-v8a, x86_64) — see android/app/build.gradle. Per-arch APKs are smaller than a universal one.

CI builds live in .github/workflows/.

Project layout

App.tsx                # screen switcher + top-level state
src/
  screens/             # Home, Scan, Review, Viewer
  components/          # DocumentCard, FilterPicker
  hooks/               # useDocumentStore
  utils/               # generatePdf, imageProcessing
  types/               # shared types
patches/               # patch-package patches applied postinstall

Notes

• PDF generation is handled by a custom native module (PdfGeneratorModule.kt / PdfGeneratorModule.swift) rather than a third-party library.
• postinstall runs patch-package — if a patch fails to apply after a dependency bump, check patches/.

Roadmap

• 1. Getting the App to a stable working state with no unpredictable behaviour.
• 2. Create a simple logo for the App.
• 4. Adding a sponsor/donate, share and contact us button.
• 3. Post the app on Play Store.