Add Neon Postgres to Deno Deploy docs (#314)

deploy/manual/neon-postgres.md

@@ -0,0 +1,96 @@
+# Connect to Neon Postgres
+
+This tutorial covers how to connect to a Neon Postgres database from an application
+deployed on Deno Deploy.
+
+You can find a more comprehensive tutorial that builds a sample application on
+top of Postgres [here](../tutorials/tutorial-postgres).
+
+## Setup Postgres
+
+> This tutorial will focus entirely on connecting to Postgres unencrypted. If
+> you would like to use encryption with a custom CA certificate, use the
+> documentation [here](https://deno-postgres.com/#/?id=ssltls-connection).
+
+To get started, we need to create a new Postgres instance for us to connect to.
+For this tutorial, we will be using [Neon Postgres](https://neon.tech/) as they
+provide free, managed Postgres instances. If you like to host your database
+somewhere else, you can do that too.
+
+1. Visit https://neon.tech/ and click **Sign up** to sign up with an email, Github, Google, or partner account. After signing up, you are directed to the Neon Console to create your first project.
+2.  Enter a name for your project, select a Postgres version, provide a database name, and select a region. Generally, you'll want to select the region closest to your application. When you're finished, click **Create project**.
+3. You are presented with the connection string for your new project, which you can use to connect to your database. Save the connection string, which looks something like this: 
+
+    ```sh
+    postgres://alex:[email protected]/dbname?sslmode=require
+    ```
+
+    You will need the connection string in the next step.
+
+## Create a project in Deno Deploy
+
+Next, let's create a project in Deno Deploy and set it up with the requisite
+environment variables:
+
+1. Go to [https://dash.deno.com/new](https://dash.deno.com/new) (Sign in with
+   GitHub if you didn't already) and click on **Create an empty project** under **Deploy your own code**.
+2. Now click on the **Settings** button available on the project page.
+3. Navigate to **Environment Variables** Section and add the following secret.
+
+- `DATABASE_URL` - The value should be set to the connection string you saved
+  in the last step.
+
+![postgres_env_variable](../docs-images/neon_postgres_env_variable.png)
+
+## Write code that connects to Postgres
+
+To read/write to Postgres, import the Postgres module, read the connection
+string from the environment variables, and create a connection pool.
+
+```ts
+import { Pool } from "https://deno.land/x/[email protected]/mod.ts";
+
+// Get the connection string from the environment variable "DATABASE_URL"
+const databaseUrl = Deno.env.get("DATABASE_URL")!;
+
+// Create a database pool with three connections that are lazily established
+const pool = new Pool(databaseUrl, 3, true);
+
+// Connect to the database
+const connection = await pool.connect();
+
+try {
+  // Create the table
+  await connection.queryObject`
+    CREATE TABLE IF NOT EXISTS todos (
+      id SERIAL PRIMARY KEY,
+      title TEXT NOT NULL
+    )
+  `;
+} finally {
+  // Release the connection back into the pool
+  connection.release();
+}
+```
+
+## Deploy application to Deno Deploy
+
+Once you have finished writing your application, you can deploy it on Deno
+Deploy.
+
+To do this, go back to your project page at
+`https://dash.deno.com/projects/<project-name>`.
+
+You should see a couple of options to deploy:
+
+- [Github integration](ci_github)
+- [`deployctl`](deployctl)
+  ```sh
+  deployctl deploy --project=<project-name> <application-file-name>
+  ```
+
+Unless you want to add a build step, we recommend that you select the GitHub
+integration.
+
+For more details on the different ways to deploy on Deno Deploy and the
+different configuration options, read [here](how-to-deploy).

deploy/tutorials/tutorial-postgres.md

@@ -41,8 +41,8 @@ POST /todos
 
 In this tutorial, we will be:
 
-- Creating and setting up a [Postgres](https://www.postgresql.org/) instance on
-  [Supabase](https://supabase.com).
+- Creating and setting up a [Postgres](https://www.postgresql.org/) instance 
+  on [Neon Postgres](https://neon.tech/) or [Supabase](https://supabase.com).
 - Using a [Deno Deploy](/deploy) Playground to develop and deploy the
   application.
 - Testing our application using [cURL](https://curl.se/).
@@ -54,10 +54,22 @@ In this tutorial, we will be:
 > documentation [here](https://deno-postgres.com/#/?id=ssltls-connection).
 
 To get started we need to create a new Postgres instance for us to connect to.
-For this tutorial we will be using [Supabase](https://supabase.com) as they
-provide free, managed Postgres instances. If you like to host your database
+For this tutorial, you can use either [Neon Postgres](https://neon.tech/) or [Supabase](https://supabase.com), as they
+both provide free, managed Postgres instances. If you like to host your database
 somewhere else, you can do that too.
 
+### Neon Postgres
+
+1. Visit https://neon.tech/ and click **Sign up** to sign up with an email, Github, Google, or partner account. After signing up, you are directed to the Neon Console to create your first project.
+2.  Enter a name for your project, select a Postgres version, provide a database name, and select a region. Generally, you'll want to select the region closest to your application. When you're finished, click **Create project**.
+3. You are presented with the connection string for your new project, which you can use to connect to your database. Save the connection string, which looks something like this: 
+
+    ```sh
+    postgres://alex:[email protected]/dbname?sslmode=require
+    ```
+
+### Supabase
+
 1. Visit https://app.supabase.io/ and click "New project".
 2. Select a name, password, and region for your database. Make sure to save the
    password, as you will need it later.

sidebars/deploy.js

@@ -102,6 +102,7 @@ const sidebars = {
         "manual/faunadb",
         "manual/firebase",
         "manual/postgres",
+        "manual/neon-postgres",
       ],
     },
     {