Automattic · arcangelini · May 6, 2026 · May 6, 2026 · May 6, 2026 · May 6, 2026
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/projects/packages/jetpack-mu-wpcom/changelog/add-podcast-wp-build-scaffold b/projects/packages/jetpack-mu-wpcom/changelog/add-podcast-wp-build-scaffold
@@ -0,0 +1,4 @@
+Significance: patch
+Type: changed
+
+Podcast: initialize the jetpack-podcast package from jetpack-mu-wpcom (so Simple sites pick it up where load-jetpack.php doesn't run), and when the `jetpack_podcast_untangle` filter is on, register the new in-admin "Jetpack > Podcast" page in place of the legacy Calypso "Podcasting" link. Default behavior (filter off) is unchanged.
diff --git a/projects/packages/jetpack-mu-wpcom/composer.json b/projects/packages/jetpack-mu-wpcom/composer.json
@@ -17,6 +17,7 @@
 		"automattic/jetpack-google-analytics": "@dev",
 		"automattic/jetpack-masterbar": "@dev",
 		"automattic/jetpack-newsletter": "@dev",
+		"automattic/jetpack-podcast": "@dev",
 		"automattic/jetpack-redirect": "@dev",
 		"automattic/jetpack-rtc": "@dev",
 		"automattic/jetpack-stats-admin": "@dev",

diff --git a/projects/packages/jetpack-mu-wpcom/src/class-jetpack-mu-wpcom.php b/projects/packages/jetpack-mu-wpcom/src/class-jetpack-mu-wpcom.php
@@ -385,6 +385,12 @@ public static function load_wpcom_user_features() {
 		// are registered on Simple sites (where load-jetpack.php doesn't run).
 		\Automattic\Jetpack\Newsletter\Settings::init();
 
+		// Initialize the Podcast package on Simple sites (where late_initialization
+		// in class.jetpack.php doesn't run). Gated by `jetpack_podcast_untangle`
+		// inside Podcast::init() so the legacy podcasting code keeps running
+		// until the flag flips.
+		\Automattic\Jetpack\Podcast\Podcast::init();
+
 		// Only load the Masterbar features on WoA sites.
 		if ( class_exists( '\Automattic\Jetpack\Status\Host' ) && ( new \Automattic\Jetpack\Status\Host() )->is_woa_site() ) {
 			// This is temporary. After we cleanup Masterbar on WPCOM we should load Masterbar for Simple sites too.

diff --git a/projects/packages/jetpack-mu-wpcom/src/features/wpcom-admin-menu/wpcom-admin-menu.php b/projects/packages/jetpack-mu-wpcom/src/features/wpcom-admin-menu/wpcom-admin-menu.php
@@ -9,6 +9,7 @@
 
 use Automattic\Jetpack\Connection\Manager as Connection_Manager;
 use Automattic\Jetpack\Newsletter\Settings as Newsletter_Settings;
+use Automattic\Jetpack\Podcast\Admin_Page as Podcast_Admin_Page;
 use Automattic\Jetpack\Redirect;
 use Automattic\Jetpack\Subscribers_Dashboard\Dashboard as Subscribers_Dashboard;
 
@@ -401,15 +402,21 @@ function () {
 		$subscribers_dashboard->add_wp_admin_submenu();
 	}
 
-	// Jetpack > Podcasting
-	add_submenu_page(
-		'jetpack',
-		__( 'Podcasting', 'jetpack-mu-wpcom' ),
-		__( 'Podcasting', 'jetpack-mu-wpcom' ),
-		'manage_options',
-		'https://wordpress.com/settings/podcasting/' . $domain,
-		null // @phan-suppress-current-line PhanTypeMismatchArgumentProbablyReal -- Core should ideally document null for no-callback arg. https://core.trac.wordpress.org/ticket/52539.
-	);
+	// When the `jetpack_podcast_untangle` filter is on, register the new
+	// "Jetpack > Podcast" in-admin page from the jetpack-podcast package.
+	// Otherwise keep the legacy "Jetpack > Podcasting" Calypso link unchanged.
+	if ( apply_filters( 'jetpack_podcast_untangle', false ) ) {
+		Podcast_Admin_Page::add_wp_admin_submenu();
+	} else {
+		add_submenu_page(
+			'jetpack',
+			__( 'Podcasting', 'jetpack-mu-wpcom' ),
+			__( 'Podcasting', 'jetpack-mu-wpcom' ),
+			'manage_options',
+			'https://wordpress.com/settings/podcasting/' . $domain,
+			null // @phan-suppress-current-line PhanTypeMismatchArgumentProbablyReal -- Core should ideally document null for no-callback arg. https://core.trac.wordpress.org/ticket/52539.
+		);
+	}
 
 	if ( $is_simple_site ) {
 		// Jetpack > Newsletter.
@@ -459,6 +466,7 @@ function () {
 			'search',
 			'subscribers',
 			'newsletter',
+			'jetpack-podcast',
 			'podcasting',
 			'traffic',
 			'jetpack#/settings',

diff --git a/projects/packages/podcast/.gitattributes b/projects/packages/podcast/.gitattributes
@@ -3,10 +3,15 @@
 .github/          export-ignore
 package.json      export-ignore
 
+# Files to include in the mirror repo, but excluded via gitignore
+# Remember to end all directories with `/**` to properly tag every file.
+/build/**         production-include
+
 # Files to exclude from the mirror repo, but included in the monorepo.
 # Remember to end all directories with `/**` to properly tag every file.
 .gitignore        production-exclude
 changelog/**      production-exclude
 .phpcs.dir.xml    production-exclude
 tests/**          production-exclude
 .phpcsignore      production-exclude
+routes/**/*.tsx   production-exclude
diff --git a/projects/packages/podcast/.gitignore b/projects/packages/podcast/.gitignore
@@ -1,4 +1,5 @@
 vendor/
 node_modules/
 .cache/
+build/
 composer.lock
diff --git a/projects/packages/podcast/.phpcsignore b/projects/packages/podcast/.phpcsignore
@@ -0,0 +1 @@
+build/
diff --git a/projects/packages/podcast/changelog/add-wp-build-scaffold b/projects/packages/podcast/changelog/add-wp-build-scaffold
@@ -0,0 +1,4 @@
+Significance: patch
+Type: added
+
+Add an empty wp-build dashboard scaffold and the "Jetpack > Podcast" wp-admin entry, gated behind the `jetpack_podcast_untangle` filter. With the filter off (default), nothing changes; with it on, a placeholder Podcast page renders inside the standard wp-admin chrome.
diff --git a/projects/packages/podcast/composer.json b/projects/packages/podcast/composer.json
@@ -5,9 +5,8 @@
 	"license": "GPL-2.0-or-later",
 	"require": {
 		"php": ">=7.2",
-		"automattic/jetpack-autoloader": "@dev",
-		"automattic/jetpack-composer-plugin": "@dev",
-		"automattic/jetpack-status": "@dev"
+		"automattic/jetpack-status": "@dev",
+		"automattic/jetpack-wp-build-polyfills": "@dev"
 	},
 	"require-dev": {
 		"yoast/phpunit-polyfills": "^4.0.0",
@@ -23,6 +22,12 @@
 		]
 	},
 	"scripts": {
+		"build-development": "pnpm run build",
+		"build-production": "pnpm run build-production",
+		"watch": [
+			"Composer\\Config::disableProcessTimeout",
+			"pnpm run watch"
+		],
 		"phpunit": [
 			"phpunit-select-config phpunit.#.xml.dist --colors=always"
 		],
@@ -58,8 +63,6 @@
 	},
 	"config": {
 		"allow-plugins": {
-			"automattic/jetpack-autoloader": true,
-			"automattic/jetpack-composer-plugin": true,
 			"roots/wordpress-core-installer": true
 		}
 	}

diff --git a/projects/packages/podcast/package.json b/projects/packages/podcast/package.json
@@ -13,5 +13,41 @@
 		"directory": "projects/packages/podcast"
 	},
 	"license": "GPL-2.0-or-later",
-	"author": "Automattic"
+	"author": "Automattic",
+	"type": "module",
+	"scripts": {
+		"build": "pnpm run clean && pnpm run build:wp-build && pnpm run build:boot-asset",
+		"build:boot-asset": "provide-boot-asset-file",
+		"build:wp-build": "wp-build",
+		"build-production": "pnpm run clean && pnpm run build:wp-build && pnpm run build:boot-asset",
+		"clean": "rm -rf build/",
+		"watch": "wp-build --watch"
+	},
+	"browserslist": [
+		"extends @wordpress/browserslist-config"
+	],
+	"devDependencies": {
+		"@automattic/jetpack-wp-build-polyfills": "workspace:*",
+		"@babel/core": "7.29.0",
+		"@babel/runtime": "7.29.2",
+		"@types/react": "18.3.28",
+		"@wordpress/browserslist-config": "6.44.0",
+		"@wordpress/build": "0.13.0",
+		"@wordpress/element": "6.44.0",
+		"@wordpress/i18n": "6.17.0",
+		"browserslist": "^4.24.0"
+	},
+	"optionalDependencies": {
+		"react": "18.3.1",
+		"react-dom": "18.3.1"
+	},
+	"wpPlugin": {
+		"name": "jetpack_podcast",
+		"scriptGlobal": "jetpackPodcast",
+		"packageNamespace": "jetpack-podcast",
+		"handlePrefix": "jetpack-podcast",
+		"pages": [
+			"jetpack-podcast-dashboard"
+		]
+	}
 }
diff --git a/projects/packages/podcast/routes/dashboard/package.json b/projects/packages/podcast/routes/dashboard/package.json
@@ -0,0 +1,14 @@
+{
+	"name": "_@jetpack-podcast/dashboard-route",
+	"version": "1.0.0",
+	"private": true,
+	"dependencies": {
+		"@types/react": "18.3.28",
+		"@wordpress/element": "6.44.0",
+		"@wordpress/i18n": "6.17.0"
+	},
+	"route": {
+		"path": "/",
+		"page": "jetpack-podcast-dashboard"
+	}
+}
diff --git a/projects/packages/podcast/routes/dashboard/route.tsx b/projects/packages/podcast/routes/dashboard/route.tsx
@@ -0,0 +1 @@
+export const route = {};
diff --git a/projects/packages/podcast/routes/dashboard/stage.tsx b/projects/packages/podcast/routes/dashboard/stage.tsx
@@ -0,0 +1,6 @@
+const Stage = () => {
+	// "Podcast" is a product name, do not translate.
+	return <h1>Podcast</h1>;
+};
+
+export { Stage as stage };