1002 – Xyppy Print This Prototype

Goals

• Prove a polished image → recommendations → configuration → price → demo-summary interaction in ChatGPT.
• Keep the implementation small enough to become usable in Developer Mode within three days.

Scope

In Scope

• Current-chat file input when available, ChatGPT Library selection, and local upload fallback.
• Size, paper, frame, mat, layout, quantity, image-quality guidance, static prototype pricing, and demo summary.
• Local, MCP, browser, and Developer Mode verification.

Out of Scope

• Real checkout, orders, payment, production files, fulfillment, accounts, deployment, and public submission.
• Manual crop positioning, RPS recommendations, wall mockups, and gallery walls.

Success Criteria

• /mcp advertises one safe read-only configure_print tool and the widget resource.
• The React widget works standalone and in ChatGPT Developer Mode.
• Image dimensions drive DPI, crop warnings, and three recommended sizes.
• Continue reaches an honest demo summary and cannot create an order.
• Typecheck, tests, build, docs verification, runtime checks, and visual critique pass.

Supporting Docs And Evidence

• Durable evidence: DOCS/evidence/active/1002/
• Upstream example commit: 18cc38e78a968712c357bacdc3c79fead5bfc6b4
• Official docs: https://developers.openai.com/plugins/build/chatgpt-ui/

Visual/UX Quality Gate

• Critique verdict: pass for prototype
• Evidence paths: DOCS/evidence/active/1002/visual-design/
• Must-fix issues: dark contrast, low-resolution ranking, mobile overflow, CSS placeholder art, and external font dependency were fixed
• Approved deviations: mock pricing, representative frame preview, and preset crop behavior
• Follow-up verification: desktop, configured-image, summary, and 390 px mobile screenshots reviewed with zero browser warnings/errors

Milestones

• Repository and Context Layer baseline.
• MCP server and React widget.
• Image intelligence and prototype pricing.
• Validation, tunnel, and Developer Mode walkthrough.

Checkpoint Log

Checkpoint 01 - 2026-08-12 04:39 ET (America/New_York)

Completed Since Prior Checkpoint

• Initialized the private-project repository locally.
• Installed the required Context Layer baseline with all optional modules disabled.
• Created the first MCP server, shared print logic, and React configurator implementation.

Next Checkpoint Targets

• Install dependencies and resolve compile/test findings.
• Perform local runtime and visual validation.
• Publish the private GitHub repository and validate a public HTTPS MCP URL.

Notes

• Static prices are explicitly labeled prototype estimates.
• No live Xyppy or Shopify credentials are required.

Checkpoint 02 - 2026-08-12 04:56 ET (America/New_York)

Completed Since Prior Checkpoint

• Completed the React configurator, deterministic pricing, image inspection, DPI/crop guidance, recommendations, state persistence, and safe demo summary.
• Passed typecheck, component and logic tests, production build, docs checks, health check, and an MCP client contract test.
• Completed rendered desktop and mobile critique; fixed contrast, low-resolution ranking, mobile overflow, and self-contained asset/font issues.

Next Checkpoint Targets

• Create and push the private GitHub repository.
• Establish a temporary HTTPS tunnel and connect the MCP server in ChatGPT Developer Mode.

Notes

• The named Context Layer visual critique skill was unavailable; Product Design audit plus rendered screenshots were used as the documented fallback.

Checkpoint 03 - 2026-08-14 10:00 ET (America/New_York)

Completed Since Prior Checkpoint

• Enabled ChatGPT Developer Mode on the signed-in account with explicit approval.
• Added the temporary Xyppy MCP endpoint as a personal plugin using No Auth.
• Confirmed ChatGPT discovered configure_print and rendered the custom configurator iframe inside a live chat.
• Captured platform evidence at DOCS/evidence/active/1002/platform/chatgpt-widget-rendered.jpg.

Next Checkpoint Targets

• Review the in-chat prototype behavior and decide whether to keep the one-tool v0 shape or split into inspect/options/render/checkout tools.
• Replace the temporary Cloudflare quick tunnel with durable hosting before any broader demo or production handoff.

Notes

• The validated endpoint was https://miniature-surgery-dose-directly.trycloudflare.com/mcp.
• The tunnel is temporary development infrastructure and has no uptime guarantee.

Risks

• ChatGPT file helpers must be feature-detected and may not be available to every user.
• Temporary tunnel setup remains development infrastructure, not hosting proof.

MAGGIE TODO

• None. Developer Mode setup and the in-ChatGPT widget walkthrough passed.