# Made Easy Tools

> A fast, free, and privacy-first client-side suite of developer utilities for processing documents, data, and media files entirely within the browser.

## Online Tools

- [Homepage](https://thelp.me/): Simple and powerful tools for everyday developer tasks. Serves as the central navigation hub.
- [PDF Generator](https://thelp.me/pdf-generator): Merge, split, rotate, and rearrange pages from PDF and image files, then export them back to PDF or ZIP format.
- [JSON Formatter](https://thelp.me/json-formatter): Format, validate, prettify, and minify raw JSON data using an interactive client-side tree editor.
- [Image Converter](https://thelp.me/image-converter): Convert, resize, crop, and remove backgrounds from images client-side. Supports PNG, JPEG, WEBP, GIF, BMP, and ICO formats.
- [Base64 Encoder](https://thelp.me/base64-encoder): Encode text or files to Base64 format, or decode Base64 strings back to their original text or binary file representations.
- [QR Generator](https://thelp.me/qr-generator): Create custom QR codes from URLs, text, or contact data, adjusting size, color, and error correction levels locally.

## Tool Details & Specifications

### PDF Generator & Merger
- **Path**: `/pdf-generator`
- **Actions**:
  - **Add Files**: Supports dragging and dropping or selecting multiple PDF or image (`.png`, `.jpeg`, `.jpg`) files.
  - **Rearrange Pages**: Reorder page cards via drag-and-drop.
  - **Rotate Pages**: Rotate individual pages in 90° clockwise increments.
  - **Rename Items**: Edit individual file/page names in the preview UI.
  - **Delete Pages**: Remove specific pages from the final output (allows splitting files).
  - **Generate PDF**: Compiles pages client-side using `pdf-lib` via a background Web Worker.
  - **Export ZIP**: Converts page states to image blobs and packages them in a ZIP file using `jszip`.

### JSON Formatter & Validator
- **Path**: `/json-formatter`
- **Actions**:
  - **Input raw JSON**: Paste or type raw JSON data in the input text area.
  - **Indentation spacing**: Select indentation spacing (2 spaces, 4 spaces, or tabs).
  - **Format**: Click "Format" to pretty-print raw JSON.
  - **Minify**: Click "Minify" to strip whitespaces and compress JSON.
  - **Validate**: Automatic syntax validation with error line highlighting and error messages.
  - **Load Sample**: Populates a dummy JSON schema for testing.
  - **Interactive Tree View**: Explores formatted JSON with expandable/collapsible nodes.
  - **Text Output View**: Renders standard text format for copying.
  - **Copy**: Copy formatted or minified output to the clipboard.
  - **Clear**: Clear input and output panels.

### Image Converter & Editor
- **Path**: `/image-converter`
- **Actions**:
  - **Upload Images**: Drag & drop or select images.
  - **Crop & Rotate**: Crop images (free form, 1:1, 4:3, 16:9, Passport aspects, circular crop) and rotate 90° clockwise.
  - **Remove Background**: Clean background colors locally via browser AI, choose solid background color presets, or select a custom HTML5 color.
  - **Set Dimensions**: Set target width and height in pixels (with lock aspect ratio option) or using document layout presets.
  - **Format Conversion**: Select target format (PNG, JPEG, WEBP, GIF, BMP, ICO).
  - **Download Converted**: Download individual converted images.
  - **Download ZIP**: Batch download all converted images in a single ZIP archive.

### Base64 Encoder & Decoder
- **Path**: `/base64-encoder`
- **Actions**:
  - **Text Mode**: Encode UTF-8 text strings to Base64 and decode Base64 strings back to text. Supports a swap (⇄) utility.
  - **File Mode**:
    - **File ➜ Base64**: Upload files up to 10MB to generate raw Base64 or Data URI strings.
    - **Base64 ➜ File**: Paste standard Data URIs or raw Base64 strings to sniff MIME-types (PNG, JPEG, GIF, WEBP, PDF, ZIP, Plain text), preview the file, and download it locally.
  - **Analytics**: Tracks tab selections, conversions, and copy-to-clipboard interactions.

### QR Generator
- **Path**: `/qr-generator`
- **Actions**:
  - **Input Data**: Generate QR codes from any URL, email, phone number, or plain text string.
  - **Live Preview**: See the generated QR code instantly on a canvas as you type.
  - **Customize Appearance**: Choose foreground and background colors using built-in color pickers.
  - **Adjust Size**: Select from preset output dimensions (128x128, 256x256, 512x512 pixels).
  - **Error Correction**: Modify the QR error correction levels (L, M, Q, H) to increase redundancy.
  - **Download & Copy**: Export the generated QR code as a PNG file or copy it directly to the system clipboard.

## Technical Architecture

- **100% Client-side**: Processing is performed locally using the browser's APIs (e.g. Canvas, FileReader, Web Workers) and libraries (`pdf-lib`, `pdfjs-dist`, `jszip`). Zero data is sent to external servers.
- **Theme Engine**: Light/Dark theme switching using standard CSS variables and local storage.

## External Links

- [Twitter Share](https://twitter.com/intent/tweet?text=Check%20out%20Made%20Easy%20Tools%20-%20Free,%20local,%20and%20private%20web%20utilities%20for%20PDFs,%20JSON,%20and%20images!&url=https://thelp.me): Share the website on X/Twitter.
- [LinkedIn Share](https://www.linkedin.com/sharing/share-offsite/?url=https://thelp.me): Share the website on LinkedIn.
- [Contact Email](mailto:ratatouille.logic@gmail.com): Contact the support team.