What it does
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.
Features
- 01 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.
- 02 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.
- 03 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.
- 04 Cost Tracking Tracks prompt_tokens, completion_tokens, and computes USD cost per generation using OpenAI's pricing constants. Full generation history with applied status.
- 05 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.
- 06 One-Click Apply Generated content is applied directly to Shopify via productUpdate GraphQL mutation with automatic retry on throttles. No copy-paste needed.
Built with
- Remix
- TypeScript
- React
- Polaris
- Prisma
- PostgreSQL
- OpenAI API
- Shopify GraphQL API
- Sentry