From bfbd32588f7e2c0a9e43cd1a571a0dc9c5f7e645 Mon Sep 17 00:00:00 2001 From: Obinna Ekwuno Date: Wed, 10 Aug 2022 20:11:19 +0100 Subject: [PATCH] [Docs]: Update Cloudflare README (#4232) * update cloudflare readme * Create modern-papayas-rhyme.md Co-authored-by: Nate Moore --- .changeset/modern-papayas-rhyme.md | 5 +++++ packages/integrations/cloudflare/README.md | 5 +++-- 2 files changed, 8 insertions(+), 2 deletions(-) create mode 100644 .changeset/modern-papayas-rhyme.md diff --git a/.changeset/modern-papayas-rhyme.md b/.changeset/modern-papayas-rhyme.md new file mode 100644 index 000000000..f6751130c --- /dev/null +++ b/.changeset/modern-papayas-rhyme.md @@ -0,0 +1,5 @@ +--- +"@astrojs/cloudflare": patch +--- + +Update README diff --git a/packages/integrations/cloudflare/README.md b/packages/integrations/cloudflare/README.md index 1bd65f5ae..2ca3bfac5 100644 --- a/packages/integrations/cloudflare/README.md +++ b/packages/integrations/cloudflare/README.md @@ -27,7 +27,7 @@ Cloudflare Pages has 2 different modes for deploying functions, `advanced` mode For most projects the adaptor default of `advanced` will be sufficiant, when in this mode the `dist` folder will contain your compiled project. However if you'd like to use [pages plugins](https://developers.cloudflare.com/pages/platform/functions/plugins/) such as [Sentry](https://developers.cloudflare.com/pages/platform/functions/plugins/sentry/) for example to enable logging, you'll need to use directory mode. -In directory mode the adaptor will compile the client side part of you app the same way, but it will move the worker script into a `functions` folder in the project root. The adaptor will only ever place a `[[path]].js` in that folder, allowing you to add additional plugins and pages middlewhere which can be checked into version control . +In directory mode the adaptor will compile the client side part of you app the same way, but it will move the worker script into a `functions` folder in the project root. The adaptor will only ever place a `[[path]].js` in that folder, allowing you to add additional plugins and pages middleware which can be checked into version control. ```ts // directory mode @@ -45,7 +45,7 @@ In order for preview to work you must install `wrangler` $ pnpm install wrangler --save-dev ``` -It's then possible to update the preview script in your `package.json` to `"preview": "wrangler pages dev ./dist"` +It's then possible to update the preview script in your `package.json` to `"preview": "wrangler pages dev ./dist"`.This will allow you run your entire application locally with [Wrangler](https://github.com/cloudflare/wrangler2), which supports secrets, environment variables, KV namespaces, Durable Objects and [all other supported Cloudflare bindings](https://developers.cloudflare.com/pages/platform/functions/#adding-bindings). ## Streams @@ -54,3 +54,4 @@ Some integrations such as [React](https://github.com/withastro/astro/tree/main/p In order to work around this: - install the `"web-streams-polyfill"` package - add `import "web-streams-polyfill/es2018";` to the top of the front matter of every page which requires streams, such as server rendering a React component. +