feat: add Waku to C3

Fixes cloudflare#7594.

Adding a C3 template for Waku, a minimal React framework. https://waku.gg/

- Tests
  - [ ] TODO (before merge)
  - [x] Tests included
  - [ ] Tests not necessary because:
- E2E Tests CI Job required? (Use "e2e" label or ask maintainer to run separately)
  - [ ] I don't know
  - [x] Required
  - [ ] Not required because:
- Public documentation
  - [ ] TODO (before merge)
  - [x] Cloudflare docs PR(s): <cloudflare/cloudflare-docs#20444>
  - [ ] Documentation not necessary because:

Author: rmarscher

packages/create-cloudflare/e2e-tests/frameworks/framework-test-config.ts

@@ -659,5 +659,22 @@ export default function getFrameworkTestConfig(pm: string) {
 				expectedText: "Vite App",
 			},
 		},
+		waku: {
+			testCommitMessage: true,
+			timeout: LONG_TIMEOUT,
+			unsupportedOSs: ["win32"],
+			verifyDeploy: {
+				route: "/",
+				expectedText: "Waku",
+			},
+			verifyPreview: {
+				route: "/",
+				expectedText: "Waku",
+			},
+			verifyBuildCfTypes: {
+				outputFile: "worker-configuration.d.ts",
+				envInterfaceName: "Env",
+			},
+		},
 	};
 }

packages/create-cloudflare/src/frameworks/package.json

@@ -17,6 +17,7 @@
 		"create-react-router": "7.4.1",
 		"create-solid": "0.6.2",
 		"create-vue": "3.15.1",
+		"create-waku": "0.11.3-0.22.1-0",
 		"gatsby": "5.14.1",
 		"sv": "0.6.23",
 		"nuxi": "3.24.1"

packages/create-cloudflare/src/templates.ts

@@ -44,6 +44,7 @@ import scheduledTemplate from "templates/scheduled/c3";
 import solidTemplate from "templates/solid/c3";
 import svelteTemplate from "templates/svelte/c3";
 import vueTemplate from "templates/vue/c3";
+import wakuTemplate from "templates/waku/c3";
 import { isInsideGitRepo } from "./git";
 import { validateProjectDirectory, validateTemplateUrl } from "./validators";
 import type { Option } from "@cloudflare/cli/interactive";
@@ -193,6 +194,7 @@ export function getFrameworkMap({ experimental = false }): TemplateMap {
 			solid: solidTemplate,
 			svelte: svelteTemplate,
 			vue: vueTemplate,
+			waku: wakuTemplate,
 		};
 	}
 }

packages/create-cloudflare/templates/waku/c3.ts

@@ -0,0 +1,36 @@
+import { logRaw } from "@cloudflare/cli";
+import { runFrameworkGenerator } from "frameworks/index";
+import { detectPackageManager } from "helpers/packageManagers";
+import type { TemplateConfig } from "../../../src/templates";
+import type { C3Context } from "types";
+
+const { npm } = detectPackageManager();
+
+const generate = async (ctx: C3Context) => {
+	await runFrameworkGenerator(ctx, [
+		"--project-name",
+		ctx.project.name,
+		"--template",
+		"07_cloudflare",
+	]);
+};
+
+const config: TemplateConfig = {
+	configVersion: 1,
+	id: "waku",
+	frameworkCli: "create-waku",
+	platform: "workers",
+	displayName: "Waku",
+	path: "templates/workers/waku",
+	generate,
+	transformPackageJson: async () => ({
+		scripts: {
+			deploy: `${npm} run build && wrangler deploy`,
+			preview: `${npm} run build && wrangler dev`,
+		},
+	}),
+	devScript: "dev",
+	deployScript: "deploy",
+	previewScript: "preview",
+};
+export default config;

packages/create-cloudflare/templates/waku/wrangler.jsonc

@@ -0,0 +1,19 @@
+{
+	"name": "<TBD>",
+	"main": "./dist/worker/serve-cloudflare.js",
+	// https://developers.cloudflare.com/workers/platform/compatibility-dates
+	"compatibility_date": "<TBD>",
+	// nodejs_als is required for Waku server-side request context
+	// It can be removed if only building static pages
+	"compatibility_flags": ["nodejs_als"],
+	// https://developers.cloudflare.com/workers/static-assets/binding/
+	"assets": {
+		"binding": "ASSETS",
+		"directory": "./dist/assets",
+		"html_handling": "drop-trailing-slash",
+		"not_found_handling": "404-page"
+	},
+	"vars": {
+		"MAX_ITEMS": 10
+	}
+}