Fast, intuitive web-based photo editor with real-time filters, transformations, and professional-grade editing capabilities.
Photo Editor is a modern web application designed for quick, intuitive photo editing directly in your browser. Built with React and TypeScript, it provides a smooth user experience with instant feedback on edits. Whether you're adjusting basic properties, applying artistic filters, or performing advanced transformations, Photo Editor makes professional-grade editing accessible to everyone.
Key Purpose: Enable users to edit photos quickly without downloading heavy software or managing files locally.
- Crop & Resize — Precise cropping with aspect ratio presets
- Rotate & Flip — Rotate in 90° increments or flip horizontally/vertically
- Brightness & Contrast — Fine-tune image exposure and tonal range
- Saturation & Vibrance — Control color intensity and vividness
- Hue & Temperature — Adjust color tone and warmth
- Blur & Sharpen — Selective focus and clarity enhancement
- Pixelate & Mosaic — Create pixelated effects or privacy masking
- Opacity Control — Adjust overall transparency
- Grayscale/Sepia — Classic monochrome effects
- Color Filters — Preset filters (vintage, cool, warm, etc.)
- Invert Colors — Negative/inverse effect
- Posterize — Reduce color palette for artistic effect
- Oil Painting Effect — Artistic brush stroke simulation
- Emboss Effect — Raised/3D appearance
- Real-time Preview — Instant visual feedback as you edit
- Undo/Redo — Full edit history navigation
- Download Options — Export as PNG, JPG, or WebP
- Batch Export — Process multiple images (planned)
- Layer Support — Multiple layer editing (planned)
- History Panel — Visual timeline of all edits
- Intuitive Interface — No steep learning curve
- Keyboard Shortcuts — Power user efficiency
- Touch Support — Mobile-friendly controls
- Responsive Design — Works on desktop, tablet, mobile
- Zero File Upload — Process files locally in browser
| Layer | Technology |
|---|---|
| Frontend | React 18+, TypeScript, Vite |
| Styling | Tailwind CSS, shadcn/ui components |
| Image Processing | Canvas API, WebGL (optional) |
| State Management | React Hooks / Context API |
| Build Tool | Vite with Bun package manager |
| Code Quality | ESLint, Prettier |
| Builder | Built with Lovable AI |
- Node.js 18+ or Bun
- Modern web browser (Chrome, Firefox, Safari, Edge)
-
Clone the repository:
git clone https://github.com/erinelopez22/Photo_Editor.git cd Photo_Editor -
Install dependencies:
# Using Bun (recommended) bun install # Or using npm npm install
-
Start development server:
# Using Bun bun run dev # Or using npm npm run dev
-
Open in browser:
http://localhost:5173
# Using Bun
bun run build
# Or using npm
npm run buildOutput files go to dist/ directory, ready for deployment.
-
Upload Photo
- Click "Select Photo" or drag & drop an image
- Supported formats: JPG, PNG, WebP, GIF
-
Apply Edits
- Use the editing panel on the left
- Adjust sliders and select filters
- See changes in real-time
-
Fine-tune
- Use undo/redo to experiment
- Combine multiple effects
- Save intermediate states (planned)
-
Export
- Click "Download" to save edited photo
- Choose format (PNG, JPG, WebP)
- Select quality level if applicable
| Shortcut | Action |
|---|---|
Ctrl/Cmd + Z |
Undo last edit |
Ctrl/Cmd + Shift + Z |
Redo |
Ctrl/Cmd + S |
Save/Download |
Ctrl/Cmd + O |
Open image |
Ctrl/Cmd + R |
Reset to original |
Delete |
Clear current edit |
App
├── ImageUploader → File input & drag-drop
├── EditorPanel
│ ├── ControlsSection → Brightness, Contrast, etc.
│ ├── FiltersSection → Preset filters
│ └── EffectsSection → Artistic effects
├── Canvas → Image rendering & processing
├── Preview → Real-time preview
└── ExportSection → Download options
Original Image
↓
[Crop/Resize]
↓
[Color Adjustments]
↓
[Filters/Effects]
↓
[Opacity]
↓
Preview Canvas
↓
[Download/Export]
# Run unit tests
bun run test
# or
npm test
# Run end-to-end tests
bun run test:e2e
# or
npm run test:e2eTest Coverage:
- Image upload validation
- Filter application accuracy
- Canvas rendering
- Export functionality
- Mobile responsiveness
Performance Targets:
- Load time: < 2 seconds
- Filter application: < 100ms
- Export: < 500ms (depending on image size)
- Memory: Efficient canvas management
Optimizations:
- Lazy loading of filter libraries
- Canvas optimization for large images
- WebGL acceleration (when available)
- Memory cleanup after export
- Progressive image compression
- No Upload to Server — All processing happens locally in browser
- No Data Collection — No analytics or tracking
- No Personal Data — Photos never leave your computer
- Instant Deletion — Cache cleared when browser closes
- HTTPS Enforced — Secure connection in production
- Limited to ~50MB image size (browser memory)
- No multi-layer support yet
- Limited batch processing
- No external API integrations
- Multi-layer editing
- Batch image processing
- AI-powered auto-enhance
- Face detection & retouching
- Advanced color grading
- Adjustment presets library
- Cloud sync (optional)
- Mobile apps (iOS/Android)
- Plugin system for custom filters
- Collaboration features
Built with shadcn/ui and Tailwind CSS:
- Custom slider controls for adjustments
- Toggle buttons for on/off effects
- Dropdown menus for filter selection
- File input with drag-and-drop
- Toast notifications for feedback
- Modal dialogs for export options
- Desktop (1024px+) — Full controls panel, large preview
- Tablet (768px-1023px) — Stacked layout, touch-friendly
- Mobile (< 768px) — Simplified controls, full-screen preview
All layouts maintain full functionality across screen sizes.
- Canvas API — Native browser image processing
- File API — Local file handling
- OpenAI Vision API → AI-powered image analysis
- Unsplash API → Free stock photo library
- Cloudinary → Cloud storage & CDN (optional)
- AWS S3 → Backup & storage (planned)
- User Guide — How to use the app
- FAQ — Common questions
- Tips & Tricks — Pro editing tips
- API Reference — Component and function reference
- Architecture — System design
- Contributing — How to contribute
Found a bug or have a feature idea?
- Report Issues — Use GitHub Issues tab
- Submit Features — Describe your idea in detail
- Pull Requests — Follow code style, write tests
MIT License – See LICENSE file for details.
- Issues & Bugs: GitHub Issues
- Feature Requests: Discussions
- Email: erinelopez22@gmail.com
Erine Lopez — Senior .NET Developer | AI-First Engineer | Full-Stack Developer
Built with Lovable AI for rapid development of polished, modern web applications.
- Approach: React + TypeScript for type safety and scalability
- Design: Tailwind CSS + shadcn/ui for consistent, modern UI
- Performance: Optimized Canvas rendering and efficient state management
- Result: Fast, intuitive photo editor accessible directly in the browser
- Built with React
- Styled with Tailwind CSS
- Components from shadcn/ui
- Created with Lovable AI
- Icons from Lucide React
Fast. Simple. Powerful. No downloads required. 📸