Open source · npm package

blurry-check

Browser-side upload quality validation for images and PDFs — files never leave the device.

Maintained by
James UgbanuMaintainer
Language
TypeScript
GitHub stars
4
Latest version
v1.1.1
Technologies
TypeScript · JavaScript

Install

npm install blurry-check

Requires Node.js with npm. Full usage is documented in the GitHub README.

Documentation highlights

Blurry Check Browser-side upload quality validation for images and PDFs. Files never leave the device — all analysis runs client-side. **[Try the Live Demo →]([redacted-url])** Features - **Pre-upload Validation** — Check files in the browser before they reach your server - **Blur Detection** — Sobel edge analysis + OpenCV Laplacian variance - **PDF Quality** — Multi-page analysis with text sharpness, orientation, document frame detection - **Brightness & Contrast** — Content-aware checks that handle white document backgrounds - **Blank Detection** — Catch empty/white images as a single clear issue - **File Validation** — MIME type, extension, binary magic byte checks - **Stable Issue Codes** — 19 catalogued issue codes for business logic (`blurry`, `too_dark`, `cropped`, etc.) - **Non-blocking Warnings** — Scanned PDFs, low text density, cover pages are informational by default

Full documentation in the blurry-check GitHub README →

© 2026 James Ugbanu