# PDT-308 prototypes — Oct 19, 2026

## v2 — after Ben’s Oct 19 feedback (built ~10:45 AM CT)

**Live URL (same Pages project `partner-brand-kit-editor`):** https://partner-brand-kit-editor.pages.dev/ — v2 at root, v1 kept at `/v1/`.
**Deploy status:** ⚠️ v2 is staged in `/tmp/partner-brand-kit-editor/` but **not yet pushed** — the executor shell had no Cloudflare credential (`CLOUDFLARE_API_TOKEN` unset, `wrangler whoami` = not authenticated). Push with:
`cd /tmp/partner-brand-kit-editor && npx -y wrangler@3 pages deploy . --project-name partner-brand-kit-editor --branch main --commit-dirty=true`
Until then the live site still shows v1.
**Source:** `prototypes-v2/` (index.html + app.js, FORM tokens) · **Shots:** `proto-v2-shots/`

### v2 deep links (`/#n`)

| # | Screen | Shows |
|---|---|---|
| 0 | Index | What changed |
| 1 | Email · Body Properties | Nothing selected: Width / Spacing / Canvas Background + **Account Brand Kit** list (every section On/Off, “3 of 8 sections”) |
| 2 | Email · Section Properties | Click a section → Section Properties like today (Customize Columns, Settings, Background/Heading Color, Background Image, Border, Corner Radius, Spacing, Hide on) + **Use account Brand Kit in this section** switch + **Primary color / Secondary color / Keep original** per color |
| 3 | Email · Advanced + locked | Top-bar **Advanced ▾** → **Include locked elements** (global), Show on/off tags on canvas, Reset all sections; locked section explains why it’s off |
| 4 | Landing page | Same pattern (hero background + button) |
| 5 | Custom doc | Same pattern (callout box) |
| 6 | Banner / image | Image-editor chrome; click a layer → Shape/Text/Button/Image Properties with the same switch + Primary/Secondary; photos & logos keep their colors; button = single mapping, no choice shown |
| 7 | Account user · before apply | Brand Kit bar (Primary / Secondary swatches) + **Apply your brand colors** |
| 8 | Account user · first-time choice | “Use your brand colors automatically?” (Oct 12) |
| 9 | Account user · after apply | Recolored allowed sections + Undo toast; locked off section keeps original colors |
| 10 | Account user · later asset auto | LP auto-applied + Undo |
| 11 | Account user · banner applied | Banner recolored |
| 12 | Branding · Portal branding | Today’s Branding (Logo, Primary Colors, Fonts, Buttons, Forms, Main Navigation, Footer) under a **Portal branding** nav group |
| 13 | Branding · Content colors | New **Content branding** group → Colors: Primary color, Secondary color + preview (your content vs an account’s kit) |
| 14 | Branding · Content fonts | Light: Heading font / Body font / Allow account fonts (off) |
| 15 | Fonts (parked) | Light, waiting on Ben |
| 16 | Today’s product | Reference screens incl. local Sep 15 editor prototype |

### What changed vs v1
1. **Section Properties pattern** (click section → properties) on email / LP / custom doc; layers on banner/image.
2. **Global:** top-bar **Allow account Brand Kit** + **Advanced** (Include locked elements, canvas tags, reset). Advanced is always reachable, not buried.
3. **Section by section** on/off is first-class: switch in Section Properties, On/Off list in Body Properties, On/Off tags on the canvas.
4. **Marketing language only:** Primary color / Secondary color / Keep original. No kit field names anywhere in the UI. Single-mapping properties (buttons) show no choice, only a one-line note.
5. **Branding rebuilt** to today’s settings look (left text nav + form column + pink Save). Nav groups: **Portal branding** (existing items) and **Content branding** (New: Colors, Fonts).
6. **Language:** “account” throughout; no “partner”, no AI Campaign Builder abbreviation.
7. **Fonts** left light.
8. Smart-rules note updated: section-level Allow is now in the main UX (see §2 v2 callout).

### Assumptions / gaps (v2)
- Today’s Branding sub-pages beyond Logo were never opened in the Oct 16 walkthrough (and screenshot `59-branding-style-system.png` actually shows API Keys), so Primary Colors / Fonts / Buttons / Forms / Main Navigation / Footer forms are inferred placeholders (“Same as today”).
- Section defaults: painted sections on, neutral off, locked off unless Include locked or the section is turned on by hand.
- Tenant can **Preview as an account** (sample kit Northshore Solar) to see the effect.
- Content branding colors double as what “Primary / Secondary” means in the editor (template painted with them → swapped for the account’s).

---

# v1 (original, ~10:25 AM CT) — kept at `/v1/`

**For:** Product Craft → Ben (skim) · **Deployed:** America/Chicago Mon Oct 19, 2026 ~10:25 AM CT

## Live URL

| | |
|---|---|
| **Primary** | https://partner-brand-kit-editor.pages.dev/v1/ (after v2 push; root before) |
| **Screens** | Hash nav `#0`…`#12` (index opens on `#0`) |
| **Project** | Cloudflare Pages `partner-brand-kit-editor` |
| **Source on box** | `/tmp/partner-brand-kit-editor/` (deploy) · `/workspace/projects/partner-brand-kit-apply/` (canonical) |

Open [https://partner-brand-kit-editor.pages.dev/](https://partner-brand-kit-editor.pages.dev/) — landing is the index of what’s new. Use Prev/Next or the pill nav.

### Deep links

| Screen | URL | Shows |
|---|---|---|
| Index | `/#0` | What’s new |
| B Tenant email | `/#1` | Editor chrome + **Allow account Brand Kit** (smart single) |
| B Landing page | `/#2` | Same Allow, LP canvas |
| B Custom doc | `/#3` | Same flow, custom doc canvas |
| B Partner apply | `/#4` | Northshore kit + **Apply your brand colors** |
| B Auto-apply prompt | `/#5` | Oct 12 first-use modal |
| B After apply | `/#6` | Recolored canvas + Undo; locked stays vendor |
| B Later auto | `/#7` | Auto-apply toast + Undo |
| D Portal vs Content | `/#8` | Branding IA split |
| D Content roles | `/#9` | Named role → kit field table |
| E Banner/image | `/#10` | Image-editor chrome + Apply; gradient/raster gap |
| E Fonts | `/#11` | Email GF-only vs LP/docs; PDT-256 gap |
| A Ref screens | `/#12` | Walkthrough screenshots |

Also on the deploy: `smart-rules-edge-cases-2026-10-19.md`, `prototypes-2026-10-19.md` (this file).

---

## What each deliverable is

### A. Live editor look
- **Live capture:** blocked this run (no browser/Computer MCP tool for the executor).
- **Used instead:** existing screens under `ref-screens/` (copied from design-system + platform-context + ACB walkthrough + logo-badge Figma).
- **Notes:** `ref-screens/README.md`
- Key chrome: email editor left rail + Body Properties; FORM content-editor template; ACB asset editor; image/badge editor for banners; account Brand Kit + Editor Fonts settings.

### B. Editor apply prototype
- Matches email-editor chrome (top bar, left rail, canvas, right properties) with FORM tokens.
- **Main path:** one **Allow account Brand Kit** toggle. Include locked / per-row Allow only under **Advanced (rare)**.
- Surfaces: email · LP · custom docs (separate screens, same controls).
- Partner: Apply + Undo; first-use auto-apply prompt; later-open toast.
- Kit demo: Northshore (`#C2410C` / `#FFEDD5` / …).

### C. Smart rules + edge cases
- File: `smart-rules-edge-cases-2026-10-19.md` (project root + on Pages).
- Covers smart painted/neutral rules, field mapping, one-Allow critique, empty/incomplete kit, locks, gradients, logos, contrast, campaign-wide, account switch, ACB, custom docs vs email, banners, gaps, weak rules to challenge.

### D. Tenant Content Branding
- Screens `#8`–`#9` in the same Pages project (clear hash URLs, not a second project).
- Split **Portal branding** (existing) vs **Content branding** (new named roles).
- V1-if-cheap = colors + 2 font roles; V2 = full tokens / logos / gradients.

### E. Banner / fonts
- `#10` banner/image editor Apply idea + honest raster/gradient gap.
- `#11` fonts pass: email Google Fonts only (Anjani) vs LP/custom docs; PDT-256 cut called out.

---

## File paths (box)

```
/workspace/projects/partner-brand-kit-apply/
  PROJECT.md
  smart-rules-edge-cases-2026-10-19.md          ← C
  prototypes-2026-10-19.md                      ← this report
  ref-screens/README.md                         ← A
  ref-screens/*.png
  prototypes/index.html                         ← copy of deploy index
  imports/hq-partner-brand-in-editor/           ← Sep 15 prior art
  breadboard-2026-10-19.md / screen-wireframe-…
/tmp/partner-brand-kit-editor/                  ← Pages deploy root
```

---

## What we might be missing (from C)

1. Microsoft **Color Controls** acceptance still undefined.
2. **Include locked** buried too deep for PS/Microsoft locked templates — keep advanced visible to tenant admins.
3. **Neutral heuristic** without a published list will surprise PS.
4. **Fonts in V1** vs email Outlook constraint vs PDT-256 cut — scope to LP/custom docs or cut.
5. Auto-apply **respect locks?** (recommend yes) and **where to change** remembered choice.
6. Campaign-wide apply ≠ remembered auto-apply (Brian Dudley still unanswered).
7. ACB preview prompt + unchangeable campaigns.
8. Empty/incomplete kit UX; kit refresh snapshot vs re-apply; SA-11571 scrape fix.
9. Gradients, SVG icons, logo contrast — out / separate.
10. Custom docs **in** (Oct 19 brainstorm) vs PROJECT.md **out** — confirm before PRD.

---

## Blockers

| Blocker | Impact |
|---|---|
| No browser MCP / Computer tool | Could not live-capture email/LP/custom doc editors; used walkthrough screens |
| FORM tokens | Available locally (`form-tokens.css`); inlined in deploy — **not** a blocker |
| Cloudflare | Deployed successfully as `partner-brand-kit-editor` |
| Login / Exit Impersonation | Not used this run (no live session driven) |

**Do not message Ben from this executor** — report back to Product Craft only.