chore: update root /templates to use wrangler generate instead of create-cloudflare@v1 (#3452)

* chore: update templates to use --no-delegate-c3 for all init commands.

* update templates to use wrangler generate

* prettier fixes

* remove mention of c3 since template instructions now rely on wrangler generate

* prettier fix

Author: admah

templates/README.md

@@ -12,13 +12,13 @@ There are a few ways to quickly jumpstart your next project using one of the tem
 
 1. **Local development, via CLI quickstart utility**
 
-   We recommend using the `npm create cloudflare@1 [folder-name] [template-name]` command to create new projects with templates.
-
-   You may select the name of any subdirectory within this repository to create your project; for example, `worker-typescript` and `examples/fast-google-fonts` are both valid subdirectory names.
+   We recommend using the `npx wrangler generate [folder-name] [template-name]` command to create new projects with templates.
 
    To create a `my-project` directory using the [`worker-typescript`](/worker-typescript) template, you would run the following command:
 
-`npm create cloudflare@1 my-project worker-typescript`
+   `npx wrangler generate my-project worker-typescript`
+
+   Each template also comes with explicit installation and setup instructions in the README.
 
 1. **Local development, via full repository clone**
 

templates/experimental/worker-cobol/README.md

@@ -11,11 +11,9 @@ A Cloudflare worker that runs COBOL.
 To create a `my-project` directory using this template, run:
 
 ```sh
-$ npm init cloudflare my-project worker-cobol
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-cobol
 # or
-$ yarn create cloudflare my-project worker-cobol
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-cobol
 # or
-$ pnpm create cloudflare my-project worker-cobol
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-cobol
 ```
-
-> **Note:** Each command invokes [`create-cloudflare`](https://www.npmjs.com/package/create-cloudflare) for project creation.

templates/experimental/worker-dart/README.md

@@ -4,24 +4,31 @@ Your [Dart](https://dart.dev/) code in [index.dart](https://github.com/cloudflar
 
 In addition to [Wrangler](https://github.com/cloudflare/wrangler) you will need to [install Dart](https://dart.dev/get-dart).
 
-#### Wrangler
+## Setup
 
-To generate using [wrangler](https://github.com/cloudflare/wrangler)
+To create a `my-project` directory using this template, run:
 
-```
-wrangler generate projectname https://github.com/cloudflare/dart-worker-hello-world
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-dart
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-dart
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-dart
 ```
 
 Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
 
-#### Dart
+## Dart
 
 After installing Dart per the linked instructions above,
 
-```
+```sh
 cd projectname
+```
 
-# run once to get dependencies
+Then run the following to get dependencies:
+
+```sh
 pub get
 
 dart2js -O2 --server-mode -o index.js index.dart
@@ -31,11 +38,11 @@ That will compile your code into index.js, after which you can run `wrangler dep
 
 For more information on how Dart translates to JavaScript, see the [docs for dart2js](https://dart.dev/tools/dart2js) and the [interop guide](https://dart.dev/web/js-interop).
 
-#### Errors
+## Errors
 
 Dart `2.13.0` and above require the `dart2js --server-mode` flag when using native JavaScript classes. Server mode is used to compile JS to run on server side VMs such as nodejs. If this flag is not used, the following errors are displayed:
 
-```
+```sh
 index.dart:4:7:
 Error: JS interop class 'Request' conflicts with natively supported class '_Request' in 'dart:html'.
 class Request {

templates/experimental/worker-emscripten/README.md

@@ -16,15 +16,13 @@ This template requires [Docker](https://docs.docker.com/install/) for providing
 To create a `my-project` directory using this template, run:
 
 ```sh
-$ npm init cloudflare my-project worker-emscripten
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-emscripten
 # or
-$ yarn create cloudflare my-project worker-emscripten
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-emscripten
 # or
-$ pnpm create cloudflare my-project worker-emscripten
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-emscripten
 ```
 
-> **Note:** Each command invokes [`create-cloudflare`](https://www.npmjs.com/package/create-cloudflare) for project creation.
-
 ## Credits
 
 Shoutout to [Surma](https://twitter.com/dassurma) for his [webpack-emscripten-wasm](https://gist.github.com/surma/b2705b6cca29357ebea1c9e6e15684cc) gist that was instrumental in getting this working!

templates/experimental/worker-fsharp/README.md

@@ -33,10 +33,14 @@ To authenticate wrangler commands it is recomended you [configure wrangler](http
 
 ### Generate a New Project
 
-To create a new project based on this template execute:
-
-```
-wrangler generate projectname https://github.com/fable-compiler/cfworker-hello-world
+To create a `my-project` directory using this template, run:
+
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-fsharp
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-fsharp
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-fsharp
 ```
 
 ### Build and Deploy to Dev

templates/experimental/worker-kotlin/README.md

@@ -4,6 +4,18 @@ Your Kotlin code in [main.kt](https://github.com/cloudflare/kotlin-worker-hello-
 
 In addition to [Wrangler v2.x](https://github.com/cloudflare/wrangler2) you will need to install Kotlin, including a JDK and support for Gradle projects. The easiest way to do this is using the free Community Edition of [IntelliJ IDEA](https://kotlinlang.org/docs/tutorials/jvm-get-started.html).
 
+## Setup
+
+To create a `my-project` directory using this template, run:
+
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-kotlin
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-kotlin
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-kotlin
+```
+
 ## Wrangler
 
 Configure the [wrangler.toml](wrangler.toml) by filling in the `account_id` from the Workers pages of your Cloudflare Dashboard.

templates/experimental/worker-perl/README.md

@@ -4,21 +4,29 @@ Your Perl code in [index.pl](https://github.com/cloudflare/perl-worker-hello-wor
 
 In addition to [Wrangler](https://github.com/cloudflare/wrangler) you will need to install Perl 5 and [Perlito](https://github.com/fglock/Perlito), a compiler from Perl to Java and JavaScript. Clone Perlito from GitHub (last tested on commit 97c296f), don't install the older version available on CPAN.
 
-#### Wrangler
+## Setup
 
-To generate using [wrangler](https://github.com/cloudflare/wrangler)
+To create a `my-project` directory using this template, run:
 
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-perl
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-perl
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-perl
 ```
-wrangler generate projectname https://github.com/cloudflare/perl-worker-hello-world
-```
+
+## Wrangler
+
+Wrangler is used to develop, deploy, and configure your Worker via CLI.
 
 Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
 
-#### Perlito
+## Perlito
 
 Assuming you've cloned the Perlito repo to `~/Perlito` and `perl` on your path is Perl 5, run
 
-```
+```sh
 cd projectname
 echo -e "const window = this;\n" > index.js && \
 perl ~/Perlito/perlito5.pl -Cjs index.pl >> index.js

templates/experimental/worker-php/README.md

@@ -4,19 +4,27 @@ Your PHP code in [index.php](https://github.com/cloudflare/php-worker-hello-worl
 
 This project uses [babel-preset-php](https://gitlab.com/kornelski/babel-preset-php) to convert PHP to JavaScript.
 
-#### Wrangler
+## Setup
 
-To generate using [wrangler](https://github.com/cloudflare/wrangler)
+To create a `my-project` directory using this template, run:
 
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-php
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-php
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-php
 ```
-wrangler generate projectname https://github.com/cloudflare/php-worker-hello-world
-```
+
+## Wrangler
+
+Wrangler is used to develop, deploy, and configure your Worker via CLI.
 
 Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
 
-#### babel-preset-php
+## babel-preset-php
 
-```
+```sh
 cd projectname
 
 # run once to install babel-preset-php and dependencies

templates/experimental/worker-python/README.md

@@ -4,19 +4,29 @@ Your Python code in [index.py](https://github.com/cloudflare/python-worker-hello
 
 In addition to [Wrangler](https://github.com/cloudflare/wrangler2) and [npm](https://www.npmjs.com/get-npm), you will need to install [Transcrypt](https://www.transcrypt.org/docs/html/installation_use.html), including Python 3.7 and virtualenv.
 
-#### Wrangler
+## Setup
 
-- Clone repository (`git clone https://github.com/cloudflare/python-worker-hello-world`)
-- Run `npm install`
-- Update `wrangler.toml` with your project `name`, `account_id`, and `route` as required
+To create a `my-project` directory using this template, run:
 
-Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/wrangler/).
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-python
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-python
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-python
+```
+
+## Wrangler
+
+Wrangler is used to develop, deploy, and configure your Worker via CLI.
 
-#### Transcrypt
+Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
+
+## Transcrypt
 
 Before building your project, you'll need to do one-time setup of Transcrypt. Assuming you have Python 3.7 and virtualenv installed per the linked instructions above, that setup on unix systems looks like the following (for windows see [virtualenv docs](https://virtualenv.pypa.io/en/latest/user_guide.html#activators)):
 
-```
+```sh
 cd projectname
 
 virtualenv env
@@ -34,7 +44,7 @@ For more information on how Python translates to Javascript, see the [Transcrypt
 
 Because of aliases, for a KV namespace binding named `KV` you can use `KV.put` normally, but need to use `KV.js_get` instead of `KV.get`. For example, a handler using KV might look like:
 
-```
+```sh
 def handleRequest(request):
     return KV.js_get('foo').then(
         lambda v: __new__(Response('Python Worker hello world! ' + v, {

templates/experimental/worker-reason/README.md

@@ -4,21 +4,29 @@ Your [Reason](https://reasonml.github.io/) code in [Demo.re](https://github.com/
 
 In addition to [Wrangler](https://github.com/cloudflare/wrangler) you will need to [install BuckleScript](https://reasonml.github.io/docs/en/installation) using npm or Yarn.
 
-#### Wrangler
+## Setup
 
-To generate using [wrangler](https://github.com/cloudflare/wrangler)
+To create a `my-project` directory using this template, run:
 
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-reason
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-reason
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-reason
 ```
-wrangler generate projectname https://github.com/cloudflare/reason-worker-hello-world
-```
+
+## Wrangler
+
+Wrangler is used to develop, deploy, and configure your Worker via CLI.
 
 Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
 
-#### BuckleScript
+## BuckleScript
 
 After installing BuckleScript per the linked instructions above,
 
-```
+```sh
 cd projectname
 
 # assuming you installed BuckleScript globally, need to run this once

templates/experimental/worker-rust/README.md

@@ -11,14 +11,18 @@ This template is designed for compiling Rust to WebAssembly and publishing the r
 To create a `my-project` directory using this template, run:
 
 ```sh
-$ npm init cloudflare my-project worker-rust
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-rust
 # or
-$ yarn create cloudflare my-project worker-rust
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-rust
 # or
-$ pnpm create cloudflare my-project worker-rust
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-rust
 ```
 
-> **Note:** Each command invokes [`create-cloudflare`](https://www.npmjs.com/package/create-cloudflare) for project creation.
+## Wrangler
+
+Wrangler is used to develop, deploy, and configure your Worker via CLI.
+
+Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
 
 ## Usage
 

templates/experimental/worker-scala-kv/README.md

@@ -4,23 +4,29 @@
 
 In addition to [Wrangler](https://github.com/cloudflare/wrangler) you will need to install the Scala build tool [sbt](https://www.scala-sbt.org/1.x/docs/Setup.html), including a JDK.
 
-#### Wrangler
+## Setup
 
-To generate using [wrangler](https://github.com/cloudflare/wrangler)
+To create a `my-project` directory using this template, run:
 
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-scala-kv
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-scala-kv
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-scala-kv
 ```
-wrangler generate projectname https://github.com/cloudflare/scala-worker-kv
-```
 
-When editing wrangler.toml to include your account_id, you will also need to add your kv namespace id to the binding under kv-namespaces.
+## Wrangler
+
+Wrangler is used to develop, deploy, and configure your Worker via CLI.
 
 Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
 
-#### sbt
+## sbt
 
 After installing sbt per the linked instructions above,
 
-```
+```sh
 cd projectname
 sbt fullOptJS
 ```

templates/experimental/worker-scala/README.md

@@ -4,21 +4,29 @@ Your Scala code in [Main.scala](https://github.com/cloudflare/scala-worker-hello
 
 In addition to [Wrangler](https://github.com/cloudflare/wrangler) you will need to install the Scala build tool [sbt](https://www.scala-sbt.org/1.x/docs/Setup.html), including a JDK.
 
-#### Wrangler
+## Setup
 
-To generate using [wrangler](https://github.com/cloudflare/wrangler)
+To create a `my-project` directory using this template, run:
 
+```sh
+$ npx wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-scala
+# or
+$ yarn wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-scala
+# or
+$ pnpm wrangler generate my-project https://github.com/cloudflare/workers-sdk/templates/experimental/worker-scala
 ```
-wrangler generate projectname https://github.com/cloudflare/scala-worker-hello-world
-```
+
+## Wrangler
+
+Wrangler is used to develop, deploy, and configure your Worker via CLI.
 
 Further documentation for Wrangler can be found [here](https://developers.cloudflare.com/workers/tooling/wrangler).
 
-#### sbt
+## sbt
 
 After installing sbt per the linked instructions above,
 
-```
+```sh
 cd projectname
 sbt fullOptJS
 ```