Skip to content

SESSION-2026-05-26.md

Latest commit

 

History

History
73 lines (50 loc) · 5.66 KB

SESSION-2026-05-26.md

File metadata and controls

73 lines (50 loc) · 5.66 KB
Raw

Session note — 2026-05-26

While you were away, batch was completed. Nothing was pushed (I cannot type into Terminal). Run the push script to ship everything in one commit:

bash "/Users/andreymanirko/Documents/Claude/Projects/AM PLTRNC/help-center/06-build/scripts/push-batch-2026-05-26.sh"

After the push, Cloudflare Pages will rebuild and redeploy in ~1.5 minutes at help-d9v.pages.dev (and help.playtronica.com when the domain is wired).

What is in this batch

New pages

  • content/en/devices/compare.md — side-by-side comparison for all five devices. Spec matrix, what is in each box, software compatibility, decision tree by use case, prices, bundles.
  • content/en/getting-started/accessories.md — rewritten from the stub into a full catalog page covering every cable, adapter, conductive material, patch pack, alligator-clip pack, the Playtron case, the necklace, the scarf, all 8 bundles, the e-gift card, and the third-party IO-Lights. All Shopify product handles match the live catalog (verified through the Shopify MCP).

Mobile WhatsApp fix

  • components/WhatsAppFeedback.tsx — when the reader highlights text on a page, the floating "What's missing?" button morphs into a direct <a href> "📍 Send selection" link to the wa.me deeplink with the highlight attached. Solves the iOS-Safari issue where the first tap on a selection tooltip was eaten by the OS selection-dismiss.

Content feedback round

  • content/en/devices/orbita.md — moved the "handle only the parts" safety block from top to bottom, added "touch the turntable" to quick-start step 3, replaced the YouTube video with SC3FL1LeRVM, swapped the web settings link to synth.playtronica.com/settings, merged the firmware step numbering into one continuous list (was 1-5 then restarting 1-2).
  • content/en/orders/track-your-order.md — normalized email format throughout. support@playtronica.com is now shown as a bare address with the subject line on a separate clause, replacing inline link patterns that visually merged with surrounding text.
  • content/en/orders/returns-refunds.md — added an explicit warning not to ship returns to Estonia (or to any address found online) before receiving our confirmation email with the routed return address.
  • content/en/professionals/b2b-bulk.md — tone rewrite. Formal/procedural ("for orders of 10 units we issue formal quotes and offer institutional pricing") replaced with warm and human; same offer (bulk pricing, VAT invoice, setup advice, consolidated shipping) preserved.
  • content/en/orders/pricing-and-discounts.md — removed the 7-day price-match clause entirely. The "forgot a code" path is kept but reframed as case-by-case rather than a hard 7-day rule. Softened the B2B paragraph to match the new B2B-page tone.

Legacy URL preservation

  • public/_redirects — extended from 23 to ~70 301 rules so every old Super.so help center path (/orbita, /playtron-faq, /returns, /community, etc.) redirects to its new sectioned URL. Protects Google rankings and any external links pointing to the old paths.
  • docs/POST-PUSH.md — verification one-liner extended to cover the new redirect rules.

Housekeeping

  • CHANGELOG.md — Unreleased section updated with everything above.
  • content/en/getting-started/which-device.md — added a small callout that points readers to the new /devices/compare/ for choosing between devices.

Verification done

  • TypeScript clean (no errors outside stale .next/ cache).
  • Search index picks up the new compare.md (38 visible pages, matches expected count of EN files minus the hidden *-advanced.md deep-dives).
  • All 19 internal links in compare.md resolve to real .md files.
  • All 24 Shopify product handles in compare.md and accessories.md match the live catalog (verified via the Shopify MCP).
  • Full Next.js build was not run to completion in the sandbox (it exceeds the 45s shell timeout), but TypeScript check + search-index build both pass. Cloudflare Pages will run the full build on push.

Decisions captured

  • Price-match clause — removed entirely (your latest answer overrode the earlier "shorten 7→3 days").
  • D3 catalog source — Shopify MCP. Used the live data to write the accessories page.
  • D4 structure — new /devices/compare/ page (sits at order: 0 in the "Your Device" section so it appears at the top of the sidebar there).
  • Favicon — kept the existing Playtronica wave mark in app/icon.png + app/apple-icon.png. If you want to match the shop favicon exactly, drop the shop's PNG into those two file paths (Next.js auto-generates the link tags from those filenames).

Still pending (not in this batch)

These are open from the earlier list but were not in the "everything at once" quick batch:

  • C2 — invoice-vat.md full rework
  • D1 — "what do I need to make sound" cross-link to the shop on each device page

These are also pending from earlier passes:

  • Live accessibility audit on the deployed site
  • Live external link health check
  • Live mobile layout sweep

To run translations later

The translation Action will need to pick up these new and changed EN files. Once you have set ANTHROPIC_API_KEY in the GitHub repo secrets, trigger the Action manually (Actions tab → "Translate pages" → Run workflow). It will open a PR with DE/ES/FR/JA versions.

After the push lands

The auto-deploy preview will be at help-d9v.pages.dev/devices/compare/ and help-d9v.pages.dev/getting-started/accessories/. Spot-check on both desktop and mobile:

  • Selection-to-WhatsApp on iPhone (this was the bug we hunted).
  • New compare page renders the spec matrix readably on mobile.
  • All product links in the accessories page open the correct shop pages.