beehiiv Publisher Creative Orchestration Prototype

A high-fidelity, publisher-facing frontend prototype for reviewing and inserting Ad Network creative:

• beehiiv recommends an approved strategic concept.
• The advertiser protects the product, offer, claims, CTA, destination, tracking, legal language, and strategic concept.
• The publisher shapes the headline and body through structured tone, sentence-structure, energy, and audience controls.

The prototype uses local fixtures and deterministic behavior. It contains no authentication, database, production recommendation infrastructure, or live AI calls.

Run locally

Requires Node.js 22.13 or newer.

npm install
npm run dev

Useful checks:

npm test
npm run build

Routes

• / — Publisher Ad Network Offers experience with the Attio offer as the entry point.
• /publisher — Two-column creative-selection modal over the current Offers experience.
• /editor — Simplified post editor with the confirmed sponsored placement.

The hidden developer scenarios utility can be opened from the faint gear or with Alt+Shift+S. State is saved to localStorage, and the selected scenario is mirrored in the URL.

Scenarios

The presets cover early and downstream recommendations, learning and unavailable states, Primary and Secondary placements, advertiser and tone-matched copy, successful validation, a simulated blocked generation, and editor insertion.

Recommendation outcomes and plain-language explanations are mocked as scenario fixtures. The recommendation mechanics remain behind the scenes and are not configurable from the interface.

Architecture

• app/ — Route entry points and shared visual system.
• components/ — Publisher selection, preview, validation, editor, and tester controls.
• data/ — Typed offer, concept, scenario, and copy fixtures.
• lib/publisher-validation.ts — Generated-output limits and unsupported-claim validation.
• tests/publisher-prototype.test.ts — Deterministic copy and validation coverage.

PrototypeProvider derives protected copy from structured publisher controls and manages validation, editor insertion, URL presets, and local persistence.

Intentionally mocked

• Offer and advertiser records
• Recommendation state and explanation
• Tone-matched copy generation
• Claim and copy-limit validation
• Preview, confirmation, save, remove, and insertion behavior