Owner: Engineering Team | Last Updated: 2026-01-30 | Status: Active
The WWAI Shopify Plugin is an embedded Shopify application that brings AI-powered text humanization directly into the Shopify admin interface. Store owners and content managers can humanize product descriptions, collection copy, blog posts, and other store content without leaving the Shopify environment. The plugin integrates with the WWAI Django REST API backend for all AI processing and user account management.
Repository: To be confirmed when codebase is provided
Platform: Shopify App Store (Embedded App)
Integration Type: Shopify App Bridge
| Technology | Purpose |
|---|---|
| Shopify App Bridge | Embedded app framework for Shopify Admin |
| Shopify Polaris | UI component library (expected) |
| Shopify Admin API | Store data access |
Draft: Full tech stack, framework version, and dependencies will be documented when the codebase is analyzed.
| Feature | Description | Status |
|---|---|---|
| Text Humanization | AI-powered humanization of store content within Shopify Admin | Active |
| Product Description Humanization | Direct humanization of product descriptions | Active |
| Account Integration | Linked to WWAI user account for credits and billing | Active |
Draft: Complete feature set will be documented when the Shopify plugin codebase is analyzed. Expected additional features may include batch humanization, collection/page content support, and usage tracking.
Shopify Admin Dashboard
|
v
WWAI Shopify App (Embedded via App Bridge)
|-- Shopify Admin UI Integration
|-- App Bridge Communication Layer
|-- Authentication (Shopify OAuth + WWAI token)
|
+---> Shopify Admin API
| |-- Product data read/write
| |-- Collection data read/write
| |-- Content management
|
+---> Django REST API (WWAI Backend)
|-- /api/feature/humanizer/ (text humanization)
|-- /api/user/* (account, credits)
|-- /api/payments/* (billing)
The Shopify plugin uses a dual-authentication approach:
Draft: The exact authentication flow, session management, and account linking mechanism will be documented when the codebase is analyzed.
| Data Type | Access | Purpose |
|---|---|---|
| Products | Read/Write | Humanize product descriptions |
| Collections | Read/Write | Humanize collection descriptions |
| Pages | Read/Write | Humanize static page content |
| Blog Posts | Read/Write | Humanize blog content |
Draft: Exact Shopify API scopes and permissions will be documented when the codebase is analyzed.
| Aspect | Details |
|---|---|
| App Name | To be confirmed |
| Category | Content / Copywriting |
| Pricing | Linked to WWAI subscription plans |
| Installation | Via Shopify App Store |
The Shopify plugin communicates with the WWAI Django REST API backend:
application/jsonDraft: Complete API endpoint mapping and Shopify webhook integrations will be documented when the codebase is analyzed.
Draft: This section will be updated with project-specific details when the codebase is provided.
| Tool | Purpose |
|---|---|
| Node.js | Runtime and build tooling |
| Shopify CLI | Local development and testing |
| Shopify Partner Account | App development access |
| ngrok or similar | HTTPS tunneling for local development |
# 1. Clone the repository
git clone <repository-url>
cd <shopify-plugin-directory>
# 2. Install dependencies
npm install
# 3. Configure Shopify app credentials
# Set up .env with Shopify API key, secret, and scopes
# 4. Start development server
shopify app dev
# or
npm run dev
Draft: This section will be updated when the codebase is provided.
Draft: Deployment process including Shopify App Store review, versioning, and release management will be documented when the codebase is analyzed.
Draft: This section will be populated with common issues and solutions when the codebase is analyzed.
| Issue | Possible Cause | Resolution |
|---|---|---|
| App not loading in Shopify | App Bridge configuration error | Verify API key and host parameters |
| Humanization fails | WWAI account not linked | Complete WWAI account linking flow |
| Permission denied | Insufficient Shopify scopes | Check app scopes in Shopify Partner Dashboard |
| Date | Author | Change |
|---|---|---|
| 2026-01-30 | Admin | Initial creation |
Up: WalterWrites