Image Picker

​

Examples

NeoImagePicker(
  currentImage: imageBytes,
  onChanged: (bytes) {
    imageBytes = bytes;
  },
),

NeoImagePicker(
  currentImage: imageBytes,
  onChanged: (bytes) {
    imageBytes = bytes;
  },
  label: "Profile Picture",
  description: "Drag and drop or click to upload. Max 5MB.",
  maxFileSize: 5 * 1024 * 1024,
),

NeoImagePicker(
  currentImage: imageBytes,
  onChanged: (bytes) {
    imageBytes = bytes;
  },
  label: "Cover Image",
  onError: (error) => switch (error) {
    .fileTooLarge => "Image must be under 10MB",
    .unsupportedFormat => "Please use PNG or JPEG",
    _ => null, // Falls back to default message
  },
),

​

Properties

​

Required

​

Content

​

Layout

​

State

​

Enums

​

NeoImagePickerError

• fileTooLarge: The selected file exceeds maxFileSize.
• unsupportedFormat: The dropped file is not a supported image format.
• pickFailed: The file picker failed to open or return a result.
• readFailed: The file could not be read from disk.
• dropFailed: The drag-and-drop operation failed.
• renderFailed: The image bytes could not be rendered (invalid format).
• unknown: An unexpected error occurred.

​

Best Practices

• Set a reasonable maxFileSize: The default 100MB limit is generous. For profile pictures or thumbnails, set a lower limit (e.g., 5 * 1024 * 1024 for 5MB) or compress on the server side.
• Provide custom error messages with onError: Tailor error messages to your use case or language for a better user experience.
• Constrain the height: When used inside unbounded layouts, the picker defaults to 240px height. Wrap in a SizedBox or use within bounded constraints for custom sizing.

​

Integration Notes

• Supported formats: PNG, JPEG, GIF, WebP, HEIC, HEIF, BMP, and TIFF.
• Loading state: The picker automatically shows a loading overlay while processing files or drag-and-drop operations.
• Image display: Selected images are displayed with BoxFit.contain. On hover, a swap icon overlay appears to indicate the image can be replaced.