Project documentation

BatchForge Guide

Use, behavior, limits, source, testing, and licence.

1. Use

Drop images or folders into the converter, or use the two browse controls.
Choose WebP quality and, if needed, a maximum width.
Select Convert.
Download one converted WebP directly or several successful files as a ZIP.

Conversion runs sequentially so large batches are less likely to freeze the browser. A failed file does not prevent downloading successful results.

2. Formats

Input	Behavior
PNG, JPEG, BMP, SVG, AVIF	Converted to a still WebP.
GIF and WebP	Animated files become one still frame.
TIFF	The first page is used.
HEIC and HEIF	The first decoded image is used.
ICO	One decoded resolution is used.

Output is always WebP. Re-encoding does not guarantee a smaller file; high quality can make an already efficient source larger.

3. Privacy

Image conversion happens inside the browser. BatchForge has no image-upload endpoint and does not send source image bytes to a conversion service. A first-party cookie shares only the selected theme across the `myforgeworks.net` family; local storage supplies immediate display and fallback behavior. The theme value is not an account or visitor identifier.

4. Limits

There is no set file-count cap, but practical capacity depends on image dimensions, browser memory, and available device memory.
RAW camera files, PSD, and PDF are not supported.
Animated and multipage inputs are flattened as described above.
Browser support for WebP encoding and individual source formats still applies.

5. Source and build

Download the complete source package. It includes the application, this Guide, the test suite, build instructions, maintenance rules, changelog, and licence.

npm ci
npm test
npm run dev

Node.js 22.13 or newer is required. The repository is the reconstruction record; future changes should extend its existing architecture rather than replace it with a new template.

6. Test standing

The release checks cover the production build, page routes, conversion workflow contracts, download behavior, theme structure, privacy wording, logo assets, and shared Forgeworks interface contract.

Browser conversion was previously verified for PNG, JPEG, WebP, AVIF, GIF, BMP, SVG, ICO, and TIFF. HEIC and HEIF use a dedicated local decoder but did not receive identical automated fixture coverage in that release environment.

7. Licence

BatchForge software is released under the MIT License. It may be used, copied, modified, and distributed, including commercially, while retaining the copyright and licence notice.

The licence covers the software. Project names and logos do not automatically grant endorsement or identity rights.