From 14076eed865defd5c5a2b802423731cf165cf6a0 Mon Sep 17 00:00:00 2001
From: Mark Burggraf <markb@mantisbible.com>
Date: Wed, 23 Oct 2024 09:58:40 -0700
Subject: [PATCH] added new neon migration guide (#30056)

---
 .../NavigationMenu.constants.ts               |  6 ++
 .../platform/migrating-to-supabase/neon.mdx   | 90 +++++++++++++++++++
 .../docs/public/img/icons/neon-icon-light.svg |  4 +
 apps/docs/public/img/icons/neon-icon.svg      |  4 +
 4 files changed, 104 insertions(+)
 create mode 100644 apps/docs/content/guides/platform/migrating-to-supabase/neon.mdx
 create mode 100644 apps/docs/public/img/icons/neon-icon-light.svg
 create mode 100644 apps/docs/public/img/icons/neon-icon.svg

diff --git a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
index 6aa8637e1ff..27a91a80c11 100644
--- a/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
+++ b/apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts
@@ -1861,6 +1861,12 @@ export const MIGRATION_PAGES: Partial<NavMenuSection & ComponentProps<typeof Ico
     url: '/guides/platform/migrating-to-supabase/vercel-postgres',
     hasLightIcon: true,
   },
+  {
+    name: 'Neon',
+    icon: '/docs/img/icons/neon-icon',
+    url: '/guides/platform/migrating-to-supabase/neon',
+    hasLightIcon: true,
+  },
   {
     name: 'MySQL',
     icon: '/docs/img/icons/mysql-icon',
diff --git a/apps/docs/content/guides/platform/migrating-to-supabase/neon.mdx b/apps/docs/content/guides/platform/migrating-to-supabase/neon.mdx
new file mode 100644
index 00000000000..8a983829a5d
--- /dev/null
+++ b/apps/docs/content/guides/platform/migrating-to-supabase/neon.mdx
@@ -0,0 +1,90 @@
+---
+title: 'Migrate from Neon to Supabase'
+description: 'Migrate your existing Neon database to Supabase.'
+subtitle: 'Migrate your existing Neon database to Supabase.'
+---
+
+This guide demonstrates how to migrate your Neon database to Supabase to get the most out of Postgres while gaining access to all the features you need to build a project.
+
+## Retrieve your Neon database credentials [#retrieve-credentials]
+
+1. Log in to your Neon Console [https://console.neon.tech/login](https://console.neon.tech/login).
+1. Select **Projects** on the left.
+1. Click on your project in the list.
+1. From your Project Dashboard find your **Connection string** and click **Copy snippet** to copy it to the clipboard (do not check "pooled connection").
+
+Example:
+
+```bash
+postgresql://neondb_owner:xxxxxxxxxxxxxxx-random-word-yyyyyyyy.us-west-2.aws.neon.tech/neondb?sslmode=require
+```
+
+## Set your OLD_DB_URL environment variable
+
+Set the **OLD_DB_URL** environment variable at the command line using your Neon database credentials from the clipboard.
+
+Example:
+
+```bash
+export OLD_DB_URL="postgresql://neondb_owner:xxxxxxxxxxxxxxx-random-word-yyyyyyyy.us-west-2.aws.neon.tech/neondb?sslmode=require"
+```
+
+## Retrieve your Supabase connection string [#retrieve-supabase-connection-string]
+
+1. If you're new to Supabase, [create a project](https://supabase.com/dashboard).
+   Make a note of your password, you will need this later. If you forget it, you can [reset it here](https://supabase.com/dashboard/project/_/settings/database).
+
+1. Go to the [Database settings](https://supabase.com/dashboard/project/_/settings/database) for your project in the Supabase Dashboard.
+1. Under **Connection string**, select **URI**, make sure **Display connection pooler** is checked, and **Mode: Session** is set.
+1. Click the **Copy** button to the right of your connection string to copy it to the clipboard.
+
+## Set your NEW_DB_URL environment variable
+
+Set the **NEW_DB_URL** environment variable at the command line using your Supabase connection string. You will need to replace `[YOUR-PASSWORD]` with your actual database password.
+
+Example:
+
+```bash
+export NEW_DB_URL="postgresql://postgres.xxxxxxxxxxxxxxxxxxxx:[YOUR-PASSWORD]@aws-0-us-west-1.pooler.supabase.com:5432/postgres"
+```
+
+## Migrate the database
+
+You will need the [pg_dump](https://www.postgresql.org/docs/current/app-pgdump.html) and [psql](https://www.postgresql.org/docs/current/app-psql.html) command line tools, which are included in a full [PostgreSQL installation](https://www.postgresql.org/download).
+
+1. Export your database to a file in console
+
+   Use `pg_dump` with your Postgres credentials to export your database to a file (e.g., `dump.sql`).
+
+```bash
+pg_dump "$OLD_DB_URL" \
+  --clean \
+  --if-exists \
+  --quote-all-identifiers \
+  --no-owner \
+  --no-privileges \
+  > dump.sql
+```
+
+2. Import the database to your Supabase project
+
+   Use `psql` to import the Postgres database file to your Supabase project.
+
+   ```bash
+   psql -d "$NEW_DB_URL" -f dump.sql
+   ```
+
+Additional options
+
+- To only migrate a single database schema, add the `--schema=PATTERN` parameter to your `pg_dump` command.
+- To exclude a schema: `--exclude-schema=PATTERN`.
+- To only migrate a single table: `--table=PATTERN`.
+- To exclude a table: `--exclude-table=PATTERN`.
+
+Run `pg_dump --help` for a full list of options.
+
+<MigrationWarnings />
+
+## Enterprise
+
+[Contact us](https://forms.supabase.com/enterprise) if you need more help migrating your project.
diff --git a/apps/docs/public/img/icons/neon-icon-light.svg b/apps/docs/public/img/icons/neon-icon-light.svg
new file mode 100644
index 00000000000..c8906afd151
--- /dev/null
+++ b/apps/docs/public/img/icons/neon-icon-light.svg
@@ -0,0 +1,4 @@
+<svg width="58" height="57" viewBox="0 0 58 57" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M0 9.82759C0 4.39996 4.47705 0 9.99976 0H47.9989C53.5216 0 57.9986 4.39996 57.9986 9.82759V41.5893C57.9986 47.2045 50.7684 49.6414 47.2618 45.2082L36.2991 31.3488V48.1552C36.2991 53.04 32.2698 57 27.2993 57H9.99976C4.47705 57 0 52.6 0 47.1724V9.82759ZM9.99976 7.86207C8.89522 7.86207 7.99981 8.74206 7.99981 9.82759V47.1724C7.99981 48.2579 8.89522 49.1379 9.99976 49.1379H27.5993C28.1516 49.1379 28.2993 48.6979 28.2993 48.1552V25.6178C28.2993 20.0027 35.5295 17.5656 39.0361 21.9989L49.9988 35.8583V9.82759C49.9988 8.74206 50.1034 7.86207 48.9988 7.86207H9.99976Z" fill="#0C0D0D"/>
+<path d="M48.0003 0C53.523 0 58 4.39996 58 9.82759V41.5893C58 47.2045 50.7699 49.6414 47.2633 45.2082L36.3006 31.3488V48.1552C36.3006 53.04 32.2712 57 27.3008 57C27.8531 57 28.3008 56.56 28.3008 56.0172V25.6178C28.3008 20.0027 35.5309 17.5656 39.0375 21.9989L50.0002 35.8583V1.96552C50.0002 0.879992 49.1048 0 48.0003 0Z" fill="#0C0D0D"/>
+</svg>
diff --git a/apps/docs/public/img/icons/neon-icon.svg b/apps/docs/public/img/icons/neon-icon.svg
new file mode 100644
index 00000000000..7fb2f931cc4
--- /dev/null
+++ b/apps/docs/public/img/icons/neon-icon.svg
@@ -0,0 +1,4 @@
+<svg width="58" height="57" viewBox="0 0 58 57" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M0 9.82759C0 4.39996 4.47705 0 9.99976 0H47.9989C53.5216 0 57.9986 4.39996 57.9986 9.82759V41.5893C57.9986 47.2045 50.7684 49.6414 47.2618 45.2082L36.2991 31.3488V48.1552C36.2991 53.04 32.2698 57 27.2993 57H9.99976C4.47705 57 0 52.6 0 47.1724V9.82759ZM9.99976 7.86207C8.89522 7.86207 7.99981 8.74206 7.99981 9.82759V47.1724C7.99981 48.2579 8.89522 49.1379 9.99976 49.1379H27.5993C28.1516 49.1379 28.2993 48.6979 28.2993 48.1552V25.6178C28.2993 20.0027 35.5295 17.5656 39.0361 21.9989L49.9988 35.8583V9.82759C49.9988 8.74206 50.1034 7.86207 48.9988 7.86207H9.99976Z" fill="white"/>
+<path d="M48.0003 0C53.523 0 58 4.39996 58 9.82759V41.5893C58 47.2045 50.7699 49.6414 47.2633 45.2082L36.3006 31.3488V48.1552C36.3006 53.04 32.2712 57 27.3008 57C27.8531 57 28.3008 56.56 28.3008 56.0172V25.6178C28.3008 20.0027 35.5309 17.5656 39.0375 21.9989L50.0002 35.8583V1.96552C50.0002 0.879992 49.1048 0 48.0003 0Z" fill="white"/>
+</svg>