feat: add template for minimal fetch handler worker

Author: jahands

turbo/generators/config.ts

@@ -30,7 +30,6 @@ export default function generator(plop: PlopTypes.NodePlopAPI): void {
 
 	plop.setGenerator('new-worker', {
 		description: 'Create a new Cloudflare Worker using Hono',
-		// gather information from the user
 		prompts: [
 			{
 				type: 'input',
@@ -39,7 +38,6 @@ export default function generator(plop: PlopTypes.NodePlopAPI): void {
 				validate: nameValidator,
 			},
 		],
-		// perform actions based on the prompts
 		actions: (data: unknown) => {
 			const answers = NewWorkerAnswers.parse(data)
 			process.chdir(answers.turbo.paths.root)
@@ -64,7 +62,6 @@ export default function generator(plop: PlopTypes.NodePlopAPI): void {
 
 	plop.setGenerator('new-worker-vite', {
 		description: 'Create a new Cloudflare Worker using Hono and Vite',
-		// gather information from the user
 		prompts: [
 			{
 				type: 'input',
@@ -73,7 +70,6 @@ export default function generator(plop: PlopTypes.NodePlopAPI): void {
 				validate: nameValidator,
 			},
 		],
-		// perform actions based on the prompts
 		actions: (data: unknown) => {
 			const answers = NewWorkerAnswers.parse(data)
 			process.chdir(answers.turbo.paths.root)
@@ -96,6 +92,38 @@ export default function generator(plop: PlopTypes.NodePlopAPI): void {
 		},
 	})
 
+	plop.setGenerator('new-worker-minimal', {
+		description: 'Create a new Cloudflare Worker with a minimal fetch handler',
+		prompts: [
+			{
+				type: 'input',
+				name: 'name',
+				message: 'name of worker',
+				validate: nameValidator,
+			},
+		],
+		actions: (data: unknown) => {
+			const answers = NewWorkerAnswers.parse(data)
+			process.chdir(answers.turbo.paths.root)
+			const destination = `apps/${slugifyText(answers.name)}`
+
+			const actions: PlopTypes.Actions = [
+				{
+					type: 'addMany',
+					base: 'templates/fetch-worker-minimal',
+					destination,
+					templateFiles: ['templates/fetch-worker-minimal/**/**.hbs'],
+					data: answers,
+				},
+				{ type: 'pnpmInstall', data: { ...answers, destination } satisfies PnpmInstallData },
+				{ type: 'fixAll' },
+				{ type: 'pnpmInstall', data: { ...answers, destination } satisfies PnpmInstallData },
+			]
+
+			return actions
+		},
+	})
+
 	plop.setGenerator('new-package', {
 		description: 'Create a new shared package',
 		prompts: [

turbo/generators/templates/fetch-worker-minimal/README.md.hbs

@@ -0,0 +1,23 @@
+# {{ slug name }}
+
+A Cloudflare Workers application with a minimal fetch handler
+
+## Development
+
+### Run in dev mode
+
+```sh
+pnpm dev
+```
+
+### Run tests
+
+```sh
+pnpm test
+```
+
+### Deploy
+
+```sh
+pnpm turbo deploy
+```

turbo/generators/templates/fetch-worker-minimal/env.d.ts.hbs

@@ -0,0 +1,8 @@
+/* eslint-disable @typescript-eslint/consistent-type-imports */
+type LocalEnv = import('./src/context').Env
+
+// Add Env to Cloudflare namespace so that we can access it via
+// import { env } from 'cloudflare:workers'
+declare namespace Cloudflare {
+	interface Env extends LocalEnv {}
+}

turbo/generators/templates/fetch-worker-minimal/eslint.config.ts.hbs

@@ -0,0 +1,7 @@
+import { defineConfig, getConfig } from '@repo/eslint-config'
+
+import type { Config } from '@repo/eslint-config'
+
+const config = getConfig(import.meta.url)
+
+export default defineConfig([config]) as Config

turbo/generators/templates/fetch-worker-minimal/package.json.hbs

@@ -0,0 +1,25 @@
+{
+	"name": "{{ slug name }}",
+	"version": "0.1.0",
+	"private": true,
+	"sideEffects": false,
+	"type": "module",
+	"scripts": {
+		"build:wrangler": "run-wrangler-build",
+		"check:lint": "run-eslint",
+		"check:types": "run-tsc",
+		"deploy": "run-wrangler-deploy",
+		"dev": "run-wrangler-dev",
+		"fix:workers-types": "run-wrangler-types",
+		"test": "run-vitest"
+	},
+	"devDependencies": {
+		"@cloudflare/vitest-pool-workers": "0.9.12",
+		"@repo/eslint-config": "workspace:*",
+		"@repo/tools": "workspace:*",
+		"@repo/typescript-config": "workspace:*",
+		"@types/node": "22.15.27",
+		"vitest": "3.2.4",
+		"wrangler": "4.42.2"
+	}
+}

turbo/generators/templates/fetch-worker-minimal/src/context.ts.hbs

@@ -0,0 +1,3 @@
+export type Env = {
+	// add bindings here
+}

turbo/generators/templates/fetch-worker-minimal/src/test/integration/api.test.ts.hbs

@@ -0,0 +1,8 @@
+import { SELF } from 'cloudflare:test'
+import { expect, it } from 'vitest'
+
+it('response with hello world', async () => {
+	const res = await SELF.fetch('https://example.com')
+	expect(res.status).toBe(200)
+	expect(await res.text()).toMatchInlineSnapshot(`"hello, world!"`)
+})

turbo/generators/templates/fetch-worker-minimal/src/{{ slug name }}.app.ts.hbs

@@ -0,0 +1,7 @@
+import type { Env } from './context'
+
+export default {
+	fetch: (_request, _env, _ctx) => {
+		return new Response('hello, world!')
+	},
+} satisfies ExportedHandler<Env>

turbo/generators/templates/fetch-worker-minimal/tsconfig.json.hbs

@@ -0,0 +1,3 @@
+{
+	"extends": "@repo/typescript-config/workers.json"
+}

turbo/generators/templates/fetch-worker-minimal/vitest.config.ts.hbs

@@ -0,0 +1,11 @@
+import { defineWorkersProject } from '@cloudflare/vitest-pool-workers/config'
+
+export default defineWorkersProject({
+	test: {
+		poolOptions: {
+			workers: {
+				wrangler: { configPath: `${__dirname}/wrangler.jsonc` }
+			},
+		},
+	},
+})