Help & App Guide

Learn how to use BasicCrop and master all of our client-side image editor features.

How to Use BasicCrop

Load Your Source Images

Start in the **Quick Crop Sandbox** for a one-off image or click **New Project** to crop multiple files. You can drag and drop files, paste them from the clipboard (`Ctrl+V`), or tap the workspace to select files.

Select Formats & Position

Add preset aspect ratios for Instagram, LinkedIn, YouTube, or input custom sizes. Drag the canvas to center subjects, zoom/rotate, or click the **Focal Point** button to lock the subject coordinate automatically.

Adjust Filters & Export

Optionally tune brightness, contrast, grayscale, and background blur, and select the quality/format. When ready, click **Download ZIP** to batch save all perfectly formatted crops locally.

Pro Tip: Since all operations occur inside your browser using the local GPU and database, BasicCrop works completely offline. There are zero account registers or remote image uploads.

App Features Reference

Clipboard Paste

Need a quick screenshot cropped? Simply copy it and press `Cmd+V` or `Ctrl+V` anywhere on the homepage to start editing in the sandbox immediately.

Focal Point Subjects

Define a focal subject target coordinate. When shifting sizes or applying presets, the viewport automatically slides to center the crop box around this subject.

Adjustments Panel

Adjust brightness, contrast, grayscale, and blur. Use the transparency toggle or choose custom color backgrounds. Toggle **Apply to All Crops** to sync settings project-wide.

Target File Sizing

Need to fit page speed metrics? Specify a target size limit in kilobytes (KB). On export, the quality factor dynamically optimizes itself to fit below that threshold.

Dynamic Filename Templates

Build custom filename structures using variables like `{project}`, `{original}`, `{preset}`, `{width}`, `{height}`, and `{date}` to automate batch exporting organization.

PWA & Offline Capability

BasicCrop can be installed as an app on iOS, Android, and desktop. Once added, it loads instantly and processes image data completely offline without an internet connection.

Privacy & Under the Hood

Absolute Data Privacy

Unlike cloud services that capture and compile your graphic assets on remote web servers, BasicCrop runs **100% inside your sandbox**. Because raw files never leave your memory context, it is fully compliant with enterprise confidentiality standards.

Open Tech Architecture

Dexie & IndexedDB

Saves your projects, dimensions settings, and raw source image blobs persistently on your device.

Vite & React 19

Built using the React Router 7 framework on Vite for lightweight runtime bundles and smooth navigation.

JSZip & Canvas API

Processes hardware-accelerated crops and packages compressed images into a single zip download.