docs: add cloudflare workers section

content/3.deploy/cloudflare.md

@@ -7,29 +7,79 @@ nitroPreset: 'cloudflare'
 website: 'https://pages.cloudflare.com/'
 ---
 
-## Cloudflare Pages
+## Cloudflare Workers
 
-::tip
-**Zero Configuration ✨**
-:br
-Integration with Cloudflare Pages is possible with zero configuration, [learn more](https://nitro.unjs.io/deploy#zero-config-providers).
-::
+Cloudflare Workers supports [static assets](https://developers.cloudflare.com/workers/static-assets/), making it easy to deploy a Nuxt application. You can learn more about it on the [Cloudflare documentation](https://developers.cloudflare.com/workers/frameworks/framework-guides/nuxt/).
+
+::note
+You must set a compatibility date to `2024-09-19` or later in both `nuxt.config.ts` and `wrangler.toml`.
+Checkout the [Nitro documentation](https://nitro.build/deploy/providers/cloudflare#cloudflare-module-workers) for the `cloudflare_module` preset.
+:: 
 
 ::important
-Checkout the [@nuxthub/core](/modules/hub) module to build full-stack Nuxt applications with Cloudflare, learn more on [hub.nuxt.com](https://hub.nuxt.com).
+Cloudflare Static Assets is in Beta.
 ::
 
-### Git Integration
+### Deploy With Wrangler
 
-If you use the GitHub/GitLab integration with Cloudflare Pages, **no configuration is required**. Pushing to your repository will automatically build your project and deploy it.
+You can use [wrangler](https://github.com/cloudflare/workers-sdk) to deploy your project to Cloudflare.
+
+1. Configure Nitro in `nuxt.config.ts` with the following configuration :
+
+```ts
+export default defineNuxtConfig({
+  compatibilityDate: "2025-03-01",
+  nitro: { cloudflare: { nodeCompat: true, deployConfig: true } }
+});
+```
+
+This approach is recommend as it will generate a properly configured minimal `wangler.jsonc` for you. If you need to add Cloudflare settings, provide your own `wrangler.jsonc` and it will be merged with the correct Nitro options.
+For advanced use cases, if you want manual control over the cloudflare settings, set `nodeCompat` and `deployConfig` to false and manually provide your own `wrangler.jsonc` with the appropriate configuration :
+
+```json [wrangler.jsonc]
+{
+	"$schema": "https://unpkg.com/wrangler@latest/config-schema.json",
+	"compatibility_date": "2025-01-16", 
+  "compatibility_flags": ["nodejs_compat"],
+	"main": "./.output/server/index.mjs",
+	"assets": {
+		"directory": "./.output/public/",
+		"binding": "ASSETS"
+	}
+}
+```
+
+2. Build your project for Cloudflare Workers:
+
+    ```bash [Terminal]
+    npx nuxi build --preset=cloudflare_module
+    ```
+
+3. Deploy, it will ask you to create a project for the first time:
+
+    ```bash [Terminal]
+    wrangler deploy
+    ```
+
+### Automatic Deploy With Git
+
+If you're using GitHub or GitLab, Cloudflare workers has an integration to automatically deploy your project. 
 
 ::note
-Nuxt will detect the environment to set the correct [Server/Nitro preset](https://nitro.unjs.io/deploy/providers/cloudflare).
+Checkout the [Workers Build](https://developers.cloudflare.com/workers/ci-cd/builds/git-integration/) documentation for the Git Integration.
 ::
 
-To leverage server-side rendering on the edge, set the build command to: `nuxt build`
+::important
+[Workers Build](https://developers.cloudflare.com/workers/ci-cd/builds/) is in Beta.
+::
 
-To statically generate your website, set the build command to: `nuxt generate`
+## Cloudflare Pages
+
+::tip
+**Zero Configuration ✨**
+:br
+Integration with Cloudflare Pages is possible with zero configuration, [learn more](https://nitro.unjs.io/deploy#zero-config-providers).
+::
 
 ### Route matching
 
@@ -47,6 +97,18 @@ export default defineNuxtConfig({
 })
 ```
 
+### Git Integration
+
+If you use the GitHub/GitLab integration with Cloudflare Pages, **no configuration is required**. Pushing to your repository will automatically build your project and deploy it.
+
+::note
+Nuxt will detect the environment to set the correct [Server/Nitro preset](https://nitro.unjs.io/deploy/providers/cloudflare).
+::
+
+To leverage server-side rendering on the edge, set the build command to: `nuxt build`
+
+To statically generate your website, set the build command to: `nuxt generate`
+
 ### Direct Upload
 
 Alternatively, you can use [wrangler](https://github.com/cloudflare/workers-sdk) to upload your project to Cloudflare.
@@ -67,10 +129,18 @@ In this case, you will have to set the preset manually.
 
 ## Learn more
 
+::important
+Checkout the [@nuxthub/core](/modules/hub) module to build full-stack Nuxt applications with Cloudflare, learn more on [hub.nuxt.com](https://hub.nuxt.com).
+::
+
 ::read-more{to="https://nitro.unjs.io/deploy/providers/cloudflare" target="_blank"}
 Head over **Nitro documentation** to learn more about the Cloudflare deployment preset.
 ::
 
+::read-more{to="https://developers.cloudflare.com/workers/static-assets/compatibility-matrix/" target="_blank"}
+To chose between Workers and Pages, look at the compatibility matrix. In the future Workers will be the preferred way to deploy application on cloudflare.
+::
+
 ::read-more{to="https://developers.cloudflare.com/pages/framework-guides/deploy-a-nuxt-site/#use-bindings-in-your-nuxt-application" target="_blank"}
 Head over **CloudFlare Pages** documentation to learn more about it.
 ::