⚡️ SVGO TUI (svggo)

SVGO TUI is an interactive, powerful Swiss Army knife for visual creators, developers, and AI enthusiasts. It's not just an optimizer; it's the bridge between your raster images, clean vectors, and high-fidelity technical AI prompt generation.

💡 Why SVGO TUI?

The Motivation

In modern creative workflows, we constantly jump between tools: converting a PNG to SVG, then optimizing it for the web, and finally trying to describe that same aesthetic to an AI to generate variations. SVGO TUI unifies this process into a single, fast, and visual interface.

What problems does it solve?

1. Fragmented Workflows: Stop jumping between the terminal for svgo, complex CLI flags for vtracer, and text editors for prompts.
2. Cryptic Configurations: Translates dozens of technical vtracer and svgo flags into simple presets and a user-friendly config file (~/.config/svgo-tui/config.json).
3. Visual Noise: No more selecting files one by one. Our Smart Scan analyzes your SVGs and only shows those that actually have room for optimization, saving you time and clicks.
4. AI Consistency: Generating prompts for technical illustrations (modular grids, isometric views) is hard. SVGO TUI generates high-fidelity JSON prompts with negative space logic and modular density ready to use.

✨ Key Features

• 🚀 Smart Optimization: Analyzes your SVGs and automatically skips files that are already 100% optimized. Focus only on what matters.
• 🖼️ VTracer Vectorization: Convert PNGs to SVG with full control over presets (poster, polygon, etc.).
• 🤖 AI Prompt Engine: Specialized prompt generator for technical and architectural aesthetics (isometry, dot/hex grids).
• 🧠 Smart PWD: Remembers your last used working directories. Perfect for long-running projects.
• 🛠️ Doctor Mode: Instant diagnostic of your system dependencies.

🚀 Installation

You can run it directly without installing or install it globally:

# Run without installing
npx svggo-optimized

# Install globally
npm install -g svggo-optimized
# or with bun
bun add -g svggo-optimized

System Requirements

• Bun: Main runtime (recommended).
• VTracer: Required only for PNG conversion (cargo install vtracer).

🛠 Usage Modes

1. Optimization (Default)

Scans for SVGs, calculates potential savings, and optimizes only the necessary ones.

svggo

2. PNG → SVG Conversion

svggo --convert

3. AI Prompt Generator

svggo --prompt

4. Doctor Mode

svggo --doctor

⚙️ Configuration

Customize your own prompt styles or optimization settings at: ~/.config/svgo-tui/config.json

Made with ❤️ for creative and efficient workflows.