← All stories

BRANCH · ef-028-canvas-templates

Canvas templates and team templates

EF-028Persona: OrganizerRoots in: event-setupMatrix: ShippableEF reference: EventFarm doc

The organizer starts a Canvas page from a catalog template or team-owned template. The page receives a copied block tree and token context; later edits to the template do not rewrite pages already created from it.

Preconditions

The organizer is authenticated in the event-setup trunk, has edit access to a fixture event, and the event has a Canvas draft page with at least one root block.

Happy path

  1. Open the Canvas editor from Event Setup.

    The editor loads the draft page, root block sequence, autosave state, and preview pane.

  2. Compose, preview, and publish.

    The organizer edits the capability surface for Canvas templates and team templates, previews desktop and mobile, then confirms publish or schedule.

  3. Verify public version semantics.

    Publish creates a versioned snapshot; scheduled publish leaves the prior public version intact until its activation time.

Failure modes

Every Canvas branch includes the cluster E rubric: undo/redo, paste-from-other-page, asset isolation, missing-token fallback, preview parity, scheduled publish, autosave recovery, and two-editor conflict. Capability-specific probes bring each story to 10-12 failure modes.

Undo/redo correctness across block ops

Trigger: the organizer inserts a block, deletes another, reorders the root block sequence, and edits one block property before using undo twice.

Resolution: each block operation creates exactly one undo entry; multi-step undo restores the prior root block sequence and block props exactly, then redo reapplies the same sequence without duplicating blocks.

Paste from other page

Trigger: the organizer copies a block from page A and pastes into page B, then tries the same paste from a different event.

Resolution: page-local references are remapped to the destination slug and asset URLs; cross-event paste opens an explicit confirmation before any draft mutation happens.

Asset upload failure isolated

Trigger: three assets upload while one fails with a transient R2 or connector error.

Resolution: the two successful uploads continue and bind to their blocks; the failed asset renders inline with retry and the page draft JSON remains valid.

Dynamic token rendering missing data

Trigger: preview resolves {guest.firstName} for a contact with no first name and {event.location} before location is configured.

Resolution: missing values fall back to "Guest" or configured fallback copy; no rendered sentence contains an empty merge or doubled punctuation.

Mobile preview vs published

Trigger: organizer previews at 375x667 and publishes the same draft.

Resolution: the public page matches mobile preview within layout-shift and viewport tolerances; differences surface as preview warnings before publish.

Scheduled publish vs immediate

Trigger: organizer schedules a draft for a future time instead of publishing immediately.

Resolution: before the scheduled time, the public URL serves the previous active version or 404 for first publish; at the scheduled time the new draft becomes live atomically.

Autosave recovery

Trigger: browser refreshes or crashes after an edit but before manual save.

Resolution: latest autosave is offered in a recovery banner with restore/discard; restore is the default and rehydrates the exact block tree.

Two-editor conflict resolution

Trigger: two organizers edit the same page; one publishes while the other saves a stale draft.

Resolution: the second organizer sees a conflict modal listing changed blocks and can merge or accept last-write-with-warning; both sessions converge to a deterministic state.

Template catalog pagination preserves scope

Trigger: organizer pages through built-in and team templates with search active.

Resolution: filters, page number, and selected template scope stay stable through pagination and never leak templates from another team.

Template modified after use does not propagate

Trigger: a team owner changes a template after an event page was created from it.

Resolution: existing pages keep their copied block tree; only newly-created pages receive the changed template.

Stable test attributes

Visibility teeth. Each attribute must be effectively visible when active and must match the agent probes.

data-testWherePurpose
canvas-canvas-templates-editorCanvas editorMain organizer-side Canvas editor surface
canvas-canvas-templates-stepperCanvas editorCreate/edit/preview/publish lifecycle indicator
canvas-canvas-templates-block-treeCanvas editorRoot block sequence and selected block tree
canvas-canvas-templates-previewCanvas editorPreview pane for desktop and mobile layouts
canvas-canvas-templates-publish-ctaCanvas editorPublish or schedule publish action
canvas-canvas-templates-publish-confirmationCanvas editorConfirmation dialog for publish or risky action
canvas-canvas-templates-autosave-bannerCanvas editorAutosave recovery and restore/discard banner
canvas-canvas-templates-conflict-modalCanvas editorTwo-editor conflict resolution modal
canvas-canvas-templates-upload-rowCanvas editorPer-asset upload progress/failure row
canvas-canvas-templates-token-warningCanvas editorDynamic token validation or fallback warning
canvas-canvas-templates-gap-panelCanvas editorVisible parity gap panel when matrix is absent or partial
canvas-canvas-templates-mobile-preview-warningCanvas editorPreview discrepancy warning for mobile vs published
canvas-canvas-templates-template-tableCanvas editorPaginated template catalog
canvas-canvas-templates-permissions-matrixCanvas editorTeam template permission scope

Agent test plan

Inherits event-setup trunk preconditions. Component contract chaining applies through usesComponents.

- open-canvas-surface
- edit-preview-publish-flow
- published-version-recorded
- undo-redo-block-ops
- paste-cross-page
- asset-upload-isolated
- dynamic-token-fallback
- mobile-preview-published-match
- scheduled-vs-immediate-publish
- autosave-recovery
- two-editor-conflict
- template-pagination-scope
- template-edits-do-not-propagate
- evaluate-canvas-editor