Software Updates

per-file download buttons + Download All on CAD share page

• Each file card in the sidebar now has its own 'Download' button (violet, bottom of card) gated by meta.allowDownload — so the NYC casting house can grab a single STL without selecting it first.
• Download All button in the section header appears whenever allowDownload is true and there are 2+ files. Downloads via fetch → createObjectURL (true file-save dialog, correct filename) with a 400 ms stagger between files so browsers don't block the chain. Falls back to window.open on network/CORS error. Shows a Loader2 spinner + 'Downloading…' label while in-progress.
• File names are humanised: '{projectNumber}-v{n}.{ext}' for direct uploads, '{libraryFileName}' for CAD library links.
• Toast confirms '3 files downloaded' on completion.

unbreak /account + brand-styled error boundaries

• /account was throwing 'Oops Something went wrong' because each of its 4 server-side Prisma queries (user, giftCard, weddingSite, weddingSiteAdmin) was awaited unguarded — any one failure (most likely a missing migration on prod for the wedding tables) bubbled to error.tsx.
• Wrap every query in try/catch with explicit console.error tagging ("[/account] <query> failed:") so we can grep Vercel logs and the page degrades gracefully (renders the bits that worked) instead of hard-failing.
• New shared component src/components/errors/brand-error-page.tsx:
• Playfair-Display 'OOPS' headline using font-display + 0.2em tracking, bracketed by gold gradient dividers.
• Three-button row: Try again / Return home / mailto:tech@katura1999.com with a pre-filled subject + body containing the page URL, error.digest reference, and error.message so customers can fire off a useful report in one click.
• Sentry.captureException on mount so client-only crashes (hydration / useEffect throws) reach the dashboard — server boundaries already report via instrumentation.ts → onRequestError.
• Tagged with the boundary name (locale-root, cart, checkout, products, shop, admin, cad) so we can filter in Sentry.
• Refactor all six error.tsx files to wrap BrandErrorPage with context-specific copy: [locale]/error.tsx → generic [locale]/cart/error.tsx → 'Your cart is taking a moment' [locale]/checkout/error.tsx → reassures payment NOT charged [locale]/products/error.tsx → 'every Katura piece is one of a kind' [locale]/shop/error.tsx → 'shop is taking a breath' admin/error.tsx → escalates to tech@ with louder ref platform/(marketing)/cad/error.tsx → 3D viewer specific copy

unblock CAD library link + materials input + surface upload errors

• /admin/projects/[id]?tab=cad: 'From library' now uses the lightweight POST /api/admin/cad/links endpoint (creates a polymorphic CadFileLink row) instead of the heavy /cad-files/from-library copy route. The project page already renders entries from the cadFileLink table, so no file copy is needed. Eliminates the silent failure when copying between Supabase 'cad' and 'uploads' buckets.
• POST /api/admin/jewelry-projects/[id]/cad-files: surface real Supabase storage and Prisma errors back to the admin instead of an opaque 'Failed to upload CAD file' (P2002 / P2003 mapped, RLS & bucket-not-found mapped).
• /admin/projects/[id] CadFilesTab: include HTTP status in error toasts and stop swallowing exceptions in the catch blocks.
• /admin/projects/new: replace the HTML 'hidden' attribute with the Tailwind 'hidden' class on the four animated step <section>s. The motion.section wrapper was not always forwarding the boolean attribute, leaving inactive sections visually hidden but still occupying the layer above the active step and intercepting clicks on Materials > Metal Preference (and other top-of-section inputs).

X/Twitter pixel + multi-platform link tracking + recommendations

• X (Twitter) Universal Website Tag injected (NEXT_PUBLIC_X_PIXEL_ID, gated to prod)
• New x-pixel.ts with isXTraffic() detection (twclid, x.com/t.co referrer, utm)
• New multi-pixel.ts aggregator fans events to Meta + X with shared event_id preserving Meta CAPI deduplication
• All 6 conversion call-sites migrated (cart, checkout, success, wishlist, PDP, signup)
• Lead event added on email-signup popup success (welcome-gift-popup)
• New /lib/marketing/channels.ts — single source of truth for ad platforms (Meta, FB, IG, X, Google, YouTube, Pinterest, TikTok, LinkedIn, Reddit, Snapchat, Email, Influencer, Podcast, QR, Other)
• Smart-link create dialog: free-text utm_source replaced with platform Select including operator notes per channel
• Bulk-generate dialog: dynamic channel checkboxes from MARKETING_CHANNELS
• Recommendations card on /admin/stella/marketing/links — top products by purchases*4 + addToCart*2 + wishlist*1.5 + clicks*0.5 (last 30d), filtered to channels without an existing link, one-click pre-seeds the create dialog
• Recommendations API at /api/admin/marketing/recommendations
• Traffic classifier extended with YouTube, Reddit, Threads, Snapchat, WhatsApp (referrer-channel.ts + 2 SQL CASE blocks + CHANNEL_COLORS + channelIcon)
• docs/marketing/X_TWITTER_STRATEGY.md — luxury-brand X playbook (audience, creative, bidding, KPIs, crisis playbook, 90-day rollout)

admin UI panel + Stripe webhook auto-mark-paid

• New <AdminInvoicePanel> on /admin/orders/[id]: send-invoice / mark-paid / check-received / cancel actions, status badge, reminder log, customer payment-method shown
• Admin GET endpoint added: /api/admin/invoices/[orderId]
• Stripe webhook checkout.session.completed now detects metadata.kind='order_invoice' and calls markInvoicePaid() — fires the payment-confirmed email automatically when card payment succeeds
• New shared markInvoicePaid() helper in invoice/service.ts (idempotent; used by both admin route and webhook)

branded invoice system with check + electronic payment flows

• OrderInvoice + OrderInvoiceReminder models (idempotent SQL migration)
• 9 unique branded emails: initial + 7 daily polite/luxurious follow-ups + auto-cancel
• Three customer payment paths:
• Stripe card (creates Checkout Session against existing order total)
• Pay by check (reveals 14113 Laurel Haven address + payable-to 'October Skies Benediction LLC DBA KATURA 1999', auth + own-order gated)
• Other electronic (Venmo/Zelle/Wise/wire) -- pauses 48h, sends 'please allow us 24-48 hours to confirm' email
• Customer order detail page mounts InvoicePaymentPanel above items
• Daily cron at 14:00 UTC (9am EST) processes due reminders
• Admin actions: create, mark-paid, check-received, cancel
• Reminders auto-pause 7 days for checks, 48h for electronic
• Auto-cancels order on day 8 with final polite notification

saved-addresses CRUD with labels + set-default

• New API: GET/POST /api/account/addresses, PATCH/DELETE /api/account/addresses/[id]
• First address auto-becomes default + labelled 'Primary'
• Setting an address as default mirrors fields back to User denormalized cols (so Stripe checkout pre-fill stays accurate)
• Deleting the default promotes the oldest remaining address
• Cannot un-default the last/only default (silently keeps it)
• New <SavedAddressesSection> client component: list / add / edit / delete / set-default with label suggestions ('Primary', 'Lake House', 'Daughter\'s Apartment', etc.)
• Mounted in /account/settings under the legacy Default Address card

welcome splash everywhere, navy trust icons, hero replay, backfill script

• Extract WelcomeSplash into reusable client component (src/components/account/welcome-splash.tsx)
• Mount on /account so client logins/registrations get the same Welcome Rosser animation employees see on /admin
• Login + register + reset-password (employee invite) now clear the relevant session flag on success so the splash fires for the new session
• Trust bar icons: amber → footer navy (#0B1527) on a very light tint circle
• Hero collage product tile: imperatively replay video on hover so autoplay tiles can be re-triggered without page refresh
• New backfill script scripts/backfills/backfill-default-addresses.ts: for every paying user with no Address rows, create Primary + extras from past order shippingAddress (deduped by line1+postalCode); fills user denormalized fields if blank. Idempotent. --apply flag required to write.

address auto-save, profile enrichment, compact gift card, tracker fix

• Order tracker line now spans first→last circle centers (math: 100/N/2% inset)
• Address model: add optional 'label' field (e.g. 'Lake House', 'Primary')
• New helper saveShippingAddressForUser: on first order fills user denormalized fields + creates default 'Primary' Address; subsequent unique addresses saved as additional rows (dedupes by line1+postalCode case-insensitive)
• Stripe webhook calls helper non-blocking after order update
• /account Profile card now shows phone + saved addresses with labels + edit link to settings
• /account Gift Cards section shrunk to compact 1-line summary with collapsible breakdown; redeem control kept inline
• Remove gift emoji from Dates & Perks card description

lock-in decisions for orders/projects/tracking work

Art tab: IG-style gallery + lightbox + multi-upload + paste; Stones: collapsible cert dump; carrier-detect util; OrderTimelineEvent model

orders/projects reconciliation + tracking plan

Admin orders: remove Delete button; require typed order # to cancel

Stone video upload/viewer, fast order search (?lite=1), stone spotlight dialog (video + cert + CAD)

Remove Rhodium from metal price displays — plating only, not castable

Project per-section chat (admin tabs + share-link guests)

• New JewelryProjectComment model: threaded (1 level), per-section (CAD/CASTING/LABOR/GENERAL), soft-delete, admin/guest authorship, attachments JSON (images + docs ≤10MB, ≤4 per comment).
• New ProjectShareCommentMode enum on JewelryProjectShareLink: NONE / ANONYMOUS / REQUIRE_NAME / REQUIRE_EMAIL.
• Admin API: list / create / edit / soft-delete comments per project.
• Share API: list / create with commentMode enforcement.
• Upload API: dual-auth (admin session OR ?token=share), Supabase Storage at order-attachments/project-comments/<projectId>/.
• ProjectChat React component: thread, reply, edit, soft-delete, drag-drop file attach, image thumbs + doc cards, guest identity persisted per share token, 20s focused polling.
• Wired into CAD/Casting/Labor admin tabs and share page.
• ShareProjectDialog: comment-mode <select>, badge in link summary.

3D viewer: brighter PBR lighting + richer gold colours (esp. rose)

Volume readout: 1/100,000 cm³ precision across casting panel + metal prices panel

Share page: pause/play 3D rotation + live metal prices keyed to CAD volume

natural aspect ratio + lightbox for non-hero product images

Remove Design Your Ring link from header and footer nav

Welcome gift: 1yr expiry + hidden $500 min + dedicated Brevo list; add 2 strategy docs

• Expiry shortened from 3 years → 1 year. Long enough to feel generous, finite for accounting, and aligned with the planned re-engagement reminder cadence (30/60/330 day pings) in the welcome series plan.
• Enforce a $500 minimum cart subtotal at redemption time, but do NOT surface the rule in the popup copy ('Join our email list, get $100 gift card' stays unchanged). The min is enforced in /api/gift-cards/ redeem with a friendly error: 'This gift card requires a minimum order of $500. Add a few more pieces to your cart, then apply the code at checkout.' Configurable via WELCOME_GIFT_MIN_PURCHASE env.
• Schema: add optional GiftCard.minPurchaseAmount (Decimal). NULL for every existing card so behavior is identical for purchased / manually issued cards. Migration SQL: prisma/add-giftcard-min-purchase.sql (apply via Supabase SQL editor — same pattern as other prisma/add-*.sql files in the repo).
• Checkout page now passes the cart subtotal when redeeming so the validation has cart context.
• Added BREVO_LISTS.WELCOME_GIFT_SIGNUPS — dedicated list for the popup signups. Distinct from NEWSLETTER so we can run a tailored welcome series and measure popup-driven funnel cleanly. Configure the numeric list ID in Brevo dashboard, set BREVO_LIST_WELCOME_GIFT in env.
• Welcome-gift route now pushes signups to BOTH the new dedicated list AND the general Newsletter list — they're a popup signup AND a long- term newsletter contact. Separate lists let us segment cleanly.
• docs/marketing/marketing-section-master-plan.md — full IA plan for consolidating the entire admin marketing surface around the four marketing jobs (Acquire / Engage / Audience / Insight). Includes proposed sidebar, URL migration table, cross-cutting design rules, Overview-page wireframe, and 4-phase implementation plan. Per Ross's instruction this is NOT being built now — it's the canonical target state we'll eventually consolidate toward.
• docs/marketing/welcome-series-plan.md — full strategic plan for the 5-email welcome series triggered by popup signup. Day 0/2/5/12/30 cadence with a wishlist-vs-custom-design branch on Day 12. Includes per-email goal + content brief + engineering hooks, branching/exit rules, MarketingAutomation schema sketch, Brevo integration approach, measurement plan with target benchmarks (≥8% signup→first-purchase at 90d, ≥$200 avg revenue per signup), and an explicit list of things we WON'T do (no extra coupon stacking, no referral asks during welcome, no founder video until post-purchase).

suppress Russia sanctions notice for QR code visitors

• QR scans arrive with ?qr=<slug> in the URL (added by the /api/qr/<slug>
• redirect). Visitors scanning a code at the Russian Deli in South Carolina
• are physically in the USA — showing the Russia/Belarus shipping warning is
• both wrong and off-putting.
• When the qr param is present, auto-dismiss the notice by writing the
• sessionStorage key without ever showing the dialog. The underlying locale
• (ru) and currency (USD, per LOCALE_DEFAULT_CURRENCY) are unaffected, so
• the site still renders in Russian with USD pricing for the session.

trackable branded QR codes with scan analytics

• MarketingQrCode (slug unique, name, destination, utm fields, archivedAt)
• MarketingQrCodeScan (qrCodeId, scannedAt, ip, country, ua, referer)
• SaasTenant relations + idempotent SQL migration prisma/add-marketing-qr-codes.sql
• GET/POST /api/admin/marketing/qr-codes (list with totals/7d/30d, create with auto-slug)
• PATCH/DELETE /api/admin/marketing/qr-codes/:id (rename / change dest / archive / delete)
• GET /api/admin/marketing/qr-codes/:id/analytics?days=N (daily series + countries + recent)
• GET /api/qr/:slug (public — log scan + 302 with utm/qr params)
• Branded QR generator (src/lib/qr/branded-qr.ts) renders 1024×1024 PNG with the Katura KK logo (public/qr-logo.jpeg) on a white rounded plate in the center; uses error-correction H so the logo never breaks scanning.
• QR detail dialog: live PNG preview, Download PNG, inline rename, editable destination, recharts AreaChart over 7/30/90 day window, top countries, recent scan log, archive/restore, hard delete.
• Sub-nav: added 'QR Codes' tab next to Traffic/Orders/Products.

editable specs, stones delete, casting metal selector + library CAD merge, landscape PDF cert, mobile-aware STL zoom

graceful /cad error boundaries + carousel logo tweaks

• Add route-level error.tsx so client-side runtime crashes (most likely WebGL / @react-three/drei HDR fetch / mergeVertices on a non-watertight STL) no longer trigger the full-page global-error 'Something went wrong' screen.
• Add StudioErrorBoundary around MarketingStlViewer and LiveMetalPricesCard so a failure in the heavy 3D studio block degrades to a small inline placeholder while the rest of the marketing page (pipeline stages, automation grid, comparison, CTA) keeps rendering.
• Android: dropped 'lg' size flag → renders at default slot (max-h ~40px, half its prior 80px footprint).
• xAI: scale 0.5 (50% smaller per request).
• Apple Pay: scale 0.75 (25% smaller per request).
• Apple Wallet: removed from carousel entirely.
• Renderer now honors an optional per-logo `scale` multiplier via inline maxHeight, no Tailwind class explosion needed.

remove High Jewelry link from header nav

comprehensive SEO & Google Merchant Center improvements (Apr 28, 2026)

• Add src/lib/merchant-feed/policies.ts: centralized shipping rates (27 countries incl. ZA), return policies (42 countries), handling time, image limits
• Update merchant feeds (/api/merchant-feed) to emit multi-country shipping, return policies, and expanded images (1 primary + 10 additional, Google's max)
• Raise image cap from 5 → 11 per product
• Add docs/integrations/google/STORE_QUALITY_FIX_2026-04-28.md with MC console setup steps
• Fix 8 pages with missing/relative canonicals, hreflang, OG, or Twitter cards:
• /custom-design: add hreflang
• /promise: add hreflang
• /ring-sizer: add hreflang
• /repairs: add hreflang, fix invalid JSON-LD (Service schema)
• /wedding-sites: add canonical, hreflang, OG, Twitter
• /authenticate: improve title/desc, add canonical, hreflang, OG, Twitter
• /journeys/izzy: add canonical, hreflang, Breadcrumb + ItemList schemas
• /returns: no changes (reserved for future MerchantReturnPolicy schema)
• Add +2 transactional page layouts: reset-password, wholesale-login (noindex)
• Create src/lib/seo/noindex.ts helper for consistent noindex metadata

every KATURA_SEO post ships with a real photo and clickable buy link

• New src/lib/blog/product-picker.ts: tag/gemstone/metal/featured-aware scoring; Katura-storefront-only filter; helpers for shop:{slug} tag encoding
• ai-writer auto-attaches product to every new KATURA_SEO draft (try/catch — never blocks persistence) and persists featuredImage/featuredImageAlt
• /blog listing: hero + grid photos clickable to /creations/{slug} with Shop this piece badges and CTAs
• /blog/[slug]: hero photo clickable to product, Shop this piece pill, Pictured caption, end-of-post CTA card
• Internal shop:{slug} tag filtered out of visible tag chips via stripInternalTags()
• Backfill script scripts/blog/backfill-product-links.ts (idempotent; --dry supported) for first/scheduled posts

remove dangling jobUrls reference (broke prerender of /sitemap.xml)

correct policy to 7 days + add Natural vs Lab-grown diamond rules

• Trust bar (site-wide on every storefront page incl. PDPs): 30-Day → 7-Day Returns
• Checkout/PDP trust signals (lib/config.ts): 30-Day → 7-Day Returns
• /promise page: copy, metadata, and 'Promise in numbers' updated to 7 days; clarify lab-grown + custom are final sale
• /faq page (Schema.org FAQ): 30-day answer rewritten to reflect 7-day + diamond carve-outs
• /returns page: new prominent 'Diamond & Gemstone Return Policy' callout — Natural diamonds & gemstones returnable within 7 days; lab-grown diamonds final sale; non-returnable list also explicitly lists lab-grown
• messages/*.json (all 24 locales): updated 2 stale 30-day FAQ answers to match new policy
• src/lib/saas/website-builder.ts (K99 tenant template defaults)
• src/lib/docs-content.tsx (K99 docs example for tenants)
• src/app/[locale]/wholesale/page.tsx (B2B dealer policy — separate from consumer)