feat(drive-integration): add entry wizard for new entry design updates [INTEG-4136] by FBanfi · Pull Request #11027 · contentful/apps

Franco Banfi (FBanfi) · 2026-06-17T15:07:14Z

Purpose

Implements the "Add entry" wizard in the edit content modal as part of the new entry design updates. Users can now create a new entry directly from the mapping review screen, optionally wiring it as a reference to an existing entry.

Approach

A 4-step (up to 5-step) semi-wizard is rendered inside the existing EditModal using the existing Modal.Controls buttons for navigation — no new internal buttons:

Select content type — pick the type for the new entry
Is it a reference? — yes/no radio
Select the referenced entry (child) — dropdown of existing entries
Which field holds the reference? — only shown when the content type has more than one Link/Entry or Array/Entry field; auto-skipped otherwise
Select fields — map document content to fields on the new entry (reuses FieldSelectionDropdown)

Key implementation details:

WizardStep is an enum; handleWizardNext/Back use switch statements
referenceGraph is lifted into useState in ReviewPage (same pattern as entryBlockGraph) so new reference edges can be appended client-side
On save, { __ref: childTempId } is written into the new entry's reference field — the backend merges mappingEntry.fields verbatim in step 10, and entryService.ts resolves __ref values in pass 2
isEntryReferenceField and buildFieldOptionsForContentType extracted to fieldFormatting.ts to avoid duplication

Testing steps

Automated tests added for the wizzard.

Grabacion.de.pantalla.2026-06-17.a.la.s.12.13.13.p.m.mov

Breaking Changes

No.

Dependencies and/or References

Link to INTEG-4136

🤖 Co-authored with Claude Code

…G-4136] Wires up the "Add entry" button in the EditModal with a 4-step semi-wizard: select content type → is-reference → select reference entry → select fields. On save, appends a new EntryBlockGraphEntry and applies field assignments. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

… [INTEG-4136] Remove wizard-internal buttons. Wizard step state is lifted into EditModal so Modal.Controls drives Back/Next/Save, and the X button cancels as usual. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

… [INTEG-4136] Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

… fidelity [INTEG-4136] referenceGraph now lives in useState in ReviewPage (same pattern as entryBlockGraph). handleAddEntry appends a reference edge when the wizard's isReference + referenceEntryId are set, so the graph reflects the new relationship immediately without a full workflow re-run. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…on [INTEG-4136] Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…to fieldFormatting [INTEG-4136] Removes duplicated field-option mapping logic shared between getNewLocationForEntry and buildNewLocationForContentType. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…n add [INTEG-4136] Auto-picks the first Link/Entry or Array/Entry field on the content type and writes { __ref: referenceEntryId } into newEntry.fields so entryService pass 2 resolves it to a real Contentful link on create. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…, selected entry is parent Parent entry now holds { __ref: newTempId } in its first Link/Entry field. Reference graph edge is from parent → new child, matching Contentful's data model. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…is child, selected entry is parent" This reverts commit baf8b1f.

…try wizard New step 4 (SelectReferenceField) appears between SelectReference and SelectFields when the chosen content type has more than one Link/Entry or Array/Entry field. Auto-skipped for content types with a single reference field — falls back to auto-picking the first one. User-selected field id is passed through to handleAddEntry. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…to fieldFormatting Replaces inline Link/Entry + Array/Entry checks in MappingView and EditModal with a named predicate, consistent with the existing isAssetFieldForImageAssign pattern. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Resolve the field object once instead of storing the id and re-scanning fields to check its type. Removes the redundant inner refFieldId check. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…mage targets in handleAddEntry - Pass live `referenceGraph` state as a prop to MappingView so appended edges are read from current state rather than the original payload snapshot, preventing edge loss when adding multiple reference entries in one session - Remove duplicate assetTargets/rtTargets variables in the image content branch — reuse the already-computed richTextTargets/nonRichTextTargets Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

JuliRossi · 2026-06-18T18:26:55Z

+  contentType: WorkflowContentType | undefined
+): EditModalFieldOption[] {
+  return (contentType?.fields ?? []).filter(isWorkflowContentTypeFieldWithId).map((field) => {
+    const fieldType = typeof field.type === 'string' ? field.type : 'Text';


⛏️ I think we should not need to check this

Good point! A field without a type is malformed and shouldn't be processed. Instead of falling back to Text, we now skip it entirely. Added a hasFieldType guard in fieldFormatting.ts and reused it in the two spots in MappingView.tsx as well.

JuliRossi · 2026-06-18T18:57:25Z

💡 I think this file is too large. We should probably refactor it a bit

Leaving this for another PR

…AddEntryWizard

…to hasFieldId

…mpId

… f inline check

…RichText targets

… and nonRichText targets" This reverts commit 5ca0fd9.

…andleAddEntry

…edReference guard

…edge fieldId

…g to Text Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

… resolution Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…_STEPS descriptor map Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

… EditModal Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…d-v2

…ntryWizard.tsx

Franco Banfi (FBanfi) and others added 13 commits June 17, 2026 12:02

fix(drive-integration): stretch left column border to full row height…

2cdf193

… [INTEG-4136] Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

refactor(drive-integration): wizard step as enum, switch for navigati…

6b69358

…on [INTEG-4136] Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

refactor(drive-integration): extract buildFieldOptionsForContentType …

bae31ff

…to fieldFormatting [INTEG-4136] Removes duplicated field-option mapping logic shared between getNewLocationForEntry and buildNewLocationForContentType. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Revert "fix(drive-integration): flip reference direction — new entry …

e7f0411

…is child, selected entry is parent" This reverts commit baf8b1f.

refactor(drive-integration): simplify refField lookup in handleAddEntry

db4ada2

Resolve the field object once instead of storing the id and re-scanning fields to check its type. Removes the redundant inner refFieldId check. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

chore(drive-integration): prettier format touched files

385217e

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Franco Banfi (FBanfi) requested review from a team as code owners June 17, 2026 15:07

Franco Banfi (FBanfi) and others added 4 commits June 17, 2026 12:29

test(drive-integration): add AddEntryWizard step-by-step tests

ec5da86

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

chore(drive-integration): formating with prettier

ba3c770

fix(drive-integration): update SelectReferenceField label copy

bd3b25d

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

JuliRossi reviewed Jun 18, 2026

View reviewed changes

Comment thread apps/drive-integration/src/locations/Page/components/review/mapping/MappingView.tsx Outdated

Franco Banfi (FBanfi) added 8 commits June 18, 2026 17:30

refactor(drive-integration): use switch for wizard step rendering in …

d7802b0

…AddEntryWizard

refactor(drive-integration): rename WizardState interface to Wizard

c88bf3d

refactor(drive-integration): rename isWorkflowContentTypeFieldWithId …

847e09b

…to hasFieldId

refactor(drive-integration): use crypto.randomUUID() for new entry te…

21de030

…mpId

refactor(drive-integration): use hasFieldId helper instead of 'id' in…

3abf9ba

… f inline check

refactor(drive-integration): use reduce to partition richText and non…

5ca0fd9

…RichText targets

Revert "refactor(drive-integration): use reduce to partition richText…

db3f3f3

… and nonRichText targets" This reverts commit 5ca0fd9.

refactor(drive-integration): extract isLinkedReference condition in h…

00effe2

…andleAddEntry

Franco Banfi (FBanfi) and others added 7 commits June 18, 2026 18:26

fix(drive-integration): non-null assert referenceEntryId after isLink…

e17b278

…edReference guard

fix(drive-integration): use resolved refField.id for reference graph …

a0d94cf

…edge fieldId

fix(drive-integration): skip fields with no type instead of defaultin…

7e058a1

…g to Text Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

fix(drive-integration): add hasFieldType guard and reuse across field…

398e458

… resolution Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

refactor(drive-integration): replace wizard switch blocks with WIZARD…

bfd50fb

…_STEPS descriptor map Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

refactor(drive-integration): move buildNewLocationForContentType into…

3a7bd5d

… EditModal Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Merge branch 'drive-integration-v1.1' into integ-4136-add-entry-wizar…

2d66867

…d-v2

JuliRossi approved these changes Jun 19, 2026

View reviewed changes

refactor(drive-integration): moving thigs from wizardSteps.ts to AddE…

5de0672

…ntryWizard.tsx

Franco Banfi (FBanfi) merged commit 0eb3b06 into drive-integration-v1.1 Jun 19, 2026
11 checks passed

Franco Banfi (FBanfi) deleted the integ-4136-add-entry-wizard-v2 branch June 19, 2026 14:55

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(drive-integration): add entry wizard for new entry design updates [INTEG-4136]#11027

feat(drive-integration): add entry wizard for new entry design updates [INTEG-4136]#11027
Franco Banfi (FBanfi) merged 33 commits into
drive-integration-v1.1from
integ-4136-add-entry-wizard-v2

Franco Banfi (FBanfi) commented Jun 17, 2026 •

edited

Loading

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JuliRossi Jun 18, 2026

Uh oh!

Franco Banfi (FBanfi) Jun 19, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JuliRossi Jun 18, 2026

Uh oh!

Franco Banfi (FBanfi) Jun 19, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Franco Banfi (FBanfi) commented Jun 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose

Approach

Testing steps

Breaking Changes

Dependencies and/or References

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JuliRossi Jun 18, 2026

Choose a reason for hiding this comment

Uh oh!

Franco Banfi (FBanfi) Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

JuliRossi Jun 18, 2026

Choose a reason for hiding this comment

Uh oh!

Franco Banfi (FBanfi) Jun 19, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Franco Banfi (FBanfi) commented Jun 17, 2026 •

edited

Loading