Migration guide for Pages -> Workers

Author: GregBrimble

public/__redirects

@@ -1523,6 +1523,7 @@
 /workers/tutorials/create-sitemap-from-sanity-cms/ /developer-spotlight/tutorials/create-sitemap-from-sanity-cms/ 301
 /workers/tutorials/custom-access-control-for-files-in-r2-using-d1-and-workers/ /developer-spotlight/tutorials/custom-access-control-for-files/ 301
 /workers/tutorials/generate-dynamic-og-images-using-workers/ /workers/tutorials/ 302
+/workers/static-assets/compatibility-matrix/ /workers/static-assets/migrate-from-pages/ 301
 
 # workers ai
 /workers-ai/models/llm/ /workers-ai/models/#text-generation 301

src/content/docs/pages/migrate-to-workers.mdx

@@ -0,0 +1,5 @@
+---
+pcx_content_type: navigation
+title: Migrate to Workers
+external_link: /workers/static-assets/migrate-from-pages/
+---

src/content/docs/pages/migrations/index.mdx

@@ -3,10 +3,10 @@ type: overview
 pcx_content_type: navigation
 title: Migration guides
 sidebar:
+  hidden: true
   order: 4
-
 ---
 
-import { DirectoryListing } from "~/components"
+import { DirectoryListing } from "~/components";
 
 <DirectoryListing />

src/content/docs/pages/migrations/migrating-from-firebase.mdx

@@ -3,6 +3,8 @@ updated: 2020-09-28
 difficulty: Beginner
 pcx_content_type: tutorial
 title: Migrating from Firebase
+sidebar:
+  hidden: true
 ---
 
 In this tutorial, you will learn how to migrate an existing Firebase application to Cloudflare Pages. You should already have an existing project deployed on Firebase that you would like to host on Cloudflare Pages.

src/content/docs/pages/migrations/migrating-from-netlify/index.mdx

@@ -5,7 +5,8 @@ pcx_content_type: tutorial
 title: Migrating from Netlify to Pages
 languages:
   - JavaScript
-
+sidebar:
+  hidden: true
 ---
 
 In this tutorial, you will learn how to migrate your Netlify application to Cloudflare Pages.
@@ -36,10 +37,8 @@ Your header files can also be moved into a `_headers` folder in your publish dir
 
 :::note
 
-
 Redirects execute before headers. In the case of a request matching rules in both files, the redirect will take precedence.
 
-
 :::
 
 ## Forms
@@ -60,19 +59,18 @@ Hello World with Netlify functions:
 
 ```js
 exports.handler = async function (event, context) {
-  return {
-    statusCode: 200,
-    body: JSON.stringify({ message: "Hello World" }),
-  };
-}
-
+	return {
+		statusCode: 200,
+		body: JSON.stringify({ message: "Hello World" }),
+	};
+};
 ```
 
 Hello World with Pages Functions:
 
 ```js
 export async function onRequestPost(request) {
-  return new Response(`Hello world`);
+	return new Response(`Hello world`);
 }
 ```
 

src/content/docs/pages/migrations/migrating-from-vercel/index.mdx

@@ -3,17 +3,16 @@ updated: 2020-09-23
 difficulty: Beginner
 pcx_content_type: tutorial
 title: Migrating from Vercel to Pages
-
+sidebar:
+  hidden: true
 ---
 
 In this tutorial, you will learn how to deploy your Vercel application to Cloudflare Pages.
 
 :::note
 
-
 You should already have an existing project deployed on Vercel that you would like to host on Cloudflare Pages. Features such as Vercel's serverless functions are currently not supported in Cloudflare Pages.
 
-
 :::
 
 ## Finding your build command and build directory
@@ -44,12 +43,10 @@ To use a custom domain for your Pages project, [add a custom domain](/pages/conf
 
 :::note
 
-
 Cloudflare does not provide IP addresses for your Pages project because we do not require `A` or `AAAA` records to link your domain to your project. Instead, Cloudflare uses `CNAME` records.
 
 For more details, refer to [Custom domains](/pages/configuration/custom-domains/).
 
-
 :::
 
 ## Cleaning up your old application and assigning the domain

src/content/docs/pages/migrations/migrating-from-workers/index.mdx

@@ -3,7 +3,8 @@ updated: 2020-08-13
 difficulty: Beginner
 pcx_content_type: tutorial
 title: Migrating from Workers Sites to Pages
-
+sidebar:
+  hidden: true
 ---
 
 In this tutorial, you will learn how to migrate an existing [Cloudflare Workers Sites](/workers/configuration/sites/) application to Cloudflare Pages.
@@ -16,10 +17,8 @@ You may already have a reasonably complex Worker and/or it would be tedious to s
 
 :::note
 
-
 When using a `_worker.js` file, the entire `/functions` directory is ignored - this includes its routing and middleware characteristics. Instead, the `_worker.js` file is deployed as is and must be written using the [Module Worker syntax](/workers/reference/migrate-to-module-workers/).
 
-
 :::
 
 By migrating to Cloudflare Pages, you will be able to access features like [preview deployments](/pages/configuration/preview-deployments/) and automatic branch deploys with no extra configuration needed.
@@ -40,12 +39,10 @@ You can migrate your redirects to Pages, by creating a `_redirects` file in your
 
 :::note
 
-
 A project is limited to 2,000 static redirects and 100 dynamic redirects, for a combined total of 2,100 redirects. Each redirect declaration has a 1,000-character limit. Malformed definitions are ignored. If there are multiple redirects for the same source path, the topmost redirect is applied.
 
 Make sure that static redirects are before dynamic redirects in your `_redirects` file.
 
-
 :::
 
 In addition to a `_redirects` file, Cloudflare also offers [Bulk Redirects](/pages/configuration/redirects/#surpass-_redirects-limits), which handles redirects that surpasses the 2,100 redirect rules limit set by Pages.
@@ -62,10 +59,8 @@ If you choose to use a custom domain for your Pages project, you can set it to t
 
 :::note
 
-
 Before you deploy, you will need to delete your old Workers routes to start sending requests to Cloudflare Pages.
 
-
 :::
 
 ### Using Direct Upload

src/content/docs/pages/migrations/migrating-jekyll-from-github-pages.mdx

@@ -5,6 +5,8 @@ pcx_content_type: tutorial
 title: Migrating a Jekyll-based site from GitHub Pages
 languages:
   - Ruby
+sidebar:
+  hidden: true
 ---
 
 In this tutorial, you will learn how to migrate an existing [GitHub Pages site using Jekyll](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll) to Cloudflare Pages. Jekyll is one of the most popular static site generators used with GitHub Pages, and migrating your GitHub Pages site to Cloudflare Pages will take a few short steps.

src/content/docs/workers/static-assets/compatibility-matrix.mdx

@@ -2,7 +2,7 @@
 pcx_content_type: concept
 title: Direct Uploads
 sidebar:
-  order: 7
+  order: 6
 head: []
 description: Upload assets through the Workers API.
 ---