AI Descriptions

A Shopify product-copy generator with tone controls, resilient AI requests, cost tracking and one-click GraphQL apply.

Tone, length and product-copy generation controls

My role: Creator and engineer
Work type: Independent Shopify product
Current state: Pre-launch
Year: 2026

The product

AI Descriptions is a Shopify app that uses OpenAI's GPT-4o-mini to write compelling product descriptions, SEO titles, and meta descriptions directly inside the Shopify admin. Features a sophisticated prompt engineering system with 5 tones (Professional, Casual, Playful, Luxury, Minimalist) and 3 length options (Short, Medium, Long).

Includes a custom OpenAI client with exponential backoff with jitter (4 retries, 90s total budget), safe error message sanitization, per-generation cost tracking, and one-click apply to Shopify via GraphQL Admin API.

Product capabilities

What works today.

AI-Powered Generation

Uses OpenAI GPT-4o-mini with JSON-mode prompt engineering to generate HTML descriptions, SEO titles (60 chars), and meta descriptions (155 chars) in a single API call.
5 Tones & 3 Lengths

Professional, Casual, Playful, Luxury, or Minimalist tone. Short, Medium, or Long length. Plus custom brand keywords and voice notes for fine-grained control.
Resilient API Client

Custom OpenAI client with 4 retries, exponential backoff with jitter, 90s total budget, 30s per-attempt timeout. Safe error messages prevent prompt leakage to merchants.
Cost Tracking

Tracks prompt_tokens, completion_tokens, and computes USD cost per generation using OpenAI's pricing constants. Full generation history with applied status.
Monthly Quota System

Free tier: 50 generations/month. Pro tier: 1,000/month. Quota auto-resets on calendar month change. Visual progress indicator with logistic curve simulation.
One-Click Apply

Generated content is applied directly to Shopify via productUpdate GraphQL mutation with automatic retry on throttles. No copy-paste needed.

Product views

A closer look.

D01Generated product-copy workspace in use

Toolchain

Remix
TypeScript
React
Polaris
Prisma
PostgreSQL
OpenAI API
Shopify GraphQL API
Sentry

AI Descriptions

What works today.

AI-Powered Generation

5 Tones & 3 Lengths

Resilient API Client

Cost Tracking

Monthly Quota System

One-Click Apply

A closer look.