# Figuree Image Tool

**Version:** 1.0.1  
**Platform:** Windows x64  
**Publisher:** Figuree Studio  
**Build type:** Electron desktop app / NSIS installer

Figuree Image Tool is an internal desktop utility for batch resizing, converting, and finishing image assets for Figuree Studio workflows.

## What It Does

- Import multiple JPG, PNG, and WebP images.
- Preview image queue with thumbnails, dimensions, size, and processing status.
- Export using ready-made presets:
  - Font Preview: 1820 x 1214
  - Blog Featured: 1536 x 1024
  - Social Square: 1080 x 1080
  - Hero Banner: 1920 x 1080
  - Custom Size
- Choose resize mode:
  - Cover / crop center
  - Contain / fit with background color
  - Fit with blurred background
- Export as JPG, PNG, or WebP.
- Adjust quality, brightness, contrast, saturation, sharpen, and optional film grain.
- Auto-name output files with a clean pattern:

```text
projectname-preset-slug-01.webp
```

## Install

1. Run the installer:

```text
Figuree Image Tool Setup 1.0.1.exe
```

2. Choose the installation folder.
3. Keep desktop shortcut enabled if desired.
4. Launch **Figuree Image Tool** from the Start Menu or desktop shortcut.

Windows may show a SmartScreen warning because this build is not code-signed yet. Choose **More info** then **Run anyway** if you trust the file source.

## Basic Usage

1. Open the app.
2. Drag images into the drop area, or click **Browse Files**.
3. Set **Project Name**. This becomes part of the output filename.
4. Pick an output size preset or choose **Custom Size**.
5. Choose resize mode and output format.
6. Select an output folder.
7. Click **Process Images**.
8. Click **Open folder** after export to view the results.

Original files are never modified.

## Recommended Export Settings

For Figuree font previews:

- Output Size: Font Preview
- Resize Mode: Cover / Crop Center
- Format: WebP
- Quality: 85%
- Film Grain: Off or subtle

For blog thumbnails:

- Output Size: Blog Featured
- Resize Mode: Cover / Crop Center
- Format: JPG or WebP
- Quality: 80-90%

For transparent assets:

- Format: PNG
- Resize Mode: Contain / Fit + BG only if a background is wanted

## Output Naming

Pattern:

```text
{projectName}-{preset-slug}-{index}.{extension}
```

Examples:

```text
figuree-font-preview-01.webp
nordigh-blog-featured-03.jpg
brand-custom-01.png
```

If a filename already exists, the app automatically adds a counter suffix.

## Version Notes

### 1.0.0

- Initial Windows installer release.
- Refreshed dark UI with softer Figuree rose accent.
- Added proper Windows app icon and installer icon.
- Added batch image processing with Sharp.
- Added validation for output folder, image paths, export format, and custom dimensions.

### 1.0.1

- Added saved custom size presets.
- Custom presets persist after closing and reopening the app.
- Saved custom presets can be selected or deleted from the Output Size panel.

## Developer Commands

Install dependencies:

```powershell
npm install
```

Run development app:

```powershell
npm run dev
```

Build installer:

```powershell
npm run dist
```

Build unpacked app folder:

```powershell
npm run dist:dir
```

Regenerate app icon:

```powershell
npm run icon
```

Build outputs are written to:

```text
dist-app/
```

## Troubleshooting

If Electron fails with:

```text
Electron failed to install correctly
```

Delete `node_modules/electron`, reinstall dependencies, and make sure npm is not running in offline mode.

If exported images fail in packaged builds, rebuild Sharp for the Electron runtime:

```powershell
npm rebuild sharp --runtime=electron --target=28.3.3 --dist-url=https://electronjs.org/headers
```

## Technical Stack

- Electron
- React
- Vite
- Sharp
- electron-builder

## License

Internal tool for Figuree Studio.
