JSON Updater

A CLI tool that scans portfolio project images, converts them to WebP, and automatically updates projects.json and the JS fallback array.

---

Features

• Scans assets/images/ for new, unreferenced images
• Converts images to WebP format (keeps originals untouched)
• Interactive prompts for project metadata (title, category, tags, description, URLs)
• Updates data/projects.json and js/projects.js fallback simultaneously
• Skips SVG files and already-converted WebP images

Installation

pipx install .

Or editable install for development:

pipx install -e .

Or classic pip:

pip install .

Usage

After installation, run globally:

json-updater

By default, it looks for the portfolio at ~/Portfolio-v2.

Override with:

json-updater /path/to/portfolio

Or set environment variable:

export PORTFOLIO_PATH=/path/to/portfolio
json-updater

How It Works

1. Loads existing projects.json
2. Scans assets/images/ for unreferenced images
3. Converts new images to WebP (quality 100)
4. Prompts for metadata:
   • title
   • category
   • tags
   • description
   • URLs
5. Appends new entries to projects.json
6. Regenerates fallbackProjects in projects.js

Supported Formats

PNG · JPG · JPEG · WebP · GIF · SVG

License

MIT License — see LICENSE

© 2026 KatsukiiNeko. All rights reserved.