@eltkof7/webimg-cli

CLI TypeScript open source (npm @eltkof7/webimg-cli, v2.0.5) pour optimiser, convertir et générer des images web prêtes pour la production via Sharp : WebP/AVIF, resize responsive, cache invalidable, mode watch, dry-run, backup avant suppression, rapports et API programmatique. Pensé pour le local et la CI, licence MIT.

Client
Open source · eltkof7
Rôle
Auteur CLI
Durée
Lib
STACK
TypeScriptNode.jsSharpnpm
@eltkof7/webimg-cli, visuel principal

Étude de cas

npm public · v2.0.5

REPÈRES & RÉSULTATS

  • npmv2.0.5
  • Formatswebp/avif
  • LicenceMIT

Point de départ & défi

Le contexte

Les assets web restent trop lourds et l'optimisation manuelle est répétitive, risquée (écrasement de fichiers) et peu reproductible en CI. Il fallait un outil simple, scriptable et sûr.

Stratégie & architecture

L'approche

Spécification CLI + config JSON, pipeline Sharp (formats, tailles, qualité), cache pour éviter le retraitement, dry-run et backup pour la sécurité, rapports lisibles et export d'API pour usage programmatique. Tests, lint, typecheck et publish npm scoped.

Impact & livraison

Le résultat

Package public installable (`npm i -D @eltkof7/webimg-cli`), documenté, utilisable en local comme en pipeline CI multi-Node, standardisation de l'optimisation d'images sur les projets thekof.

Passerelle de travail

Du problème initial jusqu'à la solution livrée : faites défiler pour suivre la chaîne.

  1. Étape 01Problème

    Le point de douleur

    L'optimisation d'images à la main est lente, facilement destructive et difficile à standardiser d'un projet à l'autre ou en CI.

  2. Étape 02Cadrage

    Ateliers & périmètre

    Spécification des commandes, options (formats, qualité, responsive), config JSON, garanties de sécurité (dry-run, backup) et critères de rapport de sortie.

  3. Étape 03Conception

    Architecture & maquettes

    Architecture modulaire autour de Sharp : conversion, resize, cache, watch ; design de l'API programmatique miroir du CLI.

  4. Étape 04Développement

    Itérations courtes

    Implémentation TypeScript, tests unitaires, lint/typecheck, validation sur dossiers d'assets réels, puis versioning semver.

  5. Étape 05Mise en production

    Bascule maîtrisée

    Publication npm scoped, README d'usage, et branchement CI multi-versions Node.

  6. Étape 06Solution

    Mesure & évolution

    Suivi des issues, docs enrichies et releases mineures (perf cache, formats) selon les retours d'usage.

APERÇUS D'INTERFACE

Captures du produit en situation

@eltkof7/webimg-cli, illustration 1
Projets suivants