Agentic UI: Create blank or Blueprint sites by bcotrim · Pull Request #4177 · Automattic/studio

bcotrim · 2026-07-10T22:07:50Z

Related issues

First product increment from Agentic UI: Site Creation #3941

How AI was used in this PR

Codex helped compare the original umbrella PR with current trunk, implement the scoped first increment, and add focused coverage. The resulting behavior, cleanup paths, and tests were manually reviewed. The updated visual design still needs human review in both color schemes.

Proposed Changes

Give users one Create flow for blank sites and uploaded JSON or ZIP Blueprints, including full-window drop, replacement, removal, reset of prior untouched suggestions, and Blueprint deep-link handoff.
Preserve user-entered values while applying Blueprint suggestions only to pristine fields, and retain the existing path and WordPress-version reliability behavior.
Keep temporary uploads safe across selection, replacement, cancellation, creation, and failure recovery.
Make creation progress accessible, prevent route interaction and closing while creation is active, restore the flow after failure, and manage focus between onboarding routes.
Simplify onboarding around the currently working Create and Import jobs, redirect the legacy Blueprint route into Create, and remove the unused gallery surface.
Bring the updated onboarding design into the reduced flow with the animated dot-grid backdrop, illustrated job cards, frosted panels, responsive layouts, persistent footer actions, and compact Blueprint picker.

Testing Instructions

Open onboarding and confirm the home screen shows the dot-grid backdrop, illustrated Create and Import cards, and persistent Back action when existing sites are present. Start Create and create a blank site.
Select JSON and ZIP Blueprints using the inline picker and full-window drop target. Confirm the selected file can be replaced or removed and that ZIP-relative assets still resolve during creation.
Edit the site name or path before selecting a Blueprint. Confirm suggestions fill pristine fields without overwriting dirty fields.
Open a Blueprint deep link and confirm it hands the uploaded Blueprint to /onboarding/create.
During creation, confirm the visible status is announced, route content is inert, Close is disabled, and route headings receive focus. Force a failure and confirm the form recovers.
Confirm uploaded and extracted temporary files are cleaned after invalid uploads, stale selections, replacement, removal, success, and failure.
Check the Create flow, selected Blueprint state, drop overlay, advanced settings, and progress state in both light and dark color schemes.

Pre-merge Checklist

Have you checked for TypeScript, React or other console errors?

…creation # Conflicts: # apps/studio/src/tests/ipc-handlers.test.ts # apps/ui/src/components/sidebar-header/index.tsx

wpmobilebot · 2026-07-13T20:03:01Z

📊 Performance Test Results

Comparing 3cea8eb vs trunk

app-size

Metric	trunk	`3cea8eb`	Diff	Change
App Size (Mac)	1353.04 MB	1354.35 MB	+1.30 MB	🔴 0.1%

site-editor

Metric	trunk	`3cea8eb`	Diff	Change
load	1086 ms	1090 ms	+4 ms	⚪ 0.0%

site-startup

Metric	trunk	`3cea8eb`	Diff	Change
siteCreation	7017 ms	6992 ms	25 ms	⚪ 0.0%
siteStartup	2353 ms	2358 ms	+5 ms	⚪ 0.0%

Results are median values from multiple test runs.

Legend: 🟢 Improvement (faster) | 🔴 Regression (slower) | ⚪ No change (<50ms diff)

katinthehatsite · 2026-07-14T09:04:49Z

+		return {
+			...base,
+			error: __(
+				'The directory is already associated with another Studio site. Please choose a different site name or a custom local path.'


I don't know if it is intentional but just noting that the error does not have a strong visibility so it might not be easy for the user to distinguish it:

katinthehatsite · 2026-07-14T09:06:41Z

+	const field: Field< T > = {
 		id: 'wpVersion',
 		type: 'text',
 		label: __( 'WordPress version' ),


When you expand this field to choose a different option from the dropdown, the PHP version field that is located nearby jumps down a bit:

Once you close the dropdown, it jumps back

katinthehatsite · 2026-07-14T09:07:56Z

 		type: 'text',
 		label: __( 'WordPress version' ),
 		placeholder,
 	};


Also, as a sidenote, the design of these field is different e.g. we can see it when looking at the scrollbar:

katinthehatsite · 2026-07-14T09:10:41Z

+			adminPassword: 'first-password',
+			adminEmail: 'first@example.com',
+		} );
+		fireEvent.change( screen.getByLabelText( /Admin username/ ), {


it is not a comment for this specific line, but just noting that in the original create-site form, when there is an error related to admin username field e.g. it is empty, the neighbouring Admin password field jumps down:

Additionally, this error looks different from the Local path error:

It would be nice if we can ensure consistency in this case

katinthehatsite · 2026-07-14T09:15:17Z

+	return (
+		<>
+			<h1>{ page }</h1>
+			<button type="button" onClick={ () => setProgress( 'Creating site…' ) }>


This button seems to visually overlap with whatever is on top of the create site screen, sometimes with the site title which I think does not look great:

Perhaps it could either replace the content on the screen or push it down if the button sticks to the top or we could find some sort of alternative approach

katinthehatsite · 2026-07-14T09:20:00Z

+	}
+
+	if ( ! isZip ) {
+		throw new Error( __( 'Please select a Blueprint JSON or ZIP bundle.' ) );


Perhaps we could make this error a bit clearer e.g. The provided file is not valid. Please select a Blueprint JSON or ZIP bundle.

Because if the user drops the file that is not valid, then see this error but the button to Create site is still enabled, they might assume that the blueprint file was used. Additionally, we could consider making the error more prominent

katinthehatsite · 2026-07-14T09:22:36Z

+		return {
+			...base,
+			error: __(
+				'This directory is not empty. Please select an empty directory or an existing WordPress folder.'


These two descriptions / errors are centered differently:

Perhaps we could also ensure consistency for that case.

katinthehatsite

The flow to create a site either with or without blueprints worked for me and I did not encounter issues there 👍

I had some UI inconsistencies which I noted down in the comments so once these are addressed, I think this will be in a good shape for merging.

One thing to note is that we also don't have blueprints gallery in this PR: not sure if it was intentional or not so just leaving it here as an observation.

bcotrim · 2026-07-14T16:15:46Z

The flow to create a site either with or without blueprints worked for me and I did not encounter issues there 👍

I had some UI inconsistencies which I noted down in the comments so once these are addressed, I think this will be in a good shape for merging.

Thanks for the thorough testing, I've addressed the issues. Could you take another look please? 🙇

One thing to note is that we also don't have blueprints gallery in this PR: not sure if it was intentional or not so just leaving it here as an observation.

The blueprint gallery was removed based on the latest exploration pfHvTO-1wR-p2 and the Design Preview PR: #3975

katinthehatsite

thanks for addressing the feedback 👍

I tested everything thoroughly again and I think this is good to go 👍

The error and the form is much more consistent:

I would maybe think more about improving Creating site progress screen but it does not need to be handled in this PR and can be explored separately

Harden agentic site creation

dec3636

bcotrim self-assigned this Jul 10, 2026

Unify blank and Blueprint site creation

582092e

bcotrim added the Proof of Concept label Jul 13, 2026

bcotrim changed the title ~~Harden agentic site creation~~ Jul 13, 2026

github-advanced-security AI found potential problems Jul 13, 2026

View reviewed changes

Comment thread apps/local/src/index.ts Fixed

Secure Blueprint ZIP uploads

66ee2df

bcotrim changed the title ~~Unify blank and Blueprint site creation~~ Jul 13, 2026

bcotrim added 9 commits July 13, 2026 10:48

Update agentic onboarding design

e2d1843

Match Blueprint picker design

99016d2

Show validation errors for Blueprint values

b4373ba

Reset replaced Blueprint suggestions

21f9445

Share site creation validation logic

1da6b70

Simplify site creation implementation

ba743d2

Polish site creation entry points

1802d86

Merge remote-tracking branch 'origin/trunk' into harden-agentic-site-…

51e125a

…creation # Conflicts: # apps/studio/src/tests/ipc-handlers.test.ts # apps/ui/src/components/sidebar-header/index.tsx

Harden Blueprint replacement and form initialization

a37b7ca

bcotrim marked this pull request as ready for review July 13, 2026 19:33

bcotrim removed the Proof of Concept label Jul 13, 2026

bcotrim requested review from a team and katinthehatsite July 13, 2026 19:34

Limit onboarding review to site creation

cf17d0c

katinthehatsite reviewed Jul 14, 2026

View reviewed changes

bcotrim added 2 commits July 14, 2026 15:44

Improve site creation validation feedback

6ba66fb

Merge trunk into site creation branch

b00c22c

bcotrim requested a review from katinthehatsite July 14, 2026 16:22

This was referenced Jul 15, 2026

Agentic UI: Fix Linux/Windows window controls #4166

Merged

Agentic UI: Make the sidebar site-centric #4191

Merged

bcotrim added 2 commits July 16, 2026 10:19

Merge trunk into site creation branch

89bdd13

Merge trunk into site creation branch

a3d3832

bcotrim mentioned this pull request Jul 17, 2026

Agentic UI: Bring back the dark app frame around the content area #4233

Merged

1 task

katinthehatsite approved these changes Jul 17, 2026

View reviewed changes

bcotrim enabled auto-merge (squash) July 17, 2026 10:51

Merge branch 'trunk' into harden-agentic-site-creation

3cea8eb

bcotrim merged commit e8933b2 into trunk Jul 17, 2026
13 checks passed

bcotrim deleted the harden-agentic-site-creation branch July 17, 2026 11:33

bcotrim mentioned this pull request Jul 30, 2026

Agentic UI: Site Creation #3941

Closed

7 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Agentic UI: Create blank or Blueprint sites - #4177

Agentic UI: Create blank or Blueprint sites#4177
bcotrim merged 18 commits into
trunkfrom
harden-agentic-site-creation

bcotrim commented Jul 10, 2026 •

edited

Loading

Uh oh!

wpmobilebot commented Jul 13, 2026 •

edited

Loading

katinthehatsite Jul 14, 2026

katinthehatsite Jul 14, 2026

katinthehatsite Jul 14, 2026

katinthehatsite Jul 14, 2026

katinthehatsite Jul 14, 2026

katinthehatsite Jul 14, 2026

katinthehatsite Jul 14, 2026

katinthehatsite left a comment

bcotrim commented Jul 14, 2026

katinthehatsite left a comment

Uh oh!

Labels

4 participants

Uh oh!

Conversation

bcotrim commented Jul 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related issues

How AI was used in this PR

Proposed Changes

Testing Instructions

Pre-merge Checklist

Uh oh!

wpmobilebot commented Jul 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📊 Performance Test Results

app-size

site-editor

site-startup

katinthehatsite Jul 14, 2026

Choose a reason for hiding this comment

katinthehatsite Jul 14, 2026

Choose a reason for hiding this comment

katinthehatsite Jul 14, 2026

Choose a reason for hiding this comment

katinthehatsite Jul 14, 2026

Choose a reason for hiding this comment

katinthehatsite Jul 14, 2026

Choose a reason for hiding this comment

katinthehatsite Jul 14, 2026

Choose a reason for hiding this comment

katinthehatsite Jul 14, 2026

Choose a reason for hiding this comment

katinthehatsite left a comment

Choose a reason for hiding this comment

bcotrim commented Jul 14, 2026

katinthehatsite left a comment

Choose a reason for hiding this comment

Uh oh!

Labels

4 participants

bcotrim commented Jul 10, 2026 •

edited

Loading

wpmobilebot commented Jul 13, 2026 •

edited

Loading