Description
SellPhi — Turnkey Magento + WordPress Storefront (Project 64)
Inventor: Christopher Gabriel Brown.
IP status: No USPTO patent application filed. This product is protected by copyright and delivered under a single-site perpetual license. The SVG product mark designates it as “Base, No IP.”
SKU: 2095 | Version: 0.1.0 | License: Single-site perpetual, non-transferable, non-exclusive.
Overview
SellPhi is a complete deployment-and-configuration layer that turns any bare Linux VPS into a running online store with an integrated blog, a site-wide RSS feed, and a full admin console—all from a single command. It ships empty: no products, no customers, no orders. At install time the interactive guided installer personalises every template, browser tab, feed title, and outgoing email to the buyer’s own brand.
Magento 2 CE and WordPress are not included in this package. SellPhi is the orchestration, configuration, and tooling layer. The installer fetches Magento 2 CE from Adobe’s official source (licensed under OSL-3.0 / AFL-3.0) and WordPress from wordpress.org (GPL-licensed) at install time. The purchaser runs those packages under their own upstream licences. Nothing in this purchase conveys any right to Magento, WordPress, or any other third-party component.
Claude AI is baked in: once the buyer supplies their own Anthropic API key, the admin gains “Write description,” “Draft blog post,” “Reply to customer,” “Rewrite in [tone],” “Translate,” and “Category writer” buttons throughout. SellPhi never sees, stores, or proxies the buyer’s API key beyond forwarding requests to Anthropic.
Who This Is For
- You want a real online store you own, not a hosted account you rent.
- You have (or will rent) any Linux VPS.
- You want AI helping you write copy without giving up control.
- You don’t want to spend a week configuring Magento.
System Requirements
Requirement Detail
Operating system Any modern Linux — Ubuntu 22.04+, Debian 12+, CentOS, Rocky, or equivalent
Minimum RAM 2 GB
Recommended RAM 4 GB
Container runtime Docker + Docker Compose (the installer offers to install both if missing)
Domain One domain pointing at the VPS’s public IP (both apex and www should resolve)
Budget VPS tier $4/mo to try; $12/mo comfortable for production
Claude AI (optional) Anthropic API key from console.anthropic.com
Service Stack — Docker Compose Orchestration
SellPhi orchestrates 6 services and 5 named Docker volumes via a single docker-compose.yml (100 lines). Every service restarts automatically ( unless-stopped policy). The stack exposes port 80 (HTTP) and port 443 (HTTPS) only.
Service Image Role
mariadb mariadb:11.4 Relational data layer. Creates the magento database and user on first boot. Seeds category skeleton from seed/magento/categories.sql .
magento sellphi/magento:0.1.0 Magento 2 CE storefront with PHP-FPM. Mounts CMS page seeds and theme overlays from seed/magento/cms-pages and seed/magento/theme .
wordpress wordpress:6-fpm Blog at /blog/ . Separate database ( wordpress ) with wp_ table prefix. Mounts theme seed from seed/wordpress/theme .
nginx nginx:1.27-alpine Edge reverse proxy. Routes / to Magento, /blog/ to WordPress, handles TLS termination (Let’s Encrypt or upstream).
sitefeed python:3.12-alpine Site-wide RSS feed builder. Polls Magento and WordPress, generates a unified feed.xml with a styled reader view. Runs via loop.sh .
claude-proxy sellphi/claude-proxy:0.1.0 Local AI endpoint (optional; activated by Docker Compose profile claude ). Injects the Anthropic API key server-side so the browser never sees it.
Docker Volumes
Volume Purpose
db-data MariaDB persistent storage ( /var/lib/mysql )
magento-media Uploaded product images and media ( /var/www/html/pub/media )
wp-data WordPress content directory ( /var/www/html )
certs Let’s Encrypt certificates ( /etc/letsencrypt )
feed-out Generated RSS feed output ( /var/www/feed )
Interactive Guided Installer
The installer ( install.sh , 233 lines of Bash) walks the operator through 9 steps with colour-coded terminal output. Every step prints what it does, why, and what command will run, then waits for a “yes” before proceeding. Any “no” stops cleanly and prints the exact --from-step command to resume. The script is fully idempotent—running it twice never breaks a working install.
Shell flags: set -euo pipefail .
Step Title What Happens
1 Docker check Detects Docker; offers to install via curl -fsSL https://get.docker.com | sh if absent.
2 Your domain Prompts for the public domain (no https:// , no trailing / ). Required.
3 Your brand Prompts for brand name; replaces “cri-one” throughout all shipped templates.
4 Admin login Prompts for Magento admin username (default: admin ) and password. Generates a 20-character random password via openssl rand -base64 18 if left blank.
5 Claude AI Optional. Prompts for Anthropic API key. Displays per-call cost estimates for each model tier.
6 TLS certificate Offers free Let’s Encrypt or defers to upstream proxy (Cloudflare/Caddy).
7 Write .env Commits all choices to .env . Backs up any existing .env to .env.bak first.
8 Boot the stack Runs docker compose up -d . First boot takes 3–5 minutes while Magento initialises its database.
9 Done Displays storefront URL, admin console URL, blog URL, RSS feed URL, and admin credentials.
Configuration Reference — 24 Environment Variables
All configuration lives in a single .env file (73 lines in the shipped .env.example ). The installer fills it in interactively; it can also be edited by hand. Values survive upgrades—the installer never overwrites customised entries.
Site Identity (4 variables)
Variable Required Default Notes
DOMAIN Yes — Public domain, no protocol, no trailing slash.
BRAND_NAME Yes — Replaces “cri-one” in storefront, tabs, feed titles, email From lines, and all CMS templates.
BRAND_TAGLINE No — One-line tagline used in emails and site footer.
BRAND_CONTACT_EMAIL No — Public contact email address.
Admin Login (2 variables)
Variable Required Default Notes
ADMIN_USERNAME Yes admin Magento admin username.
ADMIN_PASSWORD Yes (generated) 20-character random string if left blank.
Database (3 variables)
Variable Required Default Notes
DB_ROOT_PASSWORD Yes (generated) MariaDB root password.
DB_MAGENTO_PASSWORD Yes (generated) Password for the magento DB user.
DB_WORDPRESS_PASSWORD Yes (generated) Password for the wordpress DB user.
Claude AI (3 variables)
Variable Required Default Notes
CLAUDE_API_KEY No — Enables AI buttons when set. Obtain from console.anthropic.com .
CLAUDE_MODEL_FAST No claude-haiku-4-5 Model for descriptions, tone rewrites, short replies, and translations.
CLAUDE_MODEL_DEEP No claude-sonnet-5 Model for blog drafts, category descriptions, and long-form content.
Payments (4 variables — all optional)
Variable Notes
STRIPE_PUBLISHABLE_KEY Test key starts pk_test_ ; live key starts pk_live_ .
STRIPE_SECRET_KEY Never exposed to the browser; the container adds it server-side.
PAYPAL_CLIENT_ID From the PayPal Developer Dashboard.
PAYPAL_SECRET From the PayPal Developer Dashboard.
Leaving all four blank drops the store into invoice / manual checkout mode.
Outgoing Email (5 variables — all optional)
Variable Notes
SMTP_HOST Any SMTP relay: Amazon SES, Postmark, SendGrid, Mailgun, or self-hosted.
SMTP_PORT Default 587 (STARTTLS). Use 465 for implicit TLS.
SMTP_USERNAME Provided by the relay.
SMTP_PASSWORD Provided by the relay.
SMTP_FROM_EMAIL The “From” address on order confirmations and password resets.
Skipping SMTP falls back to PHP mail() , which works but often lands in spam.
TLS (1 variable)
Variable Values Notes
TLS_MODE letsencrypt | off Set off if TLS is handled upstream (Cloudflare, Caddy, or another nginx).
Advanced (2 variables)
Variable Default Notes
BACKUP_DIR /var/backups/sellphi Directory on the host where nightly backups are stored.
BACKUP_HOUR 3 24-hour server local time for the nightly backup run.
Claude AI Integration — 6 Admin Buttons
All AI features are opt-in. Without a CLAUDE_API_KEY in .env , every button still appears but displays “Add your Anthropic API key in Settings → Claude” when clicked. Setting the key activates the buttons immediately—no restart required. The claude-proxy service runs on the claude Docker Compose profile and can be stopped or started independently.
Button Location Model Tier Description
Write description Catalog → Products → any product edit page CLAUDE_MODEL_FAST Takes the product name and any tags/category context; produces a 3–5 sentence description in the brand voice. A “brand voice” note can be set in Settings → Claude and injected into every prompt.
Draft blog post WordPress editor CLAUDE_MODEL_DEEP From a title and 1–2 sentence outline, drafts a full post with headings, body, and closing paragraph.
Reply with Claude Sales → Communications → any customer email or contact form CLAUDE_MODEL_FAST Reads the incoming message and drafts a polite, on-brand reply. Nothing is sent—the draft opens in the compose window for review.
Rewrite in [tone] Any CMS block, product description, or page editor CLAUDE_MODEL_FAST Highlight text, click Rewrite, pick a tone (formal / casual / punchy / warm / technical). Returns up to 3 variants side by side.
Translate Any content editor with a language selector CLAUDE_MODEL_FAST Translates selected text to the target language. Preserves markup and links.
Category writer Catalog → Categories → any category page CLAUDE_MODEL_DEEP Writes a category intro paragraph for above the product grid, based on the category name and the first 5 products in it.
Model Tiers & Per-Call Cost Estimates
Model Best For Typical Cost Per Call Response Time
claude-haiku-4-5 Product descriptions, tone rewrites, short replies, translations ~$0.005 ~1 second
claude-sonnet-5 Blog drafts, category descriptions, hero copy ~$0.03 ~3 seconds
claude-opus-4-8 Long-form articles, editorial letters ~$0.15 ~8 seconds
Models can be mixed: use Haiku for descriptions ( CLAUDE_MODEL_FAST ) and Opus for the blog ( CLAUDE_MODEL_DEEP ) by setting both variables in .env .
CMS Templates & Category Skeleton
SellPhi ships three CMS page templates and a pre-built category skeleton, all seeded into Magento at first boot:
CMS Templates
- Featured-items fan-out — a landing-page template that showcases selected products in a visual grid.
- Footnote with terms — a page template with a built-in terms-and-conditions footnote block.
- Share-to-a-friend — a page template with social sharing and referral functionality.
Category Skeleton
Category
Store
Blog
Music
Art
Video
Section
Site-Wide RSS Feed
The sitefeed service (Python 3.12 on Alpine Linux) continuously polls both Magento and WordPress, generating a unified feed.xml available at https:// /feed.xml . The feed includes a styled reader view so anyone opening it in a browser sees a real page, not raw XML. Compatible with Feedly, NetNewsWire, Reeder, Thunderbird, and any other RSS reader.
Backup & Restore
- Nightly automated backups to a configurable directory (default: /var/backups/sellphi/ ).
- Configurable backup hour (default: 03:00 server local time).
- Manual backup: ./tools/backup/backup.sh
- Restore from backup: ./tools/backup/restore.sh /var/backups/sellphi/ .tar.gz
- Nuclear reset (full wipe and reinstall): docker compose down -v && rm .env && ./install.sh
Upgrade Path
SellPhi ships as versioned ZIPs following semantic versioning. Upgrading is a rebase, not a migration—data and settings stay put, only the code changes.
Version Bump Example Risk
Patch 0.1.0 → 0.1.1 Bug fixes only. Safe to install without reading notes.
Minor 0.1.0 → 0.2.0 New features, backwards compatible. Read the changelog.
Major 0.x.y → 1.0.0 Breaking changes possible. Back up first; plan a maintenance window.
The --upgrade flag on install.sh reads the existing .env , diffs against the new .env.example , asks about newly-added keys, pulls new container images, runs any needed database migrations, and restarts services. Rollback is supported by restoring the pre-upgrade backup.
The storefront subscribes to the SellPhi release feed automatically. An admin notification appears in the top bar when a new version is available, linking to a plain-English changelog. No forced updates; no phone-home beyond checking the release feed once a day.
Documentation Set — 5 Documents
File Lines Contents
docs/QUICKSTART.md 80 10-minute walkthrough from VPS to first live product. Covers install, first product creation with AI-generated description, and RSS feed setup.
docs/CONFIG.md 98 Complete reference for all 24 environment variables, grouped by function, with defaults and notes.
docs/CLAUDE-FEATURES.md 76 Every AI button in the admin: location, model tier, what it does, cost estimates, and how to enable/disable.
docs/TROUBLESHOOTING.md 130 Common issues with exact fixes: Docker not found, permission denied, stopped mid-install, 502 Bad Gateway, TLS warnings, Claude button errors, Stripe checkout issues, email delivery, backups, and nuclear reset.
docs/UPGRADING.md 59 Version philosophy (semver), step-by-step upgrade procedure, the --upgrade flow, rollback instructions, and release-feed notifications.
What Is in the Package
The deliverable archive ( SellPhi-0.1.0.zip ) contains 15 files across 2 directories :
# File Lines Purpose
1 README.md 75 Project overview, what ships, what does not ship, requirements, and licence summary.
2 START-HERE.txt 24 Three-step plain-text quick-start: rent a VPS, copy the folder, run ./install.sh .
3 VERSION 1 Contains the version string: 0.1.0 .
4 LICENSE.txt 72 Single-site perpetual license. 8 clauses covering grant, permitted use, restrictions, third-party components, Anthropic/Claude AI, no warranty, termination, and governing law.
5 .env.example 73 Annotated template for all 24 environment variables. The installer fills this in interactively.
6 docker-compose.yml 100 Full service stack: 6 services (mariadb, magento, wordpress, nginx, sitefeed, claude-proxy), 5 volumes, 2 exposed ports.
7 install.sh 233 Interactive guided installer. 9 steps, colour-coded output, idempotent, resumable via --from-step .
8 sellphi-product-image.svg 125 Vector product illustration (1000 × 1000 SVG) depicting a browser window with storefront grid, shopping cart, and VPS server rack.
9 SellPhi-0.1.0.zip — The primary deliverable archive containing the complete SellPhi package (12 entries).
10 SellPhi-0.1.0.zip.bak-readme — Archive directory listing / backup metadata for the ZIP.
11 docs/QUICKSTART.md 80 10-minute guided tour from zero to first live product.
12 docs/CONFIG.md 98 Complete environment-variable reference.
13 docs/CLAUDE-FEATURES.md 76 AI button reference with locations, model tiers, and cost estimates.
14 docs/TROUBLESHOOTING.md 130 Common issues and exact fixes.
15 docs/UPGRADING.md 59 Upgrade procedure, rollback, and release notifications.
Licence Terms Summary
- Type: Single-site perpetual, non-transferable, non-exclusive.
- Scope: One (1) production instance on one (1) domain and its subdomains. Unlimited staging/development environments serving no public traffic.
- Perpetual: The licence does not expire. The buyer may use the purchased version forever, on any hardware, with no phone-home requirement.
- Permitted: Install and run on one production VPS; modify configuration, styling, templates, and text content; sell products and keep 100% of revenue; extend with custom modules or scripts.
- Prohibited: Redistribute, resell, sublicense, or share; remove copyright notices; use as the basis of a hosted storefront-as-a-service; register or claim IP rights in the software or its templates.
- Third-party: Magento CE (OSL/AFL), WordPress (GPL), nginx, MariaDB, PHP, and others are each governed by their own upstream licences.
- Claude AI: The buyer provides their own Anthropic API key and is solely responsible for all API charges. SellPhi never sees, stores, or proxies the key.
- Governing law: United States, state of Licensor’s residence.
How this is delivered
This package ships on a single Blu-ray disc, posted to the delivery address on your order. The archive on the disc is AES-256 encrypted; the passphrase is sent separately, by email, once the disc is despatched — so the disc alone is of no use to anyone who intercepts it.
Discs are despatched by tracked, signed-for post. Allow 5 business days for mastering and verification before despatch.
© 2026 Christopher Gabriel Brown. All rights reserved.
Footnotes
- Product number 8514.
- Family: sellphi.
- Purchase: When you buy, you buy the use of that blueprint only.