Dribbble Reference CLI

Local CLI that launches headless Chrome, opens Dribbble search pages, and downloads visual references to disk.

Why this exists

Dribbble's public API is not a good fit for search-driven inspiration capture, so this tool uses a local browser session instead.

Install

npm install

Usage

npm start -- "landing page" --limit 12

Or install the CLI globally from this directory:

npm link
dribble "mobile dashboard" --limit 20

Output

Each run writes to:

output/<query-slug>/
  manifest.json
  assets/

manifest.json includes:

• shot title
• shot URL
• remote asset URL
• downloaded asset path
• item status

Notes

• Requires local Google Chrome or Chromium. Override with CHROME_PATH if needed.
• Uses headless Chrome by default. Pass --headful to inspect selectors visually.
• Dribbble can change markup or rate-limit automated browsing. If that happens, selectors will need to be updated.