Stubshot (CLI)

This package provides the stubshot CLI.

Usage

From a project:

npx stubshot generate --out public/placeholders --count 12 --sizes 1200x800,800x800 --theme mesh-gradient --format svg --prefix product --seed my-project --manifest --base-url /placeholders

Formats: svg, png, jpg, webp (via the default local provider).

BYOK providers

You can install optional providers, like OpenAI:

npm i -D @stubshot/provider-openai

Then run:

stubshot generate --provider openai --format png --out public/placeholders --count 4 --sizes 1024x1024 --theme mesh-gradient --seed my-project

Provider discovery

List known providers and whether they’re installed:

stubshot providers

Shell completion

Bash:

stubshot completion bash > /tmp/stubshot.bash
source /tmp/stubshot.bash

Zsh:

stubshot completion zsh > /tmp/_stubshot
fpath=(/tmp $fpath)
autoload -Uz compinit && compinit

Caching

To avoid regenerating identical images (especially with BYOK providers), enable a disk cache:

stubshot generate --provider openai --format png --cache-dir .stubshot-cache --out public/placeholders --count 4 --sizes 1024x1024 --theme mesh-gradient --seed my-project

Disable cache:

stubshot generate --no-cache ...

Config files supported:

• stubshot.config.json
• stubshot.config.js

Monorepo dev

pnpm install
pnpm -r build
pnpm stubshot generate --out public/placeholders --count 3 --sizes 1200x800 --theme mesh-gradient --format svg --prefix product --seed my-project --manifest