A full-stack web application for Etsy sellers managing digital products. ShopSmith bridges the gap between creative content preparation and marketplace publishing through a local-first, privacy-respecting architecture.

Key Features

AI-Powered Content Generation — Uses Google Gemini to analyze product files and auto-generate titles, descriptions, tags, mockup images, and risk flags optimized for Etsy’s marketplace.

Guided Publish Workflow — A 9-step keyboard-driven workflow that walks sellers through the entire listing process, from template selection through evidence recording, with copy-paste automation and readiness validation.

Upload Kits — Downloadable ZIP bundles containing properly named images, digital files, text content, and step-by-step instructions for offline publishing.

CSV Reconciliation — Bulk-match published Etsy listings using CSV exports with 3-tier matching (SKU, title + price, title-only) for tracking what’s been published where.

Architecture

Built with React 18 and Express on a fully TypeScript stack, backed by SQLite for local-first data ownership. Includes Sharp for image processing, FFmpeg for media handling, and Real-ESRGAN for image upscaling. The application uses content-addressed blob storage with SHA hashing for version tracking and derivative caching.

The publish system uses an abstracted provider model (EtsyManualProvider) designed for future API integration without changing the core workflow. Sixteen readiness checks with severity tiers (blockers vs. recommendations) ensure listing quality before publish.

Approach

ShopSmith takes a safety-first approach to Etsy integration — no scraping, no browser automation, all marketplace interaction is manual. This avoids Etsy API approval dependencies while respecting platform terms of service. A compliance website with Privacy Policy and Terms of Service is deployed via GitHub Actions.