# Form Image Crop

Profile photo cropper with zoom, rotate and a round avatar mode.

- id: `form-image-crop`
- Page: https://agentic-ui-kit.com/components/form-image-crop
- Live preview: https://agentic-ui-kit.com/live/component/form-image-crop?piece=form-image-crop

## Install

```bash
agentic-ui add form-image-crop
npx shadcn@4.17.0 add @agentic-ui/form-image-crop
```

## Metadata

- **Level:** block
- **Category:** block
- **Installable in:** Radix UI (registry variant new-york), Base UI (registry variant base-vega)
- **Capabilities:** crop-frame, zoom, rotate, aspect-presets, round-avatar-mode, pan-drag, keyboard-pan, png-export, file-picker, form-field, dark-mode
- **Intents:** create-edit, import-export
- **Suits domains:** saas, social, ecommerce, settings, hr, media
- **Interaction:** pointer-drag, slider, keyboard-navigation, file-upload
- **Screen role:** flow
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** profile photo cropper with zoom, rotate and a round avatar mode, image crop tool with aspect ratio presets such as 1:1, 4:3 and 16:9, avatar upload where the user positions and crops the picture before saving, crop an image in the browser and export a PNG
- **Avoid when:** free-form crop boxes with draggable handles are needed (this crop moves the image under a fixed frame), full image editing with filters or annotations (use agency-image-annotation), the source image is on another origin without CORS headers, since the canvas cannot export it
- **Preserve when adapting:** transform-model, keyboard-controls, export-size-announcement
- **Replace when adapting:** aspect-presets, output-width, sample-image
- **Adaptation effort:** low
- **Coupling:** low
- **Quality breakdown:** visual 9/10, responsive 9/10, accessibility 9/10, code 9/10
- **npm dependencies:** lucide-react
- **npm dependencies (registry):** lucide-react@0.577.0
- **Registry dependencies:** lib-primitives