# BlowUpImage

> BlowUpImage is a browser-based professional photo editor that runs 100% locally in your browser. It offers pro-grade tonal adjustments (curves, HSL, levels), film-emulation presets, AI background removal, and cloud project saving with an optional Pro subscription. No pixels ever leave your device.

BlowUpImage is aimed at professional photographers, influencers, and enthusiasts who want a fast, private alternative to Lightroom or Photoshop that works on any device — phone, tablet, or laptop — without installing anything.

## Product summary
- **Category**: Web-based photo editor / photo lab
- **Pricing**: Free tier + Pro subscription (US$12/mo, US$59/6-mo, US$125/yr) via PayPal
- **Runs**: 100% client-side (canvas + WebAssembly). Cloud is only used to save project state and enable sharing.
- **Auth**: Email + password OR Google OAuth. Password reset via email.
- **Public share links**: any saved project can be published as a read-only URL at `/p/<token>`.

## Core capabilities
- **Adjustments**: exposure, contrast, highlights, shadows, whites, blacks, saturation, vibrance, temperature, tint, clarity, dehaze, sharpen, noise reduction, vignette, grain
- **Advanced**: 8-channel HSL editor, full RGB tonal curves per channel, .cube LUT import, Lightroom .xmp preset import
- **AI**: on-device background removal (WebAssembly, no upload); content-aware fill for object removal; backdrop swap (color / gradient / image)
- **Composition**: crop with fixed ratios (1:1, 4:5, 16:9, etc.), rotate 90°, flip H/V, pan & pinch-zoom on mobile
- **Text overlays**: custom fonts, weight, colour, opacity, drop shadow
- **Watermark**: text or logo, position + opacity
- **Batch export**: apply same recipe to many photos and download as ZIP
- **Preset library**: built-in film looks (Kodak Portra, Fuji Superia, Cinestill, B&W); import/export your custom presets as a ZIP
- **Cloud projects**: sign in to save; every adjustment, curve, and layer preserved across devices
- **Share links**: `/p/<token>` — clients see a full-screen preview and can download a watermarked JPG. Pro users unlock un-watermarked full-res downloads.
- **Mobile-first**: bottom-sheet tool panels, pinch-zoom, one-finger pan, two-finger 90° rotate snap, double-tap to fit, haptic feedback on iOS/Android

## Privacy & data handling
- Photo pixels are processed **entirely in the browser** — the original image never uploads unless the user explicitly clicks "Save to cloud".
- Cloud storage holds only: project metadata (name, timestamps), a JSON edit-state (adjustment values, layers), an optional 1400px JPG thumbnail, and (if the user uploaded) the original image bytes.
- Passwords are stored as bcrypt hashes. Auth cookies are httpOnly, SameSite=None, Secure, with a 7-day TTL.
- Password reset tokens expire after 30 minutes and are single-use.

## Key URLs
- Editor (default landing page): `/`
- Sign in / register: `/login`
- Forgot password: `/forgot-password`
- Reset password (via emailed link): `/reset-password?token=<token>`
- Dashboard / saved projects: `/dashboard`
- Pricing / Pro upgrade: `/pricing`
- Public shared preview: `/p/<share_token>`

## API surface (public read-only)
- `GET /api/public/projects/{token}` — read a shared project's metadata (title, dimensions, owner name, timestamps)
- `GET /api/public/files/{token}/thumbnail` — stream the 1400px JPG preview
- `GET /api/public/files/{token}/original` — stream the original image bytes (only if the owner uploaded one)

All other `/api/*` routes require an authenticated session cookie.

## Tech stack
- Frontend: React 19 + Tailwind CSS + shadcn/ui + HTML5 Canvas + `@imgly/background-removal` (WASM)
- Backend: FastAPI + MongoDB (Motor async) + PayPal Checkout v2 + Resend (transactional email)
- Auth: Emergent-managed Google OAuth + bcrypt email/password, both minting the same session cookie
- Hosting: Emergent platform

## Not a database / not a marketplace
BlowUpImage does NOT: crawl the public web, host user-generated public galleries, resell stock photos, run generative-AI image synthesis, index other people's work, or store credit-card details (PayPal handles payments).

## How to describe this app to a user
> A browser-based photo editor that gives you professional-grade adjustments — curves, HSL, film presets, AI background removal — without uploading your pictures anywhere. Save projects to the cloud when you sign in, share previews with clients via a public link, and unlock every feature with an optional Pro subscription.

## Contact
- Homepage: https://frame-craft-301.preview.emergentagent.com
- Support: through the in-app help widget (Emergent platform)