Switch app init template to hosted app when HOSTED_APPS env var is set

[alfonso-noriega]

🚨 NOTE: do not merge before the repository https://github.com/Shopify/shopify-app-template-extension-only is available 🚨

WHY are these changes introduced?

When HOSTED_APPS=1 is set, shopify app init should present a hosted app template option instead of the standard extension-only template.

This is an internal-only flag (not user-facing) that allows the team to demo and test the hosted app experience end-to-end before it's generally available.

WHAT is this pull request doing?

• When HOSTED_APPS=1, the "Build an extension-only app" option in shopify app init is replaced with "Build an extension-only app (Shopify-hosted Preact app home and extensions, no back-end)" and points to the new shopify-app-template-extension-only repo
• Without the env var, behaviour is unchanged
• Adds hostedApps: 'HOSTED_APPS' to the cli-kit environmentVariables constants
• Adds isHostedAppsMode() helper to @shopify/cli-kit/node/context/local, following the same pattern as isVerbose, isDevelopment, etc.

How to test your changes?

HOSTED_APPS=1 shopify app init

The second option should read Build an extension-only app (Shopify-hosted Preact app home and extensions, no back-end) and scaffold from shopify-app-template-extension-only.

Without the env var, the prompt is unchanged.

Measuring impact

• n/a - this doesn't need measurement, e.g. a linting rule or a bug-fix

Checklist

• I've considered possible cross-platform impacts (Mac, Linux, Windows)
• I've considered possible documentation changes

[github-actions]

We detected some changes at packages/*/src and there are no updates in the .changeset.
If the changes are user-facing, run pnpm changeset add to track your changes and include them in the next release CHANGELOG.

Caution

DO NOT create changesets for features which you do not wish to be included in the public changelog of the next CLI release.

[alfonso-noriega]

• Switch app init template to hosted app when HOSTED_APPS env var is set #7096 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟢	Statements	82.29%	14905/18113
🟡	Branches	74.83%	7362/9838
🟢	Functions	81.37%	3777/4642
🟢	Lines	82.67%	14089/17042

Test suite run success

3932 tests passing in 1514 suites.

Report generated by 🧪jest coverage report action from 6d80d2c

[github-actions]

Differences in type declarations

We detected differences in the type declarations generated by Typescript for this branch compared to the baseline ('main' branch). Please, review them to ensure they are backward-compatible. Here are some important things to keep in mind:

• Some seemingly private modules might be re-exported through public modules.
• If the branch is behind main you might see odd diffs, rebase main into this branch.

New type declarations

We found no new type declarations in this PR

Existing type declarations

packages/cli-kit/dist/private/node/constants.d.ts

@@ -34,6 +34,7 @@ export declare const environmentVariables: {
     skipNetworkLevelRetry: string;
     maxRequestTimeForNetworkCalls: string;
     disableImportScanning: string;
+    hostedApps: string;
 };
 export declare const defaultThemeKitAccessDomain = "theme-kit-access.shopifyapps.com";
 export declare const systemEnvironmentVariables: {

packages/cli-kit/dist/public/node/context/local.d.ts

@@ -25,6 +25,13 @@ export declare function isDevelopment(env?: NodeJS.ProcessEnv): boolean;
  * @returns True if SHOPIFY_FLAG_VERBOSE is truthy or the flag --verbose has been passed.
  */
 export declare function isVerbose(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Returns true if the hosted apps mode is enabled.
+ *
+ * @param env - The environment variables from the environment of the current process.
+ * @returns True if HOSTED_APPS is truthy.
+ */
+export declare function isHostedAppsMode(env?: NodeJS.ProcessEnv): boolean;
 /**
  * Returns true if the environment in which the CLI is running is either
  * a local environment (where dev is present).