one-image-optimizer 1.0.0 → 1.0.2

package/CHEAT_SHEET.md

@@ -0,0 +1,111 @@
+# ⚡ one-image-optimizer - Quick Cheat Sheet
+
+## 📦 Installation (3 Steps)
+
+```bash
+# 1. Install
+npm install one-image-optimizer
+
+# 2. Edit config file (auto-created)
+# Open: one-image-optimizer.config.js
+# Change: ROOT_FOLDER: './your/images/folder'
+
+# 3. Run
+npx one-image-optimizer
+```
+
+---
+
+## 🎯 Commands
+
+```bash
+# Full optimization (compress + rename + webp)
+npx one-image-optimizer
+
+# Compress images only
+npx oio-compress
+
+# Convert to WebP only
+npx oio-webp
+
+# Rename images only
+npx oio-rename
+
+# Empty folders (⚠️ destructive!)
+npx oio-empty
+```
+
+---
+
+## ⚙️ Config File
+
+```javascript
+// one-image-optimizer.config.js
+module.exports = {
+  ROOT_FOLDER: './assets/images',  // 👈 Change this!
+  COMPRESS_THRESHOLD_MB: 1,
+  MAX_WIDTH: 1920,
+  MAX_HEIGHT: 1080,
+  WEBP_QUALITY: 80,
+  JPEG_QUALITY: 75
+};
+```
+
+---
+
+## 🌍 Global Install (Optional)
+
+```bash
+# Install globally
+npm install -g one-image-optimizer
+
+# Use without npx
+one-image-optimizer
+oio-compress
+oio-webp
+```
+
+---
+
+## 💡 Common Paths
+
+```javascript
+ROOT_FOLDER: './assets/images'      // React/Vue
+ROOT_FOLDER: './public/images'      // Next.js
+ROOT_FOLDER: './src/assets'         // Angular
+ROOT_FOLDER: './static/images'      // Gatsby
+ROOT_FOLDER: './content/images'     // Hugo/Jekyll
+```
+
+---
+
+## 🔧 Troubleshooting
+
+```bash
+# Config not found?
+npm install one-image-optimizer
+
+# Commands not working?
+npm install one-image-optimizer@latest
+
+# Update package
+npm update one-image-optimizer
+```
+
+---
+
+## 📊 What It Does
+
+| Command | Action |
+|---------|--------|
+| `one-image-optimizer` | Compress → Rename → WebP |
+| `oio-compress` | Compress images > 1MB |
+| `oio-webp` | Convert to WebP format |
+| `oio-rename` | Rename based on folder |
+| `oio-empty` | Delete all files (⚠️) |
+
+---
+
+**That's all you need to know!** 🚀
+
+For detailed docs, see: `HOW_TO_USE.md` or `README.md`

package/HOW_TO_USE.md

@@ -0,0 +1,377 @@
+# 📖 How to Install and Use one-image-optimizer
+
+## 🚀 Simple Installation & Usage Guide
+
+### Step 1: Install the Package
+
+In your project directory, run:
+
+```bash
+npm install one-image-optimizer
+```
+
+**That's it!** The package will:
+- ✅ Install automatically
+- ✅ Create a config file: `one-image-optimizer.config.js`
+
+---
+
+### Step 2: Configure Your Image Folder
+
+Open the auto-created config file and set your images folder:
+
+```javascript
+// one-image-optimizer.config.js
+module.exports = {
+  ROOT_FOLDER: './assets/images',  // 👈 CHANGE THIS to your images folder
+  COMPRESS_THRESHOLD_MB: 1,
+  MAX_WIDTH: 1920,
+  MAX_HEIGHT: 1080,
+  WEBP_QUALITY: 80,
+  JPEG_QUALITY: 75,
+  IMAGE_EXTENSIONS: ['.jpg', '.jpeg', '.png', '.webp', '.gif', '.bmp', '.tiff']
+};
+```
+
+**Example paths:**
+- `'./assets/images'` - If your images are in `assets/images` folder
+- `'./public/images'` - If your images are in `public/images` folder
+- `'./src/assets'` - If your images are in `src/assets` folder
+
+---
+
+### Step 3: Run the Commands
+
+#### Option A: Full Optimization (Recommended)
+
+Run all optimization steps at once:
+
+```bash
+npx one-image-optimizer
+```
+
+This will:
+1. ✅ Compress all images larger than 1MB
+2. ✅ Rename images based on their folder names
+3. ✅ Convert all images to WebP format
+
+You'll be asked to confirm before it starts.
+
+#### Option B: Individual Commands
+
+Run specific tasks:
+
+```bash
+# Compress images only
+npx oio-compress
+
+# Convert to WebP only
+npx oio-webp
+
+# Rename images only
+npx oio-rename
+
+# Empty folders (⚠️ CAREFUL - this deletes files!)
+npx oio-empty
+```
+
+---
+
+## 📋 Complete Example
+
+Let's say you have a React project with images in `public/images`:
+
+```bash
+# 1. Navigate to your project
+cd my-react-app
+
+# 2. Install the package
+npm install one-image-optimizer
+
+# 3. Edit the config file
+# Open: one-image-optimizer.config.js
+# Change: ROOT_FOLDER: './public/images'
+
+# 4. Run optimization
+npx one-image-optimizer
+
+# 5. Done! Your images are optimized ✅
+```
+
+---
+
+## 🎯 Real-World Usage Examples
+
+### Example 1: E-commerce Website
+
+```bash
+# Your project structure:
+my-shop/
+├── public/
+│   └── products/
+│       ├── shoes/
+│       ├── shirts/
+│       └── accessories/
+
+# Install
+npm install one-image-optimizer
+
+# Configure
+# Set ROOT_FOLDER: './public/products'
+
+# Run
+npx one-image-optimizer
+```
+
+### Example 2: Portfolio Website
+
+```bash
+# Your project structure:
+portfolio/
+├── src/
+│   └── assets/
+│       └── gallery/
+
+# Install
+npm install one-image-optimizer
+
+# Configure
+# Set ROOT_FOLDER: './src/assets/gallery'
+
+# Run
+npx oio-compress  # Just compress, don't convert to WebP
+```
+
+### Example 3: Blog with Multiple Image Folders
+
+```bash
+# Your project structure:
+blog/
+├── content/
+│   ├── posts/
+│   │   └── images/
+│   └── authors/
+│       └── photos/
+
+# Install once
+npm install one-image-optimizer
+
+# Optimize posts images
+# Edit config: ROOT_FOLDER: './content/posts/images'
+npx one-image-optimizer
+
+# Then optimize author photos
+# Edit config: ROOT_FOLDER: './content/authors/photos'
+npx one-image-optimizer
+```
+
+---
+
+## 🔄 Workflow Tips
+
+### Daily Workflow
+
+```bash
+# Add new images to your folder
+# Then run:
+npx oio-compress  # Quick compression
+
+# Or for full optimization:
+npx one-image-optimizer
+```
+
+### Before Deployment
+
+```bash
+# Optimize all images before deploying:
+npx one-image-optimizer
+
+# Then build and deploy:
+npm run build
+npm run deploy
+```
+
+### Batch Processing
+
+```bash
+# Process different folders one by one:
+npx oio-compress   # Compress first
+npx oio-rename     # Then rename
+npx oio-webp       # Finally convert to WebP
+```
+
+---
+
+## 🌍 Global Installation (Optional)
+
+If you use this tool frequently across multiple projects:
+
+```bash
+# Install globally
+npm install -g one-image-optimizer
+
+# Now use shorter commands (no npx needed):
+one-image-optimizer
+oio-compress
+oio-webp
+oio-rename
+```
+
+**Benefits:**
+- ✅ Shorter commands
+- ✅ Available in any directory
+- ✅ No need to type `npx` every time
+
+---
+
+## ⚙️ Configuration Options Explained
+
+```javascript
+module.exports = {
+  // Main folder containing your images
+  ROOT_FOLDER: './assets/images',
+  
+  // Compress images larger than this size (in MB)
+  COMPRESS_THRESHOLD_MB: 1,
+  
+  // Maximum width for compressed images (pixels)
+  MAX_WIDTH: 1920,
+  
+  // Maximum height for compressed images (pixels)
+  MAX_HEIGHT: 1080,
+  
+  // WebP quality (0-100, higher = better quality, larger file)
+  WEBP_QUALITY: 80,
+  
+  // JPEG quality (0-100, higher = better quality, larger file)
+  JPEG_QUALITY: 75,
+  
+  // Supported image formats
+  IMAGE_EXTENSIONS: ['.jpg', '.jpeg', '.png', '.webp', '.gif', '.bmp', '.tiff']
+};
+```
+
+### Customization Examples:
+
+**High Quality (Larger Files):**
+```javascript
+WEBP_QUALITY: 90,
+JPEG_QUALITY: 85,
+```
+
+**Maximum Compression (Smaller Files):**
+```javascript
+WEBP_QUALITY: 60,
+JPEG_QUALITY: 60,
+```
+
+**4K Images:**
+```javascript
+MAX_WIDTH: 3840,
+MAX_HEIGHT: 2160,
+```
+
+**Mobile-Optimized:**
+```javascript
+MAX_WIDTH: 1080,
+MAX_HEIGHT: 1920,
+```
+
+---
+
+## 🛠️ Troubleshooting
+
+### Issue: "Config file not found"
+
+**Solution:**
+```bash
+# Reinstall to recreate config
+npm install one-image-optimizer
+```
+
+### Issue: "Path does not exist"
+
+**Solution:**
+- Check that `ROOT_FOLDER` in config points to a valid directory
+- Use relative paths from your project root
+- Example: `./assets/images` NOT `assets/images`
+
+### Issue: "Commands not working"
+
+**Solution:**
+```bash
+# Update to latest version
+npm install one-image-optimizer@latest
+
+# Or reinstall
+npm uninstall one-image-optimizer
+npm install one-image-optimizer
+```
+
+### Issue: "Permission errors on Windows"
+
+**Solution:**
+- Close any programs viewing the images
+- Run terminal as administrator (if needed)
+- The tool has built-in Windows file lock handling
+
+---
+
+## 📊 What Each Command Does
+
+### `npx one-image-optimizer`
+- Runs ALL optimization steps in sequence
+- Asks for confirmation before starting
+- Best for: First-time optimization, complete cleanup
+
+### `npx oio-compress`
+- Only compresses images larger than threshold
+- Resizes if needed
+- Best for: Regular maintenance, new image batches
+
+### `npx oio-webp`
+- Converts all images to WebP format
+- Deletes original files after conversion
+- Best for: Web performance optimization
+
+### `npx oio-rename`
+- Renames images based on folder names
+- Format: `{foldername}image1.jpg`, `{foldername}image2.jpg`
+- Best for: Organizing images, SEO-friendly names
+
+### `npx oio-empty`
+- ⚠️ **DESTRUCTIVE!** Deletes all files in folders
+- Keeps folder structure
+- Best for: Cleaning up before fresh import
+
+---
+
+## ✅ Quick Reference
+
+| Task | Command |
+|------|---------|
+| Install | `npm install one-image-optimizer` |
+| Full optimization | `npx one-image-optimizer` |
+| Compress only | `npx oio-compress` |
+| WebP only | `npx oio-webp` |
+| Rename only | `npx oio-rename` |
+| Empty folders | `npx oio-empty` |
+| Global install | `npm install -g one-image-optimizer` |
+| Update | `npm install one-image-optimizer@latest` |
+
+---
+
+## 🎉 You're Ready!
+
+**3 Simple Steps:**
+1. `npm install one-image-optimizer`
+2. Edit `one-image-optimizer.config.js` (set your folder)
+3. Run `npx one-image-optimizer`
+
+**That's it!** Your images are optimized! 🚀
+
+---
+
+**Need more help?** Check out:
+- `README.md` - Full documentation
+- `QUICK_START.md` - Quick reference guide

package/PUBLISHING_CHECKLIST.md

@@ -0,0 +1,261 @@
+# 📋 Publishing Checklist - one-image-optimizer v1.0.1
+
+## ✅ Pre-Publishing Checklist
+
+### 1. Verify Package Structure
+- [x] `bin/` directory created with all CLI files
+- [x] All bin files have `#!/usr/bin/env node` shebang
+- [x] `package.json` updated with correct `bin` field
+- [x] Version bumped to `1.0.1`
+- [x] README.md updated with new usage instructions
+
+### 2. Test Locally
+
+```bash
+# Link the package locally
+npm link
+
+# Verify commands are available
+Get-Command one-image-optimizer
+Get-Command oio-compress
+Get-Command oio-webp
+Get-Command oio-rename
+Get-Command oio-empty
+```
+
+**Status:** ✅ All commands are available globally!
+
+### 3. Test in a Separate Project
+
+```bash
+# Create a test directory
+mkdir test-project
+cd test-project
+npm init -y
+
+# Link your package
+npm link one-image-optimizer
+
+# Create a test config
+# (Edit one-image-optimizer.config.js)
+
+# Test commands
+npx one-image-optimizer --help
+npx oio-compress
+npx oio-webp
+```
+
+### 4. Verify Package Contents
+
+```bash
+# See what will be published
+npm pack --dry-run
+
+# Check the tarball
+npm pack
+tar -tzf one-image-optimizer-1.0.1.tgz
+```
+
+### 5. Check .npmignore
+
+Ensure these are included:
+- ✅ `bin/` directory
+- ✅ `src/` directory
+- ✅ `scripts/` directory
+- ✅ `one-image-optimizer.config.js` (template)
+- ✅ `package.json`
+- ✅ `README.md`
+
+Ensure these are excluded:
+- ✅ `node_modules/`
+- ✅ Test directories
+- ✅ `.git/`
+- ✅ Development files
+
+---
+
+## 🚀 Publishing Steps
+
+### Step 1: Login to NPM
+
+```bash
+npm login
+```
+
+Enter your credentials:
+- Username
+- Password
+- Email
+- 2FA code (if enabled)
+
+### Step 2: Publish
+
+```bash
+npm publish
+```
+
+Expected output:
+```
++ one-image-optimizer@1.0.1
+```
+
+### Step 3: Verify on NPM
+
+Visit: https://www.npmjs.com/package/one-image-optimizer
+
+Check:
+- ✅ Version shows `1.0.1`
+- ✅ README displays correctly
+- ✅ Files tab shows `bin/` directory
+- ✅ Package size is reasonable
+
+---
+
+## 🧪 Post-Publishing Verification
+
+### Test Fresh Installation
+
+```bash
+# In a new directory
+mkdir fresh-test
+cd fresh-test
+npm init -y
+
+# Install from npm
+npm install one-image-optimizer
+
+# Verify config file was created
+ls one-image-optimizer.config.js
+
+# Test all commands
+npx one-image-optimizer
+npx oio-compress
+npx oio-webp
+npx oio-rename
+npx oio-empty
+```
+
+### Expected Behavior
+
+1. ✅ Config file auto-created
+2. ✅ All `npx` commands work
+3. ✅ No "missing scripts" errors
+4. ✅ Commands execute properly
+
+---
+
+## 📢 Announce the Fix
+
+### Update Existing Users
+
+If you have users on v1.0.0, notify them:
+
+**GitHub Release Notes:**
+```markdown
+## v1.0.1 - CLI Commands Fixed 🎉
+
+### 🐛 Bug Fix
+- Fixed: Commands now work properly when installed in other projects
+- Users no longer need to manually add scripts to their package.json
+
+### 🔄 Migration
+Update to the latest version:
+```bash
+npm install one-image-optimizer@latest
+```
+
+### 📝 New Usage
+Commands are now available via `npx`:
+```bash
+npx one-image-optimizer
+npx oio-compress
+npx oio-webp
+npx oio-rename
+```
+
+See the updated [README](README.md) for full documentation.
+```
+
+### NPM Package Description
+
+Update the package description on npmjs.com to include:
+```
+✅ Now with working CLI commands! Use npx one-image-optimizer to get started.
+```
+
+---
+
+## 🔍 Troubleshooting
+
+### If publish fails:
+
+**Error: "You do not have permission to publish"**
+```bash
+# Check you're logged in
+npm whoami
+
+# Login again
+npm login
+```
+
+**Error: "Version already exists"**
+```bash
+# Bump version
+npm version patch  # 1.0.1 -> 1.0.2
+npm publish
+```
+
+**Error: "Package name already taken"**
+- The package name is already yours, this shouldn't happen
+- If it does, check you're logged in as the correct user
+
+---
+
+## 📊 Success Metrics
+
+After publishing, monitor:
+- ✅ Download count increases
+- ✅ No new issues about "missing scripts"
+- ✅ Positive feedback from users
+- ✅ Stars/forks on GitHub (if applicable)
+
+---
+
+## 🎯 Next Steps After Publishing
+
+1. ✅ Update GitHub repository (if you have one)
+2. ✅ Add GitHub release for v1.0.1
+3. ✅ Update any documentation sites
+4. ✅ Notify users via social media/email
+5. ✅ Monitor npm downloads and issues
+
+---
+
+## 📝 Command Reference
+
+### Publishing Commands
+```bash
+npm login              # Login to npm
+npm publish            # Publish package
+npm version patch      # Bump patch version
+npm version minor      # Bump minor version
+npm version major      # Bump major version
+```
+
+### Testing Commands
+```bash
+npm link               # Link package locally
+npm pack               # Create tarball
+npm pack --dry-run     # Preview what will be published
+```
+
+### Verification Commands
+```bash
+npm whoami             # Check logged-in user
+npm view one-image-optimizer  # View package info
+npm view one-image-optimizer versions  # View all versions
+```
+
+---
+
+**Ready to publish?** Follow the steps above and your package will be fixed! 🚀

package/QUICK_START.md

@@ -1,167 +1,96 @@
-# 🎯 QUICK START GUIDE
+# 🚀 Quick Start Guide - one-image-optimizer
 
-## ✅ COMPLETED SETUP
+## Installation
 
-All files have been created and dependencies installed successfully!
-
----
-
-## 📋 WHAT TO DO NOW (Step-by-Step)
-
-### **STEP 1: Test Locally First** ⚡
-
-Before publishing, let's test the package:
-
-1. **Create a test folder with images:**
-   ```bash
-   mkdir test-images
-   mkdir "test-images/Product Photos"
-   mkdir "test-images/Hero Images"
-   ```
-
-2. **Copy some test images** (JPG/PNG files) into these folders
-
-3. **Edit the config file** that was just created:
-   - Open: `one-image-optimizer.config.js`
-   - Change `ROOT_FOLDER: './assets/images'` to `ROOT_FOLDER: './test-images'`
-
-4. **Run the optimizer:**
-   ```bash
-   npm run one-image-optimizer
-   ```
+```bash
+npm install one-image-optimizer
+```
 
-5. **Test individual commands:**
-   ```bash
-   npm run compress
-   npm run webp
-   ```
+## Setup
+
+After installation, edit the auto-generated config file:
+
+```javascript
+// one-image-optimizer.config.js
+module.exports = {
+  ROOT_FOLDER: './assets/images',  // 👈 Change this to your images folder
+  COMPRESS_THRESHOLD_MB: 1,
+  MAX_WIDTH: 1920,
+  MAX_HEIGHT: 1080,
+  WEBP_QUALITY: 80,
+  JPEG_QUALITY: 75,
+  IMAGE_EXTENSIONS: ['.jpg', '.jpeg', '.png', '.webp', '.gif', '.bmp', '.tiff']
+};
+```
 
----
+## Usage
 
-### **STEP 2: Publish to npm** 📦
+### Full Optimization (Recommended)
 
-Once testing is successful:
+Run all steps in sequence:
 
-1. **Login to npm:**
-   ```bash
-   npm login
-   ```
-   (Create account at https://npmjs.com if needed)
+```bash
+npx one-image-optimizer
+```
 
-2. **Update package.json:**
-   - Change `"author": "Your Name"` to your actual name
-   - Add your email and repository URL
+This will:
+1. ✅ Compress images > 1MB
+2. ✅ Rename based on folder names
+3. ✅ Convert to WebP format
 
-3. **Publish:**
-   ```bash
-   npm publish
-   ```
+### Individual Commands
 
-4. **If name is taken**, update package.json:
-   ```json
-   {
-     "name": "@yourusername/one-image-optimizer"
-   }
-   ```
+```bash
+# Compress only
+npx oio-compress
 
----
+# Convert to WebP only
+npx oio-webp
 
-## 🎮 COMMANDS AVAILABLE
+# Rename only
+npx oio-rename
 
-| Command | Description |
-|---------|-------------|
-| `npm run one-image-optimizer` | Run full optimization (compress → rename → webp) |
-| `npm run compress` | Compress images > 1MB only |
-| `npm run webp` | Convert to WebP only |
-| `npm run empty-folders` | Delete all files (⚠️ destructive) |
+# Empty folders (⚠️ destructive!)
+npx oio-empty
+```
 
----
+## Global Installation (Optional)
 
-## 📁 FILES CREATED
-
-✅ `package.json` - Package configuration with all dependencies
-✅ `src/cli.js` - CLI entry point
-✅ `src/index.js` - Main orchestrator with confirmation prompts
-✅ `src/utils.js` - Config loader and utilities
-✅ `src/imagescompress.js` - Compression logic (refactored)
-✅ `src/imgfolderrename.js` - Rename logic (refactored)
-✅ `src/webpconverter.js` - WebP conversion (refactored)
-✅ `src/emptythefolder.js` - Empty folders logic (refactored)
-✅ `src/scripts/compress-only.js` - Individual compress command
-✅ `src/scripts/webp-only.js` - Individual webp command
-✅ `src/scripts/empty-folders-only.js` - Individual empty command
-✅ `scripts/postinstall.js` - Auto-creates config file
-✅ `one-image-optimizer.config.js` - Config template
-✅ `README.md` - User documentation
-✅ `.npmignore` - Exclude test files from package
-✅ `IMPLEMENTATION_GUIDE.md` - Full implementation guide
+For shorter commands:
 
----
+```bash
+npm install -g one-image-optimizer
 
-## 🔧 HOW IT WORKS
+# Then use without npx:
+one-image-optimizer
+oio-compress
+oio-webp
+oio-rename
+```
 
-### When users install your package:
+## Common Issues
 
+### Config file not found
 ```bash
+# Reinstall to recreate config
 npm install one-image-optimizer
 ```
 
-1. ✅ Package is installed to `node_modules/`
-2. ✅ Postinstall script runs automatically
-3. ✅ Config file `one-image-optimizer.config.js` is created in their project root
-4. ✅ User edits config to set their image folder path
-5. ✅ User runs: `npm run one-image-optimizer`
-6. ✅ Confirmation prompt appears
-7. ✅ All optimizations run in sequence:
-   - Compress images > 1MB
-   - Rename based on folder names
-   - Convert to WebP format
-
----
-
-## ⚙️ KEY FEATURES IMPLEMENTED
-
-✅ **Auto-config creation** - Config file created on install
-✅ **Confirmation prompts** - User must confirm before changes
-✅ **Sequential execution** - Scripts run one after another
-✅ **Individual commands** - Can run each script separately
-✅ **Config-based paths** - No hardcoded paths
-✅ **Windows support** - File lock handling included
-✅ **Colored output** - Beautiful console messages
-✅ **Error handling** - Graceful error messages
-✅ **Progress tracking** - Shows step-by-step progress
-
----
-
-## 🚨 IMPORTANT NOTES
-
-1. **Test thoroughly** before publishing
-2. **Use test images** you don't mind modifying
-3. **Backup important images** before running
-4. **The empty-folders command is destructive** - use with caution
-5. **Package name must be unique** on npm
-
----
-
-## 📞 NEXT IMMEDIATE STEPS
-
-1. ✅ Dependencies installed ← **DONE**
-2. ⏳ Create test folder with images ← **DO THIS NOW**
-3. ⏳ Edit config file
-4. ⏳ Run `npm run one-image-optimizer`
-5. ⏳ Verify it works
-6. ⏳ Publish to npm
-
----
+### Commands not working
+```bash
+# Update to latest version
+npm install one-image-optimizer@latest
 
-## 📚 DOCUMENTATION
+# Clear cache and reinstall
+npm cache clean --force
+rm -rf node_modules
+npm install
+```
 
-- **Full Guide:** `IMPLEMENTATION_GUIDE.md`
-- **User Docs:** `README.md`
-- **Config Template:** `one-image-optimizer.config.js`
+### Path does not exist
+- Check `ROOT_FOLDER` in config points to a valid directory
+- Use relative paths from project root (e.g., `./assets/images`)
 
 ---
 
-**You're ready to test! 🚀**
-
-Start by creating a test folder with some images and running the optimizer.
+**Need help?** Check the full [README.md](README.md) for detailed documentation.

package/README.md

@@ -45,7 +45,13 @@ module.exports = {
 Run all optimization steps in sequence:
 
 ```bash
-npm run one-image-optimizer
+npx one-image-optimizer
+```
+
+Or if installed globally:
+
+```bash
+one-image-optimizer
 ```
 
 This will:
@@ -61,13 +67,28 @@ Run specific optimization steps:
 
 ```bash
 # Compress images only
-npm run compress
+npx oio-compress
 
 # Convert to WebP only
-npm run webp
+npx oio-webp
+
+# Rename images only
+npx oio-rename
 
 # Empty all files in folders (⚠️ destructive!)
-npm run empty-folders
+npx oio-empty
+```
+
+**Tip:** You can also install globally to use shorter commands:
+
+```bash
+npm install -g one-image-optimizer
+
+# Then use without npx:
+one-image-optimizer
+oio-compress
+oio-webp
+oio-rename
 ```
 
 ## 📋 How It Works
@@ -121,11 +142,12 @@ npm install one-image-optimizer
 # Set ROOT_FOLDER to your images directory
 
 # 3. Run full optimization
-npm run one-image-optimizer
+npx one-image-optimizer
 
 # 4. Or run individual commands
-npm run compress
-npm run webp
+npx oio-compress
+npx oio-webp
+npx oio-rename
 ```
 
 ## 🐛 Troubleshooting

package/bin/compress.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+const compressImageMain = require("../src/imagescompress");
+const { loadConfig } = require("../src/utils");
+const chalk = require("chalk");
+
+async function run() {
+  try {
+    console.log(
+      chalk.cyan.bold(
+        "\n╔════════════════════════════════════════════════════════╗",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "║           ONE IMAGE OPTIMIZER - Compress Only         ║",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "╚════════════════════════════════════════════════════════╝\n",
+      ),
+    );
+
+    const config = loadConfig();
+    await compressImageMain(config);
+
+    console.log(chalk.green.bold("✅ Compression complete!\n"));
+  } catch (error) {
+    console.error(chalk.red("❌ Error:"), error.message);
+    process.exit(1);
+  }
+}
+
+run();

package/bin/empty-folders.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+const emptyFoldersMain = require("../src/emptythefolder");
+const { loadConfig } = require("../src/utils");
+const chalk = require("chalk");
+
+async function run() {
+  try {
+    console.log(
+      chalk.cyan.bold(
+        "\n╔════════════════════════════════════════════════════════╗",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "║         ONE IMAGE OPTIMIZER - Empty Folders Only      ║",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "╚════════════════════════════════════════════════════════╝\n",
+      ),
+    );
+
+    const config = loadConfig();
+    await emptyFoldersMain(config);
+
+    console.log(chalk.green.bold("✅ Folders emptied!\n"));
+  } catch (error) {
+    console.error(chalk.red("❌ Error:"), error.message);
+    process.exit(1);
+  }
+}
+
+run();

package/bin/one-image-optimizer.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+
+const runAllOptimizations = require("../src/index");
+
+// Run the main optimization function
+runAllOptimizations().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/bin/rename.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+const renameImagesMain = require("../src/imgfolderrename");
+const { loadConfig } = require("../src/utils");
+const chalk = require("chalk");
+
+async function run() {
+  try {
+    console.log(
+      chalk.cyan.bold(
+        "\n╔════════════════════════════════════════════════════════╗",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "║           ONE IMAGE OPTIMIZER - Rename Only           ║",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "╚════════════════════════════════════════════════════════╝\n",
+      ),
+    );
+
+    const config = loadConfig();
+    await renameImagesMain(config);
+
+    console.log(chalk.green.bold("✅ Renaming complete!\n"));
+  } catch (error) {
+    console.error(chalk.red("❌ Error:"), error.message);
+    process.exit(1);
+  }
+}
+
+run();

package/bin/webp.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+
+const convertImageToWebpMain = require("../src/webpconverter");
+const { loadConfig } = require("../src/utils");
+const chalk = require("chalk");
+
+async function run() {
+  try {
+    console.log(
+      chalk.cyan.bold(
+        "\n╔════════════════════════════════════════════════════════╗",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "║            ONE IMAGE OPTIMIZER - WebP Only            ║",
+      ),
+    );
+    console.log(
+      chalk.cyan.bold(
+        "╚════════════════════════════════════════════════════════╝\n",
+      ),
+    );
+
+    const config = loadConfig();
+    await convertImageToWebpMain(config);
+
+    console.log(chalk.green.bold("✅ WebP conversion complete!\n"));
+  } catch (error) {
+    console.error(chalk.red("❌ Error:"), error.message);
+    process.exit(1);
+  }
+}
+
+run();

package/package.json

@@ -1,21 +1,20 @@
 {
   "name": "one-image-optimizer",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "main": "src/index.js",
   "description": "Optimize PNG, JPEG images by compressing them and converting them to webp format.",
   "keywords": ["npm", "image", "optimizer", "webp", "compress", "tool"],
   "author": "Your Name",
   "license": "MIT",
   "bin": {
-    "one-image-optimizer": "src/cli.js"
+    "one-image-optimizer": "bin/one-image-optimizer.js",
+    "oio-compress": "bin/compress.js",
+    "oio-webp": "bin/webp.js",
+    "oio-rename": "bin/rename.js",
+    "oio-empty": "bin/empty-folders.js"
   },
   "scripts": {
-    "postinstall": "node scripts/postinstall.js",
-    "one-image-optimizer": "node src/cli.js",
-    "compress": "node src/scripts/compress-only.js",
-    "webp": "node src/scripts/webp-only.js",
-    "empty-folders": "node src/scripts/empty-folders-only.js",
-    "rename": "node src/scripts/rename-only.js"
+    "postinstall": "node scripts/postinstall.js"
   },
   "dependencies": {
     "sharp": "^0.33.0",