Add Beta Features menu #1860

wojtekn · 2025-10-08T14:27:19Z

Related issues

Fixes STU-855

Proposed Changes

Added "Beta Features" menu to the app menu (available for all users, not just dev builds)
Beta features are disabled by default and saved in appdata-v1.json for cross-app/CLI access
Exposed "Studio Sites CLI" as the first beta feature
Updated CLI to check betaFeatures.studioSitesCli from appdata instead of ENABLE_CLI_V2 environment variable
Added "(Beta)" label to studio site command when the beta feature is enabled

Windows	macOS

Testing Instructions

Testing the Beta Features Menu

Launch the Studio app
Open the app menu (Studio menu on macOS, or File menu on other platforms)
Find and click the "Beta Features" menu item
You should see the "Studio Sites CLI" checkbox (unchecked by default)

Testing CLI Integration

Build the CLI: npm run make
Run CLI without beta feature: node dist/cli/main.js --help
- Verify site command is NOT listed
Enable beta feature in Studio app: Check "Beta Features → Studio Sites CLI"
Run CLI again: node dist/cli/main.js --help
- Verify site Manage local sites (Beta) command is now listed
Test the command: node dist/cli/main.js site list
- Should work if the beta feature is enabled

Verify Persistence

Enable "Studio Sites CLI" in the app
Quit and restart Studio
Open Beta Features menu - checkbox should remain checked
Check ~/Library/Application Support/Studio/appdata-v1.json (macOS) or equivalent
- Should contain: "betaFeatures": { "studioSitesCli": true }

Pre-merge Checklist

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

bcotrim

Works as described and a nice addition in my opinion!
LGTM 👍

wojtekn · 2025-10-09T06:16:52Z

@bcotrim Thank you for your review. Your Feature Flags menu implementation paved the way. 🥳

katinthehatsite

Functionally, this works for me and I did not run into any issues 👍

I had one suggestion about the naming: to me, as a user with little context, it was not really clear what Studio Sites CLI did, especially since there was also Install CLI... command that was in the top menu. Perhaps we could improve the naming there

wojtekn · 2025-10-09T09:06:15Z

@katinthehatsite, do you see any short name we could use instead of the current one to make it more descriptive?

Alternatively, we could use the menu description. It looks like that on macOS:

I'm unsure how it works on Windows, though.

github-actions · 2025-10-09T11:53:06Z

📊 Performance Test Results

Comparing 7efcaac vs trunk

site-editor

Metric	trunk	`7efcaac`	Diff	Change
load	11347.50 ms	10462.00 ms	-885.50 ms	🟢 -7.8%

site-startup

Metric	trunk	`7efcaac`	Diff	Change
siteCreation	13017.00 ms	13005.00 ms	-12.00 ms	🟢 -0.1%
siteStartup	4919.00 ms	3946.00 ms	-973.00 ms	🟢 -19.8%

Results are median values from multiple test runs.

Legend: 🟢 Improvement (faster) | 🔴 Regression (slower) | ⚪ No change

katinthehatsite · 2025-10-09T12:17:48Z

Alternatively, we could use the menu description. It looks like that on macOS:

Oh I think this is very nice, let's do that. It would give users a brief idea of what the feature 👍 Worst case, we can try to limit it to Mac

wojtekn · 2025-10-09T13:30:57Z

I adjusted it for Windows, as it didn't look great with sublabel:

Before	After

nightnei

LGTM and works as expected. Left just a few NIT comments

nightnei · 2025-10-10T16:18:21Z

src/ipc-types.d.ts

 	enableBlueprints: boolean;
 }

+// eslint-disable-next-line @typescript-eslint/no-empty-object-type


It seems we don't need it. Also we can remove it from FeatureFlags.

Suggested change

// eslint-disable-next-line @typescript-eslint/no-empty-object-type

Wasn't it left here to limit the number of changes we need to make when we remove the last feature flag?

nightnei · 2025-10-10T16:19:38Z

src/lib/beta-features.ts

+	description?: string;
+}
+
+export const BETA_FEATURES_DEFINITION: Record< keyof BetaFeatures, BetaFeatureDefinition > = {


It seems it's not used outside

Suggested change

export const BETA_FEATURES_DEFINITION: Record< keyof BetaFeatures, BetaFeatureDefinition > = {

const BETA_FEATURES_DEFINITION: Record< keyof BetaFeatures, BetaFeatureDefinition > = {

Thanks, removed in d4e7aaa.

nightnei · 2025-10-10T16:20:45Z

src/lib/beta-features.ts

+export const BETA_FEATURES: Record< keyof BetaFeatures, BetaFeatureDefinition > =
+	BETA_FEATURES_DEFINITION;
+
+export function buildBetaFeatures( userData: BetaFeatures | undefined ): BetaFeatures {


Suggested change

export function buildBetaFeatures( userData: BetaFeatures | undefined ): BetaFeatures {

function buildBetaFeatures( userData: BetaFeatures | undefined ): BetaFeatures {

Removed in d4e7aaa

wojtekn self-assigned this Oct 8, 2025

wojtekn requested a review from a team October 8, 2025 15:58

wojtekn marked this pull request as ready for review October 8, 2025 15:58

bcotrim approved these changes Oct 8, 2025

View reviewed changes

katinthehatsite approved these changes Oct 9, 2025

View reviewed changes

wojtekn added 5 commits October 9, 2025 12:49

Add Beta Features menu with storage support

bb78281

Expose Sites CLI as beta feature

af7158a

Fix TS issue popping up during tests

e079b42

Clean up beta features storage code

cb0ec54

Experiment with menu item label

bb91703

wojtekn force-pushed the add/beta-features-menu branch from 71d0094 to bb91703 Compare October 9, 2025 10:50

Improve new menu experience on Windows

19244ac

nightnei approved these changes Oct 10, 2025

View reviewed changes

Remove unnecessary exports

d4e7aaa

wojtekn merged commit 0e50477 into trunk Oct 14, 2025
12 checks passed

wojtekn deleted the add/beta-features-menu branch October 14, 2025 15:41

	export const BETA_FEATURES_DEFINITION: Record< keyof BetaFeatures, BetaFeatureDefinition > = {
	const BETA_FEATURES_DEFINITION: Record< keyof BetaFeatures, BetaFeatureDefinition > = {

	export function buildBetaFeatures( userData: BetaFeatures \| undefined ): BetaFeatures {
	function buildBetaFeatures( userData: BetaFeatures \| undefined ): BetaFeatures {

Add Beta Features menu #1860

Add Beta Features menu #1860

Uh oh!

Conversation

wojtekn commented Oct 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related issues

Proposed Changes

Testing Instructions

Testing the Beta Features Menu

Testing CLI Integration

Verify Persistence

Pre-merge Checklist

Uh oh!

bcotrim left a comment

Choose a reason for hiding this comment

Uh oh!

wojtekn commented Oct 9, 2025

Uh oh!

katinthehatsite left a comment

Choose a reason for hiding this comment

Uh oh!

wojtekn commented Oct 9, 2025

Uh oh!

github-actions bot commented Oct 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📊 Performance Test Results

site-editor

site-startup

Uh oh!

katinthehatsite commented Oct 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wojtekn commented Oct 9, 2025

Uh oh!

nightnei left a comment

Choose a reason for hiding this comment

Uh oh!

nightnei Oct 10, 2025

Choose a reason for hiding this comment

Uh oh!

wojtekn Oct 14, 2025

Choose a reason for hiding this comment

Uh oh!

nightnei Oct 10, 2025

Choose a reason for hiding this comment

Uh oh!

wojtekn Oct 14, 2025

Choose a reason for hiding this comment

Uh oh!

nightnei Oct 10, 2025

Choose a reason for hiding this comment

Uh oh!

wojtekn Oct 14, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

wojtekn commented Oct 8, 2025 •

edited

Loading

github-actions bot commented Oct 9, 2025 •

edited

Loading

katinthehatsite commented Oct 9, 2025 •

edited

Loading