From a35cab02a925a802086a1999727a41af2da282c8 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 10:03:25 -0600
Subject: [PATCH 01/23] instructions for `batch-geocoder-node` and
 `attachments-node`

---
 README.md                             | 25 +++++++++++++++++++++++++
 samples/attachments-node/README.md    | 16 ++++++++++++++--
 samples/attachments-node/package.json |  1 +
 samples/batch-geocoder-node/README.md | 16 ++++++++++++++--
 4 files changed, 54 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 677372e..25b8880 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,26 @@
 # ArcGIS REST JS Samples
+
+## Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS while running one of the samples, follow these steps.
+
+1. In the ArcGIS REST JS directory, run these commands:
+
+   ```bash
+   npm install
+   npm run build
+   ```
+
+1. In this sample's directory, run these commands,
+
+   1. Replacing `..\..\path\to` with the path to where you have ArcGIS REST JS stored, and
+   2. Using the associated package folder(s) that are being used by the current sample (e.g. `packages\arcgis-rest-feature-service`, `packages\arcgis-rest-geocoding`, etc.)
+
+   ```bash
+   npm install
+   npm link ..\..\path\to\arcgis-rest-js\packages\arcgis-rest-feature-service\
+   ```
+
+Remember that you must run `npm run build` in the ArcGIS REST JS repository after making changes to see those changes when running the sample.
+
+To remove the link and use the package from NPM instead of the local one, run `npm install` in the sample folder again.
diff --git a/samples/attachments-node/README.md b/samples/attachments-node/README.md
index 9198b0e..2dc57fd 100644
--- a/samples/attachments-node/README.md
+++ b/samples/attachments-node/README.md
@@ -1,4 +1,16 @@
 # Native JavaScript Modules in Node.js
 
-1. Run `npm run build` in the root directory
-1. Run `npm start` to make a require and log output.
+## Running this demo
+
+First run `npm install` to install the dependencies.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-feature-service`
+
+### Other Steps
+
+Run `npm start` to make a require and log output.
diff --git a/samples/attachments-node/package.json b/samples/attachments-node/package.json
index fc005ee..dc15d22 100644
--- a/samples/attachments-node/package.json
+++ b/samples/attachments-node/package.json
@@ -12,6 +12,7 @@
   },
   "dependencies": {
     "@esri/arcgis-rest-request": "^4.0.0",
+    "@esri/arcgis-rest-feature-service": "^4.0.0",
     "fetch-blob": "^3.1.2",
     "mime": "^2.5.2",
     "mime-types": "^2.1.32"
diff --git a/samples/batch-geocoder-node/README.md b/samples/batch-geocoder-node/README.md
index bd18a71..5a60124 100644
--- a/samples/batch-geocoder-node/README.md
+++ b/samples/batch-geocoder-node/README.md
@@ -1,6 +1,18 @@
-# Running this demo
+# Batch Geocoder (Node)
+
+## Running this demo
+
+First run `npm install` to install the dependencies.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-geocoding`
+
+### Other Steps
 
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
 2. Create and register a [new application](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/accessing-arcgis-online-services/).
 3. Replace values in [config-template.js](/demos/batch-geocoder-node/config-template.js) and rename to `config.js`
    1. `"clientId"`: ArcGIS ClientId

From 0443dfc1aeb1d5b35686d14c4d69a5b16cd9f485 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 10:33:44 -0600
Subject: [PATCH 02/23] fix example ID

---
 samples/attachments-browser/index.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/samples/attachments-browser/index.html b/samples/attachments-browser/index.html
index 382b833..93f88ba 100644
--- a/samples/attachments-browser/index.html
+++ b/samples/attachments-browser/index.html
@@ -15,7 +15,7 @@ <h3>Attachments</h3>
         </div>
         <div class="form-group">
           <label for="featureId">Feature ID</label>
-          <input type="number" min="0" step="1" id="featureId" name="featureId" class="form-control" value="8254973" required>
+          <input type="number" min="0" step="1" id="featureId" name="featureId" class="form-control" value="21502403" required>
         </div>
         <div class="form-group">
           <button type="submit" class="btn"><span class="glyphicon glyphicon-paperclip" aria-hidden="true"></span> Get Attachments</button>

From 5870941b0b221be3bbaac887b908b1ab5caa5730 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 10:34:07 -0600
Subject: [PATCH 03/23] move script to <head>

---
 samples/attachments-browser/index.html   | 15 +++++++++------
 samples/attachments-browser/package.json | 15 ---------------
 2 files changed, 9 insertions(+), 21 deletions(-)
 delete mode 100644 samples/attachments-browser/package.json

diff --git a/samples/attachments-browser/index.html b/samples/attachments-browser/index.html
index 93f88ba..f71f3ba 100644
--- a/samples/attachments-browser/index.html
+++ b/samples/attachments-browser/index.html
@@ -1,8 +1,15 @@
 <!DOCTYPE html>
 <html>
-<title>Attachments</title>
+  <head>
 
-<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
+    <title>Attachments</title>
+    
+    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
+
+    <script src="https://rawgit.com/kriszyp/put-selector/master/put.js"></script>
+    <script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+    <script src="https://unpkg.com/@esri/arcgis-rest-feature-service/dist/bundled/feature-service.umd.js"></script>
+  </head>
 
 <div class="container-fluid">
   <div class="row">
@@ -53,10 +60,6 @@ <h3>Attachments</h3>
   </div>
 </div>
 
-<script src="https://rawgit.com/kriszyp/put-selector/master/put.js"></script>
-<script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
-<script src="@esri/arcgis-rest-feature-service/dist/bundled/feature-service.umd.js"></script>
-
 <script>
   let serviceUrl, featureId;
 
diff --git a/samples/attachments-browser/package.json b/samples/attachments-browser/package.json
deleted file mode 100644
index c83d7ff..0000000
--- a/samples/attachments-browser/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
-  "private": true,
-  "name": "attachments",
-  "version": "3.3.0",
-  "description": "Vanilla JavaScript demo of attachment methods of @esri/arcgis-rest-feature-service",
-  "license": "Apache-2.0",
-  "scripts": {
-    "start": "node ../../scripts/run-demo-server.js"
-  },
-  "dependencies": {
-    "@esri/arcgis-rest-feature-service": "^4.0.1",
-    "@esri/arcgis-rest-request": "^4.0.0"
-  },
-  "author": ""
-}

From ce5a1143488be465022cbb98f91f0b7a9f2b7bd8 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 10:43:34 -0600
Subject: [PATCH 04/23] adding browser instructions

---
 README.md                             | 30 ++++++++++++++++++++++++++-
 samples/attachments-browser/README.md | 14 +++++++++----
 samples/attachments-node/README.md    |  2 +-
 samples/batch-geocoder-node/README.md |  2 +-
 4 files changed, 41 insertions(+), 7 deletions(-)

diff --git a/README.md b/README.md
index 25b8880..36f39ee 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,10 @@
 
 If you'd like to use a local version of ArcGIS REST JS while running one of the samples, follow these steps.
 
+### Local ArcGIS REST JS (NPM)
+
+For samples that use NPM to install ArcGIS REST JS as a dependency, follow these steps.
+
 1. In the ArcGIS REST JS directory, run these commands:
 
    ```bash
@@ -11,7 +15,7 @@ If you'd like to use a local version of ArcGIS REST JS while running one of the
    npm run build
    ```
 
-1. In this sample's directory, run these commands,
+2. In this sample's directory, run these commands,
 
    1. Replacing `..\..\path\to` with the path to where you have ArcGIS REST JS stored, and
    2. Using the associated package folder(s) that are being used by the current sample (e.g. `packages\arcgis-rest-feature-service`, `packages\arcgis-rest-geocoding`, etc.)
@@ -24,3 +28,27 @@ If you'd like to use a local version of ArcGIS REST JS while running one of the
 Remember that you must run `npm run build` in the ArcGIS REST JS repository after making changes to see those changes when running the sample.
 
 To remove the link and use the package from NPM instead of the local one, run `npm install` in the sample folder again.
+
+### Local ArcGIS REST JS (Browser)
+
+For samples that use a `<script>` tag to reference ArcGIS REST JS in the browser, follow these steps.
+
+1. In the ArcGIS REST JS directory, run these commands. This will run a local server hosting ArcGIS REST JS.
+
+   ```bash
+   npm install
+   npm run build
+   node .\scripts\run-demo-server.js
+   ```
+
+2. In this sample's directory, in the HTML file code, change the `<script>` tag(s) from `https://unpkg.com` to `https://localhost:8080` (or whatever port is used in step 1). For example, change this:
+
+   ```html
+   <script src="https://unpkg.com/@esri/arcgis-rest-feature-service/dist/bundled/feature-service.umd.js"></script>
+   ```
+
+   ... to this:
+
+   ```html
+   <script src="https://localhost:8080/@esri/arcgis-rest-feature-service/dist/bundled/feature-service.umd.js"></script>
+   ```
diff --git a/samples/attachments-browser/README.md b/samples/attachments-browser/README.md
index 1670b1f..ca2b8bc 100644
--- a/samples/attachments-browser/README.md
+++ b/samples/attachments-browser/README.md
@@ -1,7 +1,13 @@
 # Running this demo
 
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
-1. `npm start`
-1. Visit http://localhost:8080
+This sample is fully in the browser. You do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
-**Note:** The server starts with a special configuration to serve URLs starting with `@esri/arcgis-rest-*` from their respective packages. In your application you will need to change these URLs to point to their respective locations.
+```bash
+npx serve
+```
+
+## Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
+
+- `index.html`
diff --git a/samples/attachments-node/README.md b/samples/attachments-node/README.md
index 2dc57fd..a1f25e6 100644
--- a/samples/attachments-node/README.md
+++ b/samples/attachments-node/README.md
@@ -6,7 +6,7 @@ First run `npm install` to install the dependencies.
 
 ### Local ArcGIS REST JS
 
-If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js), referencing these packages that this sample uses as necessary:
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
 
 - `arcgis-rest-request`
 - `arcgis-rest-feature-service`
diff --git a/samples/batch-geocoder-node/README.md b/samples/batch-geocoder-node/README.md
index 5a60124..e739974 100644
--- a/samples/batch-geocoder-node/README.md
+++ b/samples/batch-geocoder-node/README.md
@@ -6,7 +6,7 @@ First run `npm install` to install the dependencies.
 
 ### Local ArcGIS REST JS
 
-If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js), referencing these packages that this sample uses as necessary:
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
 
 - `arcgis-rest-request`
 - `arcgis-rest-geocoding`

From 6c77968904eb360508d7e13665b428efd1796998 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 12:33:33 -0600
Subject: [PATCH 05/23] readme title

---
 samples/attachments-browser/README.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/samples/attachments-browser/README.md b/samples/attachments-browser/README.md
index ca2b8bc..558c811 100644
--- a/samples/attachments-browser/README.md
+++ b/samples/attachments-browser/README.md
@@ -1,12 +1,14 @@
-# Running this demo
+# Attachments Browser
 
-This sample is fully in the browser. You do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
+## Running this demo
+
+For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
 ```bash
 npx serve
 ```
 
-## Local ArcGIS REST JS
+### Local ArcGIS REST JS
 
 If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
 

From fa87e6489405fab70d626b964c430d0101a00d99 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 12:35:39 -0600
Subject: [PATCH 06/23] instructions - browser-es-modules

---
 samples/browser-es-modules/README.md    | 16 ++++--
 samples/browser-es-modules/index.html   | 76 +++++++++++++------------
 samples/browser-es-modules/package.json | 15 -----
 3 files changed, 52 insertions(+), 55 deletions(-)
 delete mode 100644 samples/browser-es-modules/package.json

diff --git a/samples/browser-es-modules/README.md b/samples/browser-es-modules/README.md
index 2af95b1..8df3e8a 100644
--- a/samples/browser-es-modules/README.md
+++ b/samples/browser-es-modules/README.md
@@ -1,7 +1,15 @@
 # ArcGIS REST JS + Native Browser Modules
 
-1. Run `npm run build` in the root directory
-1. Run `npm start` to spin up the development server.
-1. Visit [http://localhost:8080](http://localhost:8080).
+## Running this demo
 
-**Note:** The server starts with a special configuration to serve URLs starting with `@esri/arcgis-rest-*` from their respective packages. In your application you will need to change these URLs to point to their respective locations.
+For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
+
+```bash
+npx serve
+```
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
+
+- `index.html`
diff --git a/samples/browser-es-modules/index.html b/samples/browser-es-modules/index.html
index 941101d..bffd6a8 100644
--- a/samples/browser-es-modules/index.html
+++ b/samples/browser-es-modules/index.html
@@ -1,38 +1,42 @@
 <!DOCTYPE html>
 <html lang="en">
-
-<head>
-  <meta charset="utf-8">
-  <title>ArcGIS REST JS Browser w/ Modules</title>
-  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css"
-    integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
-
-</head>
-
-<body>
-  <!-- Load the ES Modules Polyfill so we can use importmap in FF and Safari -->
-  <script async src="https://unpkg.com/es-module-shims@0.13.1/dist/es-module-shims.js"></script>
-
-  <!-- Map package imports to URLS starting with @esri/... which will get served from the local build of the modules -->
-  <script type="importmap">
-  {
-    "imports": {
-      "@esri/arcgis-rest-request": "/@esri/arcgis-rest-request/dist/bundled/request.esm.js",
-      "@esri/arcgis-rest-portal": "/@esri/arcgis-rest-portal/dist/bundled/portal.esm.js"
-    }
-  }
-  </script>
-
-  <script type="module">
-    import { searchItems } from "@esri/arcgis-rest-portal";
-
-    let element = document.createElement("pre");
-    document.body.appendChild(element);
-
-    searchItems("water").then((response) => {
-      element.textContent = JSON.stringify(response, null, 2); // false
-    });
-  </script>
-</body>
-
-</html>
\ No newline at end of file
+  <head>
+    <meta charset="utf-8" />
+    <title>ArcGIS REST JS Browser w/ Modules</title>
+    <link
+      rel="stylesheet"
+      href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css"
+      integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u"
+      crossorigin="anonymous"
+    />
+  </head>
+
+  <body>
+    <!-- Load the ES Modules Polyfill so we can use importmap in FF and Safari -->
+    <script
+      async
+      src="https://unpkg.com/es-module-shims@0.13.1/dist/es-module-shims.js"
+    ></script>
+
+    <!-- Map package imports to URLS starting with @esri/... which will get served from the local build of the modules -->
+    <script type="importmap">
+      {
+        "imports": {
+          "@esri/arcgis-rest-request": "https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.esm.js",
+          "@esri/arcgis-rest-portal": "https://unpkg.com/@esri/arcgis-rest-portal/dist/bundled/portal.esm.js"
+        }
+      }
+    </script>
+
+    <script type="module">
+      import { searchItems } from "@esri/arcgis-rest-portal";
+
+      let element = document.createElement("pre");
+      document.body.appendChild(element);
+
+      searchItems("water").then((response) => {
+        element.textContent = JSON.stringify(response, null, 2); // false
+      });
+    </script>
+  </body>
+</html>
diff --git a/samples/browser-es-modules/package.json b/samples/browser-es-modules/package.json
deleted file mode 100644
index b25e79f..0000000
--- a/samples/browser-es-modules/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
-  "private": true,
-  "name": "@esri/arcgis-rest-demo-browser-es-modules",
-  "version": "3.3.0",
-  "description": "Vanilla JavaScript demo of @esri/arcgis-rest-* packages",
-  "license": "Apache-2.0",
-  "scripts": {
-    "start": "node ../../scripts/run-demo-server.js"
-  },
-  "dependencies": {
-    "@esri/arcgis-rest-portal": "^4.0.0",
-    "@esri/arcgis-rest-request": "^4.0.0"
-  },
-  "author": ""
-}

From 8214cbde8bf5e485c6079f8a23f730b10b16a86f Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 13:07:31 -0600
Subject: [PATCH 07/23] instructions for deno sample

---
 samples/deno/README.md       | 30 +++++++++++++++++++++++++++---
 samples/deno/import_map.json | 16 ++++++++--------
 2 files changed, 35 insertions(+), 11 deletions(-)

diff --git a/samples/deno/README.md b/samples/deno/README.md
index 9772c97..a90052b 100644
--- a/samples/deno/README.md
+++ b/samples/deno/README.md
@@ -1,9 +1,33 @@
 # ArcGIS REST JS + Deno
 
-ArcGIS REST JS is fully compatible with Deno. You can import the packages from the [esm.run CDN](https://www.jsdelivr.com/esm) for the easiest use. This demo shows importing from a local install with an import map.
+## Running this demo
 
-You can run this demo with:
+ArcGIS REST JS is fully compatible with Deno. You can run this demo with:
 
 ```
-deno run --allow-net --import-map ./import_map.json index.js
+deno run --allow-net --allow-import --import-map ./import_map.json index.js
+```
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow these steps.
+
+1. In the ArcGIS REST JS directory, run these commands. This will run a local server hosting ArcGIS REST JS.
+
+```bash
+npm install
+npm run build
+node .\scripts\run-demo-server.js
+```
+
+2. In this sample's directory, update `import_map.json` with relative paths to the files on your computer. For example replace this:
+
+```json
+"https://esm.run/@esri/arcgis-rest-form-data/browser-ponyfill.mjs"
+```
+
+... with this:
+
+```json
+"../../path/to/arcgis-rest-js/packages/arcgis-rest-form-data/browser-ponyfill.mjs"
 ```
diff --git a/samples/deno/import_map.json b/samples/deno/import_map.json
index f667e41..96d8dd1 100644
--- a/samples/deno/import_map.json
+++ b/samples/deno/import_map.json
@@ -1,8 +1,8 @@
-  {
-    "imports": {
-      "@esri/arcgis-rest-form-data": "../../packages/arcgis-rest-form-data/browser-ponyfill.mjs",
-      "@esri/arcgis-rest-fetch": "../../packages/arcgis-rest-fetch/browser-ponyfill.mjs",
-      "@esri/arcgis-rest-request": "../../packages/arcgis-rest-request/dist/esm/index.js",
-      "@esri/arcgis-rest-portal": "../../packages/arcgis-rest-portal/dist/esm/index.js"
-    }
-  }
\ No newline at end of file
+{
+  "imports": {
+    "@esri/arcgis-rest-form-data": "https://esm.run/@esri/arcgis-rest-form-data/browser-ponyfill.mjs",
+    "@esri/arcgis-rest-fetch": "https://esm.run/@esri/arcgis-rest-fetch/browser-ponyfill.mjs",
+    "@esri/arcgis-rest-request": "https://esm.run/@esri/arcgis-rest-request/dist/esm/index.js",
+    "@esri/arcgis-rest-portal": "https://esm.run/@esri/arcgis-rest-portal/dist/esm/index.js"
+  }
+}

From 494ec6c97cbe65642b0f5bfba0d0690fcd4db861 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 13:20:57 -0600
Subject: [PATCH 08/23] instructions for `dev-credentials-client`

---
 samples/dev-credentials-client/README.md | 36 +++++++++---------------
 1 file changed, 14 insertions(+), 22 deletions(-)

diff --git a/samples/dev-credentials-client/README.md b/samples/dev-credentials-client/README.md
index c45e335..ddf1e7c 100644
--- a/samples/dev-credentials-client/README.md
+++ b/samples/dev-credentials-client/README.md
@@ -2,33 +2,25 @@
 
 This page will show API key and OAuth 2.0 app CRUD demo with help of `arcgis-rest-developer-credentials` package. First
 step requires a user to log in
-via [Authenticate with an ArcGIS identity](https://developers.arcgis.com/arcgis-rest-js/authentication/tutorials/authenticate-with-an-arcgis-identity-rest-js-browser/).
+via [Authenticate with an ArcGIS identity](https://developers.arcgis.com/arcgis-rest-js/authentication/tutorials/sign-in-with-user-authentication-browser/).
 Then you can use the form to create an API key or switch to the OAuth 2.0 form to create an OAuth 2.0 app.
 Once you've created an API key or OAuth 2.0 app, you can click on the item in the table below the form to edit it.
 
 ## Running this demo
 
-1. Run `npm run build` in the repository's root directory.
-2. Go into `demos/dev-credentials-client` and run `npm start` to spin up the development server.
-3. Visit [http://localhost:8080](http://localhost:8080).
+First run `npm install` to install the dependencies.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-developer-credentials`
 
 ## Additional tools used
 
-<table>
-  <tr>
-    <th>Description</th>
-    <th>Tool</th>
-  </tr>
-  <tr>
-    <td>Enhanced Multi-Select</td>
-    <td><a href="https://select2.org/">Select2</a></td>
-  </tr>
-  <tr>
-    <td>Table</td>
-    <td><a href="https://datatables.net/">jQuery Data Table</a></td>
-  </tr>
-  <tr>
-    <td>Others</td>
-    <td>jQuery 3, Bootstrap 5</td>
-  </tr>
-</table>
\ No newline at end of file
+| Description           | Tool                                        |
+| --------------------- | ------------------------------------------- |
+| Enhanced Multi-Select | [Select2](https://select2.org)              |
+| Table                 | [jQuery Data Table](https://datatables.net) |
+| Others                | jQuery 3, Bootstrap 5                       |

From 0d739c0aa4b2544e72f572f5af458dd09887976c Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 13:38:58 -0600
Subject: [PATCH 09/23] express instructions

---
 samples/express/README.md | 22 +++++++++++++---------
 1 file changed, 13 insertions(+), 9 deletions(-)

diff --git a/samples/express/README.md b/samples/express/README.md
index 2c484d7..0a22465 100644
--- a/samples/express/README.md
+++ b/samples/express/README.md
@@ -1,16 +1,20 @@
 # ArcGIS REST JS Express Demo
 
-This demo explains how to trigger OAuth 2.0 via custom server-side code
+This sample shows how to trigger OAuth 2.0 via custom server-side code.
 
-## Setup
+## Running this demo
 
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
-2. Create a new application on https://developers.arcgis.com
+1. In this sample's directory, run `npm install` to install the dependencies.
+2. Create a new application on <https://developers.arcgis.com> (New Item > Developer Credentials > OAuth 2.0 credentials).
 3. Add `http://localhost:3000/authenticate` as a redirect uri for your application.
-4. Copy the `config.json.template` file, rename it to `config.json`
-5. Copy your application's client id into your new `config.json` file.
+4. Copy the `config.json.template` file, rename it to `config.json`.
+5. Copy your application's client ID into your new `config.json` file.
+6. In the terminal, run `npm start`.
+7. Visit <http://localhost:3000/authorize> to start the OAuth 2.0 process.
 
-## Running the demo
+### Local ArcGIS REST JS
 
-6. `npm start`
-7. Visit http://localhost:3000/authorize to start the OAuth 2.0 process.
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-developer-credentials`

From a020239a9ddd94b026d628de3514dfb30d95f8df Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 13:51:40 -0600
Subject: [PATCH 10/23] instructions

---
 samples/express-oauth-advanced/README.md | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/samples/express-oauth-advanced/README.md b/samples/express-oauth-advanced/README.md
index 1c7a161..1fdc6ee 100644
--- a/samples/express-oauth-advanced/README.md
+++ b/samples/express-oauth-advanced/README.md
@@ -21,22 +21,28 @@ Using long lived sessions on the server also means that the server can perform b
 
 These instructions are for setting up the demo using credentials setup by the ArcGIS REST JS team.
 
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
+1. In this sample's directory, run `npm install` to install the dependencies.
 1. Copy `.env.template` to `.env`
 1. Run `npm run start`
-1. Visit http://localhost:3000 to start.
+1. Visit <http://localhost:3000> to start.
 
 ## Setup with your own credentials
 
 These instructions are for setting up the demo using credentials setup by the ArcGIS REST JS team.
 
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
+1. In this sample's directory, run `npm install` to install the dependencies.
 1. Copy `.env.template` to `.env`
 1. [Register an app](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/register-your-application/) and copy the Client ID into `.env` in the `CLIENT_ID` property.
 1. [Add redirect URIs](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/add-redirect-uri/) for `http://localhost:3000/authenticate` to your registered application.
-1. Replace the `ENCRYPTION_KEY` and `SESSION_SECRET` values with new values. You can use a website like https://randomkeygen.com/ to generate new strong keys.
+1. Replace the `ENCRYPTION_KEY` and `SESSION_SECRET` values with new values. You can use a website like <https://randomkeygen.com/> to generate new strong keys.
 1. Run `npm run start`
-1. Visit http://localhost:3000 to start.
+1. Visit <http://localhost:3000> to start.
+
+## Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
 
 ## How it works
 

From e2138082175caf254ffd7b048ea37aff11af8bb6 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 13:56:33 -0600
Subject: [PATCH 11/23] instructions for demo

---
 samples/feature-service-browser/README.md    | 22 +++++++++++++++-----
 samples/feature-service-browser/index.html   | 10 +++++----
 samples/feature-service-browser/package.json | 15 -------------
 3 files changed, 23 insertions(+), 24 deletions(-)
 delete mode 100644 samples/feature-service-browser/package.json

diff --git a/samples/feature-service-browser/README.md b/samples/feature-service-browser/README.md
index 1f28ddb..0f18545 100644
--- a/samples/feature-service-browser/README.md
+++ b/samples/feature-service-browser/README.md
@@ -1,8 +1,20 @@
-# Running this demo
+# Feature Service (Browser)
 
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
-1. `npm start`
-1. Visit http://localhost:8080
+## Running this demo
+
+For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
+
+```bash
+npx serve
+```
+
+Then:
+
+1. Visit <http://localhost:8080>
 1. Enter a search term and click "Search" to see results
 
-**Note:** The server starts with a special configuration to serve URLs starting with `@esri/arcgis-rest-*` from their respective packages. In your application you will need to change these URLs to point to their respective locations.
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
+
+- `index.html`
diff --git a/samples/feature-service-browser/index.html b/samples/feature-service-browser/index.html
index a1d7cf8..95e884b 100644
--- a/samples/feature-service-browser/index.html
+++ b/samples/feature-service-browser/index.html
@@ -2,6 +2,10 @@
 <html>
 <head>
 <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
+
+<!-- load arcgis rest libraries -->
+<script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+<script src="https://unpkg.com/@esri/arcgis-rest-feature-service/dist/bundled/feature-service.umd.js"></script>
 </head>
 <body>
 
@@ -49,16 +53,14 @@ <h1>query features!</h1>
         <tbody id="tableBody">
         </tbody>
       </table>
-      <p id="suggestedTermsMessage">Try 'elm' or 'oak' for <strong>Type</strong>. Try 'fair' or 'good' for <strong>Condition</strong>.</p id="suggestedTermsMessage">
+      <p id="suggestedTermsMessage">Try 'elm' or 'oak' for <strong>Type</strong>. Try 'fair' or 'good' for <strong>Condition</strong>.</p>
       <p id="recordCountMessage"></p>
       <p id="additionalRowsMessage" style="display: none" class="alert alert-warning">There are additional rows that meet your query criteria.</p>
     </div>
   </div>
 </div>
 
-<!-- load arcgis rest libraries -->
-<script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
-<script src="@esri/arcgis-rest-feature-service/dist/bundled/feature-service.umd.js"></script>
+
 
 <script>
   // respond when a user fills out the query form and
diff --git a/samples/feature-service-browser/package.json b/samples/feature-service-browser/package.json
deleted file mode 100644
index b6d8bed..0000000
--- a/samples/feature-service-browser/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
-  "private": true,
-  "name": "feature-service-browser",
-  "version": "3.3.0",
-  "description": "Vanilla JavaScript demo of @esri/arcgis-rest-feature-service",
-  "license": "Apache-2.0",
-  "scripts": {
-    "start": "node ../../scripts/run-demo-server.js"
-  },
-  "dependencies": {
-    "@esri/arcgis-rest-feature-service": "^4.0.1",
-    "@esri/arcgis-rest-request": "^4.0.0"
-  },
-  "author": ""
-}

From 3c60b3d7c357766c4d6c5e28a3faabbff218df34 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 14:13:52 -0600
Subject: [PATCH 12/23] instructions - geocoder browser

---
 samples/geocoder-browser/README.md         | 32 ++++++++++++++--------
 samples/geocoder-browser/authenticate.html |  2 +-
 samples/geocoder-browser/index.html        | 17 ++++++------
 samples/geocoder-browser/package.json      | 15 ----------
 4 files changed, 30 insertions(+), 36 deletions(-)
 delete mode 100644 samples/geocoder-browser/package.json

diff --git a/samples/geocoder-browser/README.md b/samples/geocoder-browser/README.md
index 3769a32..b46f4f7 100644
--- a/samples/geocoder-browser/README.md
+++ b/samples/geocoder-browser/README.md
@@ -1,12 +1,20 @@
-# Running this demo
-
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
-2. Register a new app on https://developers.arcgis.com
-3. Add a redirect URL of `https://localhost:8080/authenticate.html` to your app.
-4. Copy the `config.js.template` file, rename it to `config.js`
-5. Copy your apps client id into your new `config.js` file.
-6. `npm start`
-7. Visit https://localhost:8080 and click "Sign In" to start the OAuth 2.0 process.
-8. Start clicking buttons to send off authenticated geocoding requests.
-
-**Note:** The server starts with a special configuration to serve URLs starting with `@esri/arcgis-rest-*` from their respective packages. In your application you will need to change these URLs to point to their respective locations.
+# Geocode (Browser)
+
+## Running this demo
+
+For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
+
+1. Register a new app on <https://developers.arcgis.com>
+2. Add a redirect URL of `http://localhost:3000` to your app.
+3. Copy the `config.js.template` file, rename it to `config.js`
+4. Copy your app's client id into your new `config.js` file.
+5. In the terminal, run `npx serve`
+6. Visit <https://localhost:3000> and click "Sign In" to start the OAuth 2.0 process.
+7. Start clicking buttons to send off authenticated geocoding requests.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
+
+- `index.html`
+- `authenticate.html`
diff --git a/samples/geocoder-browser/authenticate.html b/samples/geocoder-browser/authenticate.html
index b84eedb..f975240 100644
--- a/samples/geocoder-browser/authenticate.html
+++ b/samples/geocoder-browser/authenticate.html
@@ -5,7 +5,7 @@
     <title>ArcGIS Rest JS OAuth redirect</title>
   </head>
   <body>
-    <script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+    <script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
     <script src="config.js"></script>
 
     <script>
diff --git a/samples/geocoder-browser/index.html b/samples/geocoder-browser/index.html
index 9bfc58e..40d093a 100644
--- a/samples/geocoder-browser/index.html
+++ b/samples/geocoder-browser/index.html
@@ -2,6 +2,11 @@
 <html>
 <head>
 <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
+
+<script src="config.js"></script>
+<script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+<script src="https://unpkg.com/@esri/arcgis-rest-geocoding/dist/bundled/geocoding.umd.js"></script>
+
 </head>
 <body>
 
@@ -24,15 +29,15 @@ <h1>get to geocodin!</h1>
         </p>
 
         <p>
-            <input id="geocodeInput" value="123 main st"></input>
+            <input type="text" id="geocodeInput" value="123 main st" />
             <button class="btn btn-default" id="geocode" role="button">geocode an address</button>
         <p>
-            <input id="suggestInput" value="World Tr"></input>
+            <input type="text" id="suggestInput" value="World Tr" />
             <button class="btn btn-default" id="suggest" role="button">get address suggestion</button>
         </p>
 
         <p>
-            <input id="reverseInput" value="{x:-118,y:34}"></input>
+            <input type="text" id="reverseInput" value="{x:-118,y:34}" />
             <button class="btn btn-default" id="reverse" role="button">determine address</button>
         </p>
 
@@ -42,10 +47,6 @@ <h1>get to geocodin!</h1>
     </div>
 </div>
 
-<script src="config.js"></script>
-<script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
-<script src="@esri/arcgis-rest-geocoding/dist/bundled/geocoding.umd.js"></script>
-
 <script>
 var auth;
 
@@ -55,7 +56,7 @@ <h1>get to geocodin!</h1>
 authBtn.addEventListener('click', function (e) {
   arcgisRest.ArcGISIdentityManager.beginOAuth2({
     clientId: ClientId,
-    redirectUri: "https://localhost:8080/authenticate.html",
+    redirectUri: window.location.href + "/authenticate",
     popup: true,
     portal: "https://www.arcgis.com/sharing/rest"
   }).then((session) => {
diff --git a/samples/geocoder-browser/package.json b/samples/geocoder-browser/package.json
deleted file mode 100644
index 01c2286..0000000
--- a/samples/geocoder-browser/package.json
+++ /dev/null
@@ -1,15 +0,0 @@
-{
-  "private": true,
-  "name": "@esri/arcgis-rest-geocoder-vanilla",
-  "version": "3.3.0",
-  "description": "Vanilla JavaScript demo of @esri/arcgis-rest-geocoder",
-  "license": "Apache-2.0",
-  "scripts": {
-    "start": "node ../../scripts/run-demo-server.js"
-  },
-  "dependencies": {
-    "@esri/arcgis-rest-geocoding": "beta",
-    "@esri/arcgis-rest-request": "beta"
-  },
-  "author": ""
-}

From 6d441239da25a9faabb8f6085e7a80331e74ed80 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 14:17:52 -0600
Subject: [PATCH 13/23] instructions - job sample

---
 samples/job/.gitignore    |   2 -
 samples/job/index.html    |  20 ++++----
 samples/job/package.json  |  22 --------
 samples/job/readme.md     |  17 +++++--
 samples/job/tsconfig.json | 104 --------------------------------------
 5 files changed, 22 insertions(+), 143 deletions(-)
 delete mode 100644 samples/job/.gitignore
 delete mode 100644 samples/job/package.json
 delete mode 100644 samples/job/tsconfig.json

diff --git a/samples/job/.gitignore b/samples/job/.gitignore
deleted file mode 100644
index 28a76bc..0000000
--- a/samples/job/.gitignore
+++ /dev/null
@@ -1,2 +0,0 @@
-node_modules
-env
\ No newline at end of file
diff --git a/samples/job/index.html b/samples/job/index.html
index 51680cc..98141ec 100644
--- a/samples/job/index.html
+++ b/samples/job/index.html
@@ -6,15 +6,6 @@
   <title>ArcGIS REST JS Browser w/ Modules</title>
   <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.1/dist/css/bootstrap.min.css" rel="stylesheet"
     integrity="sha384-iYQeCzEYFbKjA/T2uDLTpkwGzCiq6soy8tYaI1GyVh/UjpbCx/TYkiZhlZB6+fzT" crossorigin="anonymous">
-</head>
-
-<body>
-  <div class="container-md mt-5">
-    <h1>Messages</h1>
-    <pre class="bg-light border p-3"><code id="messages"></code></pre>
-    <h1>Results</h1>
-    <pre class="bg-light border p-3"><code id="results"></code></pre>
-  </div>
 
   <!-- Load the ES Modules Polyfill so we can use importmap in FF and Safari -->
   <script async src="https://ga.jspm.io/npm:es-module-shims@1.5.18/dist/es-module-shims.js"></script>
@@ -23,10 +14,19 @@ <h1>Results</h1>
   <script type="importmap">
   {
     "imports": {
-      "@esri/arcgis-rest-request": "/@esri/arcgis-rest-request/dist/bundled/request.esm.js"
+      "@esri/arcgis-rest-request": "https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.esm.js"
     }
   }
   </script>
+</head>
+
+<body>
+  <div class="container-md mt-5">
+    <h1>Messages</h1>
+    <pre class="bg-light border p-3"><code id="messages"></code></pre>
+    <h1>Results</h1>
+    <pre class="bg-light border p-3"><code id="results"></code></pre>
+  </div>
 
   <script type="module">
     import { Job, JOB_STATUSES } from "@esri/arcgis-rest-request";
diff --git a/samples/job/package.json b/samples/job/package.json
deleted file mode 100644
index 86609d1..0000000
--- a/samples/job/package.json
+++ /dev/null
@@ -1,22 +0,0 @@
-{
-  "private": true,
-  "name": "job",
-  "version": "1.0.0",
-  "description": "Job Task",
-  "license": "Apache-2.0",
-  "keywords": [
-    "ES6",
-    "arcgis",
-    "esri",
-    "job"
-  ],
-  "type": "module",
-  "main": "index.js",
-  "scripts": {
-    "start": "node ../../scripts/run-demo-server.js"
-  },
-  "dependencies": {
-    "@esri/arcgis-rest-request": "^4.0.3"
-  },
-  "author": "Marcy Silverman <msilverman@esri.com> (http://marcysilverman.com/)"
-}
diff --git a/samples/job/readme.md b/samples/job/readme.md
index 9560790..0c37e59 100644
--- a/samples/job/readme.md
+++ b/samples/job/readme.md
@@ -2,9 +2,16 @@
 
 This demo shows how to use the `Job` class to submit a job and retrieve the results.
 
-## Setup
+## Running this demo
 
-1. First `npm run build` in the ArcGIS REST JS root folder to setup the dependencies.
-3. Job has a `submitJob()` function that takes url, params, and authentication parameters. The response from this method returns an instance of the `Job` class.
-4. To retrieve results, call `getAllResults()` in your `Job` instance which will check to see if the job is completed and returns the results if so.
-5. In the terminal, run `npm start`.
\ No newline at end of file
+For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
+
+```bash
+npx serve
+```
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
+
+- `index.html`
diff --git a/samples/job/tsconfig.json b/samples/job/tsconfig.json
deleted file mode 100644
index ef1ce98..0000000
--- a/samples/job/tsconfig.json
+++ /dev/null
@@ -1,104 +0,0 @@
-{
-  "compilerOptions": {
-    /* Visit https://aka.ms/tsconfig.json to read more about this file */
-
-    /* Projects */
-    // "incremental": true,                              /* Enable incremental compilation */
-    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
-    // "tsBuildInfoFile": "./",                          /* Specify the folder for .tsbuildinfo incremental compilation files. */
-    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects */
-    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
-    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
-
-    /* Language and Environment */
-    "target": "es2017",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
-    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
-    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
-    // "experimentalDecorators": true,                   /* Enable experimental support for TC39 stage 2 draft decorators. */
-    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
-    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h' */
-    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
-    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using `jsx: react-jsx*`.` */
-    // "reactNamespace": "",                             /* Specify the object invoked for `createElement`. This only applies when targeting `react` JSX emit. */
-    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
-    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
-
-    /* Modules */
-    "module": "esnext",                                /* Specify what module code is generated. */
-    // "rootDir": "./",                                  /* Specify the root folder within your source files. */
-    "moduleResolution": "node",                       /* Specify how TypeScript looks up a file from a given module specifier. */
-    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
-    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
-    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
-    // "typeRoots": [],                                  /* Specify multiple folders that act like `./node_modules/@types`. */
-    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
-    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
-    // "resolveJsonModule": true,                        /* Enable importing .json files */
-    // "noResolve": true,                                /* Disallow `import`s, `require`s or `<reference>`s from expanding the number of files TypeScript should add to a project. */
-
-    /* JavaScript Support */
-    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the `checkJS` option to get errors from these files. */
-    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
-    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from `node_modules`. Only applicable with `allowJs`. */
-
-    /* Emit */
-    // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
-    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
-    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
-    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
-    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If `declaration` is true, also designates a file that bundles all .d.ts output. */
-    // "outDir": "./",                                   /* Specify an output folder for all emitted files. */
-    // "removeComments": true,                           /* Disable emitting comments. */
-    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
-    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
-    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types */
-    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
-    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
-    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
-    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
-    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
-    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
-    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
-    // "stripInternal": true,                            /* Disable emitting declarations that have `@internal` in their JSDoc comments. */
-    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like `__extends` in compiled output. */
-    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
-    // "preserveConstEnums": true,                       /* Disable erasing `const enum` declarations in generated code. */
-    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
-    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
-
-    /* Interop Constraints */
-    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
-    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
-    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables `allowSyntheticDefaultImports` for type compatibility. */
-    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
-    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
-
-    /* Type Checking */
-    "strict": true,                                      /* Enable all strict type-checking options. */
-    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied `any` type.. */
-    // "strictNullChecks": true,                         /* When type checking, take into account `null` and `undefined`. */
-    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
-    // "strictBindCallApply": true,                      /* Check that the arguments for `bind`, `call`, and `apply` methods match the original function. */
-    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
-    // "noImplicitThis": true,                           /* Enable error reporting when `this` is given the type `any`. */
-    // "useUnknownInCatchVariables": true,               /* Type catch clause variables as 'unknown' instead of 'any'. */
-    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
-    // "noUnusedLocals": true,                           /* Enable error reporting when a local variables aren't read. */
-    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read */
-    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
-    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
-    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
-    // "noUncheckedIndexedAccess": true,                 /* Include 'undefined' in index signature results */
-    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
-    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type */
-    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
-    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
-
-    /* Completeness */
-    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
-    "skipLibCheck": true                                 /* Skip type checking all .d.ts files. */
-  },
-  "ts-node": {
-    "esm": true
-  }
-}

From 4cc3ca5d39a7607a2e3ae7bce55dbe081c5baf10 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 14:29:25 -0600
Subject: [PATCH 14/23] instructions update

---
 samples/jsapi-integration/README.md         | 19 ++++++++++++++-----
 samples/jsapi-integration/authenticate.html | 12 ++++++------
 samples/jsapi-integration/config.js         |  6 +++---
 samples/jsapi-integration/index.html        |  4 ++--
 4 files changed, 25 insertions(+), 16 deletions(-)

diff --git a/samples/jsapi-integration/README.md b/samples/jsapi-integration/README.md
index 9951732..dbbb7bb 100644
--- a/samples/jsapi-integration/README.md
+++ b/samples/jsapi-integration/README.md
@@ -4,9 +4,20 @@ This demo shows how to use `arcgis-rest-js` with the ArcGIS API for JavaScript.
 
 ## Running this demo
 
-1. Run `npm run build` in the repository's root directory.
-1. Run `npm start` to spin up the development server.
-1. Visit [http://localhost:8080](http://localhost:8080).
+For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
+
+```bash
+npx serve
+```
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
+
+- `index.html`
+- `authenticate.html`
+
+## Notable code
 
 ```js
 // from rest-js
@@ -25,5 +36,3 @@ esriId.getCredential("https://www.arcgis.com/sharing/rest").then((cred) => {
   const session = ArcGISIdentityManager.fromCredential(cred, serverInfo);
 });
 ```
-
-**Note:** The server starts with a special configuration to serve URLs starting with `@esri/arcgis-rest-*` from their respective packages. In your application you will need to change these URLs to point to their respective locations.
diff --git a/samples/jsapi-integration/authenticate.html b/samples/jsapi-integration/authenticate.html
index b85b329..f5138de 100644
--- a/samples/jsapi-integration/authenticate.html
+++ b/samples/jsapi-integration/authenticate.html
@@ -1,17 +1,17 @@
 <!DOCTYPE html>
 <html lang="en">
   <head>
-    <meta charset="utf-8">
+    <meta charset="utf-8" />
     <title>ArcGIS Rest JS OAuth redirect</title>
   </head>
   <body>
-    <script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+    <script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
     <script src="./config.js"></script>
     <script>
-        arcgisRest.ArcGISIdentityManager.completeOAuth2({
-          clientId: config.clientId,
-          redirectUrl: config.redirectUri
-        })
+      arcgisRest.ArcGISIdentityManager.completeOAuth2({
+        clientId: config.clientId,
+        redirectUrl: config.redirectUri,
+      });
     </script>
   </body>
 </html>
diff --git a/samples/jsapi-integration/config.js b/samples/jsapi-integration/config.js
index 6cea071..57f3fb4 100644
--- a/samples/jsapi-integration/config.js
+++ b/samples/jsapi-integration/config.js
@@ -1,9 +1,9 @@
 /*
-You can generate your own clientid by creating an application on the ArcGIS for Developers site. Be sure to add http://localhost:8080/ as a redirect uri for your application
+You can generate your own clientid by creating an application on the ArcGIS for Developers site. Be sure to add http://localhost:3000 as a redirect uri for your application.
 
-once you have a clientid of your own, copy/paste it here and rename this file 'config.js'
+Once you have a clientid of your own, copy/paste it here.
 */
 const config = {
   clientId: "3CiiHWyTNMIRNyF1",
-  redirectUri: "http://localhost:8080/authenticate.html"
+  redirectUri: "http://localhost:3000/authenticate"
 };
diff --git a/samples/jsapi-integration/index.html b/samples/jsapi-integration/index.html
index ea2f780..2dc93c5 100644
--- a/samples/jsapi-integration/index.html
+++ b/samples/jsapi-integration/index.html
@@ -18,8 +18,8 @@
 
   <link rel="stylesheet" href="https://js.arcgis.com/4.20/esri/css/main.css">
     <script src="config.js"></script>
-    <script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
-    <script src="@esri/arcgis-rest-portal/dist/bundled/portal.umd.js"></script>
+    <script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+    <script src="https://unpkg.com/@esri/arcgis-rest-portal/dist/bundled/portal.umd.js"></script>
 
     <!--
     NOTE: rather than include the ArcGIS API for JavaScript via a <script> tag

From 9def9b9c9ae53954d9c0d80e76606c04fc3da93c Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 14:44:53 -0600
Subject: [PATCH 15/23] instructions updates

---
 samples/attachments-node/README.md           |  7 +---
 samples/batch-geocoder-node/README.md        | 19 ++++-----
 samples/node-cli-item-management/README.md   | 12 ++++--
 samples/node-common-js/README.md             | 12 +++++-
 samples/node-es-modules/README.md            | 12 +++++-
 samples/node-places-api/readme.md            | 19 ++++++---
 samples/node-typescript-es-modules/readme.md |  7 ++++
 samples/oauth2-browser/README.md             | 20 +++++-----
 samples/oauth2-browser/authenticate.html     | 42 ++++++++++----------
 samples/oauth2-browser/config.js             |  4 +-
 samples/oauth2-browser/index.html            |  6 ++-
 11 files changed, 95 insertions(+), 65 deletions(-)

diff --git a/samples/attachments-node/README.md b/samples/attachments-node/README.md
index a1f25e6..a618f0e 100644
--- a/samples/attachments-node/README.md
+++ b/samples/attachments-node/README.md
@@ -2,7 +2,8 @@
 
 ## Running this demo
 
-First run `npm install` to install the dependencies.
+1. Run `npm install` to install the dependencies.
+2. Run `npm start` to make a require and log output.
 
 ### Local ArcGIS REST JS
 
@@ -10,7 +11,3 @@ If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the
 
 - `arcgis-rest-request`
 - `arcgis-rest-feature-service`
-
-### Other Steps
-
-Run `npm start` to make a require and log output.
diff --git a/samples/batch-geocoder-node/README.md b/samples/batch-geocoder-node/README.md
index e739974..85e4198 100644
--- a/samples/batch-geocoder-node/README.md
+++ b/samples/batch-geocoder-node/README.md
@@ -2,17 +2,7 @@
 
 ## Running this demo
 
-First run `npm install` to install the dependencies.
-
-### Local ArcGIS REST JS
-
-If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
-
-- `arcgis-rest-request`
-- `arcgis-rest-geocoding`
-
-### Other Steps
-
+1. run `npm install` to install the dependencies.
 2. Create and register a [new application](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/accessing-arcgis-online-services/).
 3. Replace values in [config-template.js](/demos/batch-geocoder-node/config-template.js) and rename to `config.js`
    1. `"clientId"`: ArcGIS ClientId
@@ -23,3 +13,10 @@ If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the
 4. `npm start`
 
 Sample Restaurant Inspections adapted from a DOHMH dataset available [online](https://data.cityofnewyork.us/Health/DOHMH-New-York-City-Restaurant-Inspection-Results/xx67-kt59/data)
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-geocoding`
diff --git a/samples/node-cli-item-management/README.md b/samples/node-cli-item-management/README.md
index 5b3749e..c34b092 100644
--- a/samples/node-cli-item-management/README.md
+++ b/samples/node-cli-item-management/README.md
@@ -4,8 +4,14 @@ Demo CLI application.
 
 ## Running this demo
 
-1. Like other demo apps, run `npm run build` in the root directory.
-2. `cd demos/node-cli-item-management`
-3. `npm start`
+1. Run `npm install` to install the dependencies.
+2. Run `npm start`
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-portal`
 
 ![CLI Screenshot](./screenshot.png)
diff --git a/samples/node-common-js/README.md b/samples/node-common-js/README.md
index ab71919..0143751 100644
--- a/samples/node-common-js/README.md
+++ b/samples/node-common-js/README.md
@@ -1,4 +1,12 @@
 # Common JS Modules in Node.js
 
-1. Run `npm run build` in the root directory
-1. Run `npm start` to make a require and log output.
+## Running this demo
+
+1. Run `npm install` to install the dependencies.
+2. Run `npm start` to make a require and log output
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
diff --git a/samples/node-es-modules/README.md b/samples/node-es-modules/README.md
index 9198b0e..cdeb6a6 100644
--- a/samples/node-es-modules/README.md
+++ b/samples/node-es-modules/README.md
@@ -1,4 +1,12 @@
 # Native JavaScript Modules in Node.js
 
-1. Run `npm run build` in the root directory
-1. Run `npm start` to make a require and log output.
+## Running this demo
+
+1. Run `npm install` to install the dependencies.
+2. Run `npm start` to make a require and log output
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
diff --git a/samples/node-places-api/readme.md b/samples/node-places-api/readme.md
index a7da53a..e537ae1 100644
--- a/samples/node-places-api/readme.md
+++ b/samples/node-places-api/readme.md
@@ -1,9 +1,16 @@
-# Basic demo of the Places API
+# Places API
+
+A basic demo of the Places API.
+
+## Running this demo
 
 1. Copy `.env.template` to `.env` and add your own API key which has the places API scope enabled.
-2. Run the following commands:
+2. Run `npm install` to install the dependencies.
+3. Run `npm start`.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
 
-```bash
-npm install
-npm start
-```
+- `arcgis-rest-request`
+- `arcgis-rest-places`
diff --git a/samples/node-typescript-es-modules/readme.md b/samples/node-typescript-es-modules/readme.md
index c4dc44a..57f2dab 100644
--- a/samples/node-typescript-es-modules/readme.md
+++ b/samples/node-typescript-es-modules/readme.md
@@ -38,3 +38,10 @@ The actual example just runs a query for "water" against public items in ArcGIS
 **Note** this project uses [volta](https://volta.sh) to ensure consistent node & npm versions across platforms.
 
 If not using volta, please ensure you are using node >= 16.13.1 and npm >= 8.5.3
+
+## Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-portal`
diff --git a/samples/oauth2-browser/README.md b/samples/oauth2-browser/README.md
index 739ad11..5063c72 100644
--- a/samples/oauth2-browser/README.md
+++ b/samples/oauth2-browser/README.md
@@ -6,20 +6,20 @@ See the ArcGIS Rest JS guide to [Authentication in Browser-based Apps](https://d
 
 ## Running this demo
 
-1. Run `npm run build` in the root directory
-1. Run `npm start` in this directory to spin up the development server.
-1. Visit [http://localhost:8080](http://localhost:8080).
-
-The demo will run using an application configured by the ArcGIS REST JS team.
+1. Run `npx serve` in this directory to spin up the development server.
+1. Visit [http://localhost:3000](http://localhost:3000).
 
 ## Running with your own credentials
 
 1. Run `npm run build` in the root directory
 1. [Register an app](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/register-your-application/) and copy the Client ID into `config.js` in the `clientId` property.
-1. [Add redirect URIs](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/add-redirect-uri/) for `http://localhost:8080` (for inline redirects) and `http://localhost:8080/authentication.html` (for popup redirects) to your registered application.
-1. Run `npm start` in this directory to spin up the development server.
-1. Visit [http://localhost:8080](http://localhost:8080).
+1. [Add redirect URIs](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/add-redirect-uri/) for `http://localhost:3000` (for inline redirects) and `http://localhost:3000/authentication.html` (for popup redirects) to your registered application.
+1. Run `npx serve` in this directory to spin up the development server.
+1. Visit [http://localhost:3000](http://localhost:3000).
+
+### Local ArcGIS REST JS
 
----
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-browser), updating the script tags in these files as necessary:
 
-**Note:** The server starts with a special configuration to serve URLs starting with `@esri/arcgis-rest-*` from their respective packages. In your application you will need to change these URLs to point to their respective locations.
+- `index.html`
+- `authenticate.html`
diff --git a/samples/oauth2-browser/authenticate.html b/samples/oauth2-browser/authenticate.html
index e31a1da..259217c 100644
--- a/samples/oauth2-browser/authenticate.html
+++ b/samples/oauth2-browser/authenticate.html
@@ -1,25 +1,23 @@
 <!DOCTYPE html>
 <html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>ArcGIS Rest JS OAuth redirect</title>
+  </head>
 
-<head>
-  <meta charset="utf-8">
-  <title>ArcGIS Rest JS OAuth redirect</title>
-</head>
-
-<body>
-  <script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
-  <script src="config.js"></script>
-  <script>
-    let opts = {
-      clientId: config.clientId,
-      redirectUri: config.redirectUri,
-      popup: true,
-    }
-    if (config.portal) {
-      opts.portal = config.portal
-    }
-    arcgisRest.ArcGISIdentityManager.completeOAuth2(opts);
-  </script>
-</body>
-
-</html>
\ No newline at end of file
+  <body>
+    <script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+    <script src="config.js"></script>
+    <script>
+      let opts = {
+        clientId: config.clientId,
+        redirectUri: config.redirectUri,
+        popup: true,
+      };
+      if (config.portal) {
+        opts.portal = config.portal;
+      }
+      arcgisRest.ArcGISIdentityManager.completeOAuth2(opts);
+    </script>
+  </body>
+</html>
diff --git a/samples/oauth2-browser/config.js b/samples/oauth2-browser/config.js
index 4f3d855..ce2d2a0 100644
--- a/samples/oauth2-browser/config.js
+++ b/samples/oauth2-browser/config.js
@@ -5,6 +5,6 @@ once you have a clientid of your own, copy/paste it here and rename this file 'c
 */
 const config = {
   clientId: "3CiiHWyTNMIRNyF1",
-  popupRedirectUri: "http://localhost:8080/authenticate.html",
-  inlineRedirectUri: "http://localhost:8080/"
+  popupRedirectUri: "http://localhost:3000/authenticate.html",
+  inlineRedirectUri: "http://localhost:3000/"
 };
diff --git a/samples/oauth2-browser/index.html b/samples/oauth2-browser/index.html
index 01b2de8..e1a3fb7 100644
--- a/samples/oauth2-browser/index.html
+++ b/samples/oauth2-browser/index.html
@@ -7,6 +7,9 @@
   <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css"
     integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
   <link rel="stylesheet" href="./style.css">
+
+  <script src="config.js"></script>
+  <script src="https://unpkg.com/@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
 </head>
 
 <body>
@@ -93,8 +96,7 @@ <h2>
     </div>
   </div>
 
-  <script src="config.js"></script>
-  <script src="@esri/arcgis-rest-request/dist/bundled/request.umd.js"></script>
+  
   <script>
     // Define a global session variable.
     let session = null;

From fd52bded3082c8c745d86d4aac3468b0eee99160 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 14:49:04 -0600
Subject: [PATCH 16/23] instructions for `parcel` sample

---
 samples/parcel/.gitignore   |  3 ++-
 samples/parcel/README.md    | 12 ++++++++----
 samples/parcel/package.json |  6 +++---
 3 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/samples/parcel/.gitignore b/samples/parcel/.gitignore
index dce36cb..4ddbee5 100644
--- a/samples/parcel/.gitignore
+++ b/samples/parcel/.gitignore
@@ -1 +1,2 @@
-.parcel-cache
\ No newline at end of file
+.parcel-cache
+dist
\ No newline at end of file
diff --git a/samples/parcel/README.md b/samples/parcel/README.md
index 14f0251..1e52c43 100644
--- a/samples/parcel/README.md
+++ b/samples/parcel/README.md
@@ -1,8 +1,12 @@
 # ArcGIS REST JS + Parcel
 
-1. Run `npm run build` in the root directory
-1. Run `npm i` in this directory
+1. Run `npm install` in this directory
 1. Run `npm start` to spin up the development server.
-1. Visit [http://localhost:1234](http://localhost:8080).
+1. Visit [http://localhost:1234](http://localhost:1234).
 
-**Note:** We currently point the `NODE_ENV` variable at the root of this monorepo to [resolve an issue with Parcel and monorepos](https://github.com/parcel-bundler/parcel/issues/1588). If you use ArcGIS REST JS with Parcel yourself you likely won't need this.
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-portal`
diff --git a/samples/parcel/package.json b/samples/parcel/package.json
index 98c7e90..14e8d55 100644
--- a/samples/parcel/package.json
+++ b/samples/parcel/package.json
@@ -6,11 +6,11 @@
   "license": "Apache-2.0",
   "type": "module",
   "scripts": {
-    "build": "NODE_PATH=../../ parcel build index.html",
-    "start": "NODE_PATH=../../ parcel index.html"
+    "build": "parcel build index.html",
+    "start": "parcel index.html"
   },
   "dependencies": {
-    "@esri/arcgis-rest-places": "^1.0.0",
+    "@esri/arcgis-rest-portal": "^4.0.0",
     "@esri/arcgis-rest-request": "^4.0.0"
   },
   "devDependencies": {

From 8e3516fe68b8e82f240f085625d819eb56804783 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 14:55:21 -0600
Subject: [PATCH 17/23] parcel instructions

---
 samples/parcel-places/.gitignore   |  3 ++-
 samples/parcel-places/README.md    | 16 ++++++++++++----
 samples/parcel-places/index.html   | 25 ++++++++++++-------------
 samples/parcel-places/index.js     |  2 +-
 samples/parcel-places/package.json |  6 +++---
 samples/parcel/README.md           |  2 ++
 6 files changed, 32 insertions(+), 22 deletions(-)

diff --git a/samples/parcel-places/.gitignore b/samples/parcel-places/.gitignore
index 68aa71c..826f881 100644
--- a/samples/parcel-places/.gitignore
+++ b/samples/parcel-places/.gitignore
@@ -1,2 +1,3 @@
 .parcel-cache
-auth.js
\ No newline at end of file
+auth.js
+dist
\ No newline at end of file
diff --git a/samples/parcel-places/README.md b/samples/parcel-places/README.md
index 14f0251..7a1a273 100644
--- a/samples/parcel-places/README.md
+++ b/samples/parcel-places/README.md
@@ -1,8 +1,16 @@
 # ArcGIS REST JS + Parcel
 
-1. Run `npm run build` in the root directory
-1. Run `npm i` in this directory
+## Running this demo
+
+1. Create an API key (<https://developers.arcgis.com>).
+1. Copy `auth.template.js` to `auth.js`, and place your API key into that file.
+1. Run `npm install` in this directory.
 1. Run `npm start` to spin up the development server.
-1. Visit [http://localhost:1234](http://localhost:8080).
+1. Visit [http://localhost:1234](http://localhost:1234).
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
 
-**Note:** We currently point the `NODE_ENV` variable at the root of this monorepo to [resolve an issue with Parcel and monorepos](https://github.com/parcel-bundler/parcel/issues/1588). If you use ArcGIS REST JS with Parcel yourself you likely won't need this.
+- `arcgis-rest-request`
+- `arcgis-rest-places`
diff --git a/samples/parcel-places/index.html b/samples/parcel-places/index.html
index 64940e8..75fbbc0 100644
--- a/samples/parcel-places/index.html
+++ b/samples/parcel-places/index.html
@@ -1,16 +1,15 @@
 <!DOCTYPE html>
 <html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <meta name="description" content="Starter Parcel App" />
+    <title>Starter Parcel App</title>
+  </head>
 
-<head>
-  <meta charset="utf-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <meta name="description" content="Starter Parcel App" />
-  <title>Starter Parcel App</title>
-</head>
-
-<body>
-  <h1>Welcome to Parcel!</h1>
-  <script type="module" src="index.js"></script>
-</body>
-
-</html>
\ No newline at end of file
+  <body>
+    <h1>Welcome to Parcel!</h1>
+    <p>See the developer console for results.</p>
+    <script type="module" src="index.js"></script>
+  </body>
+</html>
diff --git a/samples/parcel-places/index.js b/samples/parcel-places/index.js
index 217b0e3..37192d5 100644
--- a/samples/parcel-places/index.js
+++ b/samples/parcel-places/index.js
@@ -18,5 +18,5 @@ import { findPlacesNearPoint } from "@esri/arcgis-rest-places";
     allPlaces = allPlaces.concat(lastResponse.results);
   }
 
-  console.log(allPlaces.length);
+  console.log(allPlaces.length, allPlaces);
 })();
diff --git a/samples/parcel-places/package.json b/samples/parcel-places/package.json
index 7d1cf80..67a853c 100644
--- a/samples/parcel-places/package.json
+++ b/samples/parcel-places/package.json
@@ -6,11 +6,11 @@
   "license": "Apache-2.0",
   "type": "module",
   "scripts": {
-    "build": "NODE_PATH=../../ parcel build index.html",
-    "start": "NODE_PATH=../../ parcel index.html"
+    "build": "parcel build index.html",
+    "start": "parcel index.html"
   },
   "dependencies": {
-    "@esri/arcgis-rest-portal": "^4.0.0",
+    "@esri/arcgis-rest-places": "^1.1.0",
     "@esri/arcgis-rest-request": "^4.0.0"
   },
   "devDependencies": {
diff --git a/samples/parcel/README.md b/samples/parcel/README.md
index 1e52c43..a498d49 100644
--- a/samples/parcel/README.md
+++ b/samples/parcel/README.md
@@ -1,5 +1,7 @@
 # ArcGIS REST JS + Parcel
 
+## Running this demo
+
 1. Run `npm install` in this directory
 1. Run `npm start` to spin up the development server.
 1. Visit [http://localhost:1234](http://localhost:1234).

From d1eb6a2333b0a7607712eaf6f13bc221e73f74fc Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 15:07:54 -0600
Subject: [PATCH 18/23] instructions

---
 samples/snowpack/README.md                | 12 +++++++++---
 samples/stream-response-to-file/README.md | 18 +++++++++++++-----
 samples/tree-shaking-rollup/.gitignore    |  1 +
 samples/tree-shaking-rollup/README.md     | 15 +++++++++++----
 samples/tree-shaking-webpack/README.md    | 13 ++++++++++---
 samples/vite/README.md                    | 14 +++++++++++---
 6 files changed, 55 insertions(+), 18 deletions(-)

diff --git a/samples/snowpack/README.md b/samples/snowpack/README.md
index 2d818ce..0012819 100644
--- a/samples/snowpack/README.md
+++ b/samples/snowpack/README.md
@@ -1,8 +1,14 @@
 # ArcGIS REST JS + Native Browser Modules
 
-1. Run `npm run build` in the root directory
-1. Run `npm i` in this directory
+## Running this demo
+
+1. Run `npm install` in this directory
 1. Run `npm start` to spin up the development server.
 1. Visit [http://localhost:8080](http://localhost:8080).
 
-**Note:** We have `workspaceRoot` configured because this is part of our monorepo setup. If you use ArcGIS REST JS with Snowpack yourself you likely won't need this.
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-portal`
diff --git a/samples/stream-response-to-file/README.md b/samples/stream-response-to-file/README.md
index 056113e..0307354 100644
--- a/samples/stream-response-to-file/README.md
+++ b/samples/stream-response-to-file/README.md
@@ -1,7 +1,15 @@
-# Running this demo
+# Stream Response to File
 
-1. Make sure you run `npm run build` in the root folder to setup the dependencies
-1. cd into `/demos/stream-response-to-file/`
-1. Run `npm start`
+Demonstrates using ReadableStream to save results from a query to a file. Features from <https://services.arcgis.com/uUvqNMGPm7axC2dD/arcgis/rest/services/Boating_Access_Sites/FeatureServer/0> will be written in GeoJSON format to a file in the `output` directory.
 
-Features from https://services.arcgis.com/uUvqNMGPm7axC2dD/arcgis/rest/services/Boating_Access_Sites/FeatureServer/0 will be written in GeoJSON format to a file in the `output` directory.
+## Running this demo
+
+1. Run `npm install` to install the dependencies.
+1. Run `npm start`.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-feature-service`
diff --git a/samples/tree-shaking-rollup/.gitignore b/samples/tree-shaking-rollup/.gitignore
index 10dcd67..22dd53e 100644
--- a/samples/tree-shaking-rollup/.gitignore
+++ b/samples/tree-shaking-rollup/.gitignore
@@ -1 +1,2 @@
+dist/
 stats.html
\ No newline at end of file
diff --git a/samples/tree-shaking-rollup/README.md b/samples/tree-shaking-rollup/README.md
index a4ff908..4350439 100644
--- a/samples/tree-shaking-rollup/README.md
+++ b/samples/tree-shaking-rollup/README.md
@@ -1,9 +1,16 @@
-# Running this demo
+# Tree Shaking - Rollup
 
 This demo shows how to have rollup [tree shake](https://rollupjs.org/guide/en#tree-shaking) `@esri/rest-js` and only include methods that are actually being called in its output bundle.
 
-1. Run `npm run build` in the root directory
-1. cd into `/demos/tree-shaking-rollup/`
-1. Run `npm run build:app`
+## Running this demo
+
+1. Run `npm install` to install the dependencies.
+1. Run `npm run build:app`.
 1. Load `index.html` in a web browser and confirm you see output.
 1. Open `stats.html`. You should only see `request` and `search` related modules.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
diff --git a/samples/tree-shaking-webpack/README.md b/samples/tree-shaking-webpack/README.md
index 7014470..07470fa 100644
--- a/samples/tree-shaking-webpack/README.md
+++ b/samples/tree-shaking-webpack/README.md
@@ -1,9 +1,16 @@
-# Running this demo
+# Tree Shaking - Webpack
 
 This demo shows how to have webpack [tree shake](https://rollupjs.org/guide/en#tree-shaking) `@esri/rest-js` and only include methods that are actually being called in its output bundle.
 
-1. Run `npm run build` in the root directory
-1. cd into `demos/tree-shaking-webpack`
+## Running this demo
+
+1. Run `npm install` to install the dependencies.
 1. Run `npm run build:app` this will also generate a `stats.json` file
 1. Load `index.html` in a web browser and confirm you see output.
 1. Run `npm run analyze-bundle` which will open the bundle analyzer. You should only see `request` and `search` related modules.
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
diff --git a/samples/vite/README.md b/samples/vite/README.md
index 439a272..89664cf 100644
--- a/samples/vite/README.md
+++ b/samples/vite/README.md
@@ -1,6 +1,14 @@
 # ArcGIS REST JS + Vite
 
-1. Run `npm run build` in the root directory
-1. Run `npm i` in this directory
+## Running this demo
+
+1. Run `npm install` in this directory.
 1. Run `npm start` to spin up the development server.
-1. Visit [http://localhost:3000](http://localhost:8080).
+1. Visit [http://localhost:3000](http://localhost:3000).
+
+### Local ArcGIS REST JS
+
+If you'd like to use a local version of ArcGIS REST JS, follow the [steps in the parent README](../README.md#local-arcgis-rest-js-npm), referencing these packages that this sample uses as necessary:
+
+- `arcgis-rest-request`
+- `arcgis-rest-portal`

From 6ccc45bc3b409913850c077c9cd29e208d859433 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 15:08:26 -0600
Subject: [PATCH 19/23] rewording

---
 samples/attachments-browser/README.md      | 2 +-
 samples/attachments-node/README.md         | 2 +-
 samples/batch-geocoder-node/README.md      | 2 +-
 samples/browser-es-modules/README.md       | 2 +-
 samples/deno/README.md                     | 2 +-
 samples/dev-credentials-client/README.md   | 2 +-
 samples/express/README.md                  | 2 +-
 samples/feature-service-browser/README.md  | 2 +-
 samples/geocoder-browser/README.md         | 2 +-
 samples/job/readme.md                      | 2 +-
 samples/jsapi-integration/README.md        | 2 +-
 samples/node-cli-item-management/README.md | 2 +-
 samples/node-common-js/README.md           | 2 +-
 samples/node-es-modules/README.md          | 2 +-
 samples/node-places-api/readme.md          | 2 +-
 samples/oauth2-browser/README.md           | 2 +-
 samples/parcel-places/README.md            | 2 +-
 samples/parcel/README.md                   | 2 +-
 samples/snowpack/README.md                 | 2 +-
 samples/stream-response-to-file/README.md  | 2 +-
 samples/tree-shaking-rollup/README.md      | 2 +-
 samples/tree-shaking-webpack/README.md     | 2 +-
 samples/vite/README.md                     | 2 +-
 23 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/samples/attachments-browser/README.md b/samples/attachments-browser/README.md
index 558c811..33f8f21 100644
--- a/samples/attachments-browser/README.md
+++ b/samples/attachments-browser/README.md
@@ -1,6 +1,6 @@
 # Attachments Browser
 
-## Running this demo
+## Running this sample
 
 For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
diff --git a/samples/attachments-node/README.md b/samples/attachments-node/README.md
index a618f0e..d211db7 100644
--- a/samples/attachments-node/README.md
+++ b/samples/attachments-node/README.md
@@ -1,6 +1,6 @@
 # Native JavaScript Modules in Node.js
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` to install the dependencies.
 2. Run `npm start` to make a require and log output.
diff --git a/samples/batch-geocoder-node/README.md b/samples/batch-geocoder-node/README.md
index 85e4198..d439000 100644
--- a/samples/batch-geocoder-node/README.md
+++ b/samples/batch-geocoder-node/README.md
@@ -1,6 +1,6 @@
 # Batch Geocoder (Node)
 
-## Running this demo
+## Running this sample
 
 1. run `npm install` to install the dependencies.
 2. Create and register a [new application](https://developers.arcgis.com/documentation/core-concepts/security-and-authentication/accessing-arcgis-online-services/).
diff --git a/samples/browser-es-modules/README.md b/samples/browser-es-modules/README.md
index 8df3e8a..5199b21 100644
--- a/samples/browser-es-modules/README.md
+++ b/samples/browser-es-modules/README.md
@@ -1,6 +1,6 @@
 # ArcGIS REST JS + Native Browser Modules
 
-## Running this demo
+## Running this sample
 
 For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
diff --git a/samples/deno/README.md b/samples/deno/README.md
index a90052b..9a0b00b 100644
--- a/samples/deno/README.md
+++ b/samples/deno/README.md
@@ -1,6 +1,6 @@
 # ArcGIS REST JS + Deno
 
-## Running this demo
+## Running this sample
 
 ArcGIS REST JS is fully compatible with Deno. You can run this demo with:
 
diff --git a/samples/dev-credentials-client/README.md b/samples/dev-credentials-client/README.md
index ddf1e7c..65ae8b9 100644
--- a/samples/dev-credentials-client/README.md
+++ b/samples/dev-credentials-client/README.md
@@ -6,7 +6,7 @@ via [Authenticate with an ArcGIS identity](https://developers.arcgis.com/arcgis-
 Then you can use the form to create an API key or switch to the OAuth 2.0 form to create an OAuth 2.0 app.
 Once you've created an API key or OAuth 2.0 app, you can click on the item in the table below the form to edit it.
 
-## Running this demo
+## Running this sample
 
 First run `npm install` to install the dependencies.
 
diff --git a/samples/express/README.md b/samples/express/README.md
index 0a22465..b7745b7 100644
--- a/samples/express/README.md
+++ b/samples/express/README.md
@@ -2,7 +2,7 @@
 
 This sample shows how to trigger OAuth 2.0 via custom server-side code.
 
-## Running this demo
+## Running this sample
 
 1. In this sample's directory, run `npm install` to install the dependencies.
 2. Create a new application on <https://developers.arcgis.com> (New Item > Developer Credentials > OAuth 2.0 credentials).
diff --git a/samples/feature-service-browser/README.md b/samples/feature-service-browser/README.md
index 0f18545..a018831 100644
--- a/samples/feature-service-browser/README.md
+++ b/samples/feature-service-browser/README.md
@@ -1,6 +1,6 @@
 # Feature Service (Browser)
 
-## Running this demo
+## Running this sample
 
 For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
diff --git a/samples/geocoder-browser/README.md b/samples/geocoder-browser/README.md
index b46f4f7..7aefddb 100644
--- a/samples/geocoder-browser/README.md
+++ b/samples/geocoder-browser/README.md
@@ -1,6 +1,6 @@
 # Geocode (Browser)
 
-## Running this demo
+## Running this sample
 
 For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
diff --git a/samples/job/readme.md b/samples/job/readme.md
index 0c37e59..397106b 100644
--- a/samples/job/readme.md
+++ b/samples/job/readme.md
@@ -2,7 +2,7 @@
 
 This demo shows how to use the `Job` class to submit a job and retrieve the results.
 
-## Running this demo
+## Running this sample
 
 For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
diff --git a/samples/jsapi-integration/README.md b/samples/jsapi-integration/README.md
index dbbb7bb..1103b8f 100644
--- a/samples/jsapi-integration/README.md
+++ b/samples/jsapi-integration/README.md
@@ -2,7 +2,7 @@
 
 This demo shows how to use `arcgis-rest-js` with the ArcGIS API for JavaScript. A typical use case would be when you need to query items or feature data _before_ you are ready to display a map or scene view. In this scenario, you should load the light-weight `arcgis-rest-js` libraries first and use them to perform your queries and/or authenticate with the ArcGIS platform. Then when you are ready to show a map or scene view, you would lazy-load the ArcGIS API for JavaScript with something like [esri-loader](https://github.com/Esri/esri-loader) and use it to create the map.
 
-## Running this demo
+## Running this sample
 
 For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
 
diff --git a/samples/node-cli-item-management/README.md b/samples/node-cli-item-management/README.md
index c34b092..00a1e80 100644
--- a/samples/node-cli-item-management/README.md
+++ b/samples/node-cli-item-management/README.md
@@ -2,7 +2,7 @@
 
 Demo CLI application.
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` to install the dependencies.
 2. Run `npm start`
diff --git a/samples/node-common-js/README.md b/samples/node-common-js/README.md
index 0143751..7d2b705 100644
--- a/samples/node-common-js/README.md
+++ b/samples/node-common-js/README.md
@@ -1,6 +1,6 @@
 # Common JS Modules in Node.js
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` to install the dependencies.
 2. Run `npm start` to make a require and log output
diff --git a/samples/node-es-modules/README.md b/samples/node-es-modules/README.md
index cdeb6a6..ed5b986 100644
--- a/samples/node-es-modules/README.md
+++ b/samples/node-es-modules/README.md
@@ -1,6 +1,6 @@
 # Native JavaScript Modules in Node.js
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` to install the dependencies.
 2. Run `npm start` to make a require and log output
diff --git a/samples/node-places-api/readme.md b/samples/node-places-api/readme.md
index e537ae1..bbf9ec5 100644
--- a/samples/node-places-api/readme.md
+++ b/samples/node-places-api/readme.md
@@ -2,7 +2,7 @@
 
 A basic demo of the Places API.
 
-## Running this demo
+## Running this sample
 
 1. Copy `.env.template` to `.env` and add your own API key which has the places API scope enabled.
 2. Run `npm install` to install the dependencies.
diff --git a/samples/oauth2-browser/README.md b/samples/oauth2-browser/README.md
index 5063c72..7217080 100644
--- a/samples/oauth2-browser/README.md
+++ b/samples/oauth2-browser/README.md
@@ -4,7 +4,7 @@ This demo uses Vanilla JS to implement OAuth2 using the `arcgis-rest-js` librari
 
 See the ArcGIS Rest JS guide to [Authentication in Browser-based Apps](https://developers.arcgis.com/arcgis-rest-js/authentication/tutorials/implement-user-authentication-rest-js-browser/) for more info.
 
-## Running this demo
+## Running this sample
 
 1. Run `npx serve` in this directory to spin up the development server.
 1. Visit [http://localhost:3000](http://localhost:3000).
diff --git a/samples/parcel-places/README.md b/samples/parcel-places/README.md
index 7a1a273..9dd34ac 100644
--- a/samples/parcel-places/README.md
+++ b/samples/parcel-places/README.md
@@ -1,6 +1,6 @@
 # ArcGIS REST JS + Parcel
 
-## Running this demo
+## Running this sample
 
 1. Create an API key (<https://developers.arcgis.com>).
 1. Copy `auth.template.js` to `auth.js`, and place your API key into that file.
diff --git a/samples/parcel/README.md b/samples/parcel/README.md
index a498d49..caa3b22 100644
--- a/samples/parcel/README.md
+++ b/samples/parcel/README.md
@@ -1,6 +1,6 @@
 # ArcGIS REST JS + Parcel
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` in this directory
 1. Run `npm start` to spin up the development server.
diff --git a/samples/snowpack/README.md b/samples/snowpack/README.md
index 0012819..c73b7b3 100644
--- a/samples/snowpack/README.md
+++ b/samples/snowpack/README.md
@@ -1,6 +1,6 @@
 # ArcGIS REST JS + Native Browser Modules
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` in this directory
 1. Run `npm start` to spin up the development server.
diff --git a/samples/stream-response-to-file/README.md b/samples/stream-response-to-file/README.md
index 0307354..542a39b 100644
--- a/samples/stream-response-to-file/README.md
+++ b/samples/stream-response-to-file/README.md
@@ -2,7 +2,7 @@
 
 Demonstrates using ReadableStream to save results from a query to a file. Features from <https://services.arcgis.com/uUvqNMGPm7axC2dD/arcgis/rest/services/Boating_Access_Sites/FeatureServer/0> will be written in GeoJSON format to a file in the `output` directory.
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` to install the dependencies.
 1. Run `npm start`.
diff --git a/samples/tree-shaking-rollup/README.md b/samples/tree-shaking-rollup/README.md
index 4350439..89da63e 100644
--- a/samples/tree-shaking-rollup/README.md
+++ b/samples/tree-shaking-rollup/README.md
@@ -2,7 +2,7 @@
 
 This demo shows how to have rollup [tree shake](https://rollupjs.org/guide/en#tree-shaking) `@esri/rest-js` and only include methods that are actually being called in its output bundle.
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` to install the dependencies.
 1. Run `npm run build:app`.
diff --git a/samples/tree-shaking-webpack/README.md b/samples/tree-shaking-webpack/README.md
index 07470fa..6793715 100644
--- a/samples/tree-shaking-webpack/README.md
+++ b/samples/tree-shaking-webpack/README.md
@@ -2,7 +2,7 @@
 
 This demo shows how to have webpack [tree shake](https://rollupjs.org/guide/en#tree-shaking) `@esri/rest-js` and only include methods that are actually being called in its output bundle.
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` to install the dependencies.
 1. Run `npm run build:app` this will also generate a `stats.json` file
diff --git a/samples/vite/README.md b/samples/vite/README.md
index 89664cf..0a1a534 100644
--- a/samples/vite/README.md
+++ b/samples/vite/README.md
@@ -1,6 +1,6 @@
 # ArcGIS REST JS + Vite
 
-## Running this demo
+## Running this sample
 
 1. Run `npm install` in this directory.
 1. Run `npm start` to spin up the development server.

From 2160ed246c85f589df65b2fc5af247e8a44172d7 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 3 Jan 2025 15:15:04 -0600
Subject: [PATCH 20/23] explainations

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 36f39ee..ea16752 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,7 @@
 # ArcGIS REST JS Samples
 
+This repository contains a variety of samples of different ways to use [ArcGIS REST JS](https://github.com/Esri/arcgis-rest-js). Please see the [samples folder](samples/) for the entire list. Each sample has a README file to explain how to run the sample.
+
 ## Local ArcGIS REST JS
 
 If you'd like to use a local version of ArcGIS REST JS while running one of the samples, follow these steps.
@@ -52,3 +54,7 @@ For samples that use a `<script>` tag to reference ArcGIS REST JS in the browser
    ```html
    <script src="https://localhost:8080/@esri/arcgis-rest-feature-service/dist/bundled/feature-service.umd.js"></script>
    ```
+
+## Sample Repository Maintenance
+
+In order to not need to constantly update the packages, we are not including `package-lock.json` files within samples the use NPM to install dependencies. See [.gitignore](.gitignore).

From e57608a1499d9399a992e8a540d6b620305e9b0f Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Thu, 9 Jan 2025 12:44:42 -0600
Subject: [PATCH 21/23] delete these configs to convert them into templates in
 the next commit

---
 samples/jsapi-integration/config.js |  9 ---------
 samples/oauth2-browser/config.js    | 10 ----------
 2 files changed, 19 deletions(-)
 delete mode 100644 samples/jsapi-integration/config.js
 delete mode 100644 samples/oauth2-browser/config.js

diff --git a/samples/jsapi-integration/config.js b/samples/jsapi-integration/config.js
deleted file mode 100644
index 57f3fb4..0000000
--- a/samples/jsapi-integration/config.js
+++ /dev/null
@@ -1,9 +0,0 @@
-/*
-You can generate your own clientid by creating an application on the ArcGIS for Developers site. Be sure to add http://localhost:3000 as a redirect uri for your application.
-
-Once you have a clientid of your own, copy/paste it here.
-*/
-const config = {
-  clientId: "3CiiHWyTNMIRNyF1",
-  redirectUri: "http://localhost:3000/authenticate"
-};
diff --git a/samples/oauth2-browser/config.js b/samples/oauth2-browser/config.js
deleted file mode 100644
index ce2d2a0..0000000
--- a/samples/oauth2-browser/config.js
+++ /dev/null
@@ -1,10 +0,0 @@
-/*
-You can generate your own clientid by creating an application on the ArcGIS for Developers site. Be sure to add http://localhost:8080/ as a redirect uri for your application
-
-once you have a clientid of your own, copy/paste it here and rename this file 'config.js'
-*/
-const config = {
-  clientId: "3CiiHWyTNMIRNyF1",
-  popupRedirectUri: "http://localhost:3000/authenticate.html",
-  inlineRedirectUri: "http://localhost:3000/"
-};

From b3139f775c06911e6fd0fd63c9cdecf40ede83a7 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Thu, 9 Jan 2025 13:00:38 -0600
Subject: [PATCH 22/23] use a config template instead of pre-filled clientId

---
 samples/jsapi-integration/.gitignore         |  1 +
 samples/jsapi-integration/README.md          | 10 +++++-----
 samples/jsapi-integration/config.template.js |  4 ++++
 samples/oauth2-browser/.gitignore            |  1 +
 samples/oauth2-browser/README.md             |  9 ++-------
 samples/oauth2-browser/config.template.js    |  5 +++++
 6 files changed, 18 insertions(+), 12 deletions(-)
 create mode 100644 samples/jsapi-integration/.gitignore
 create mode 100644 samples/jsapi-integration/config.template.js
 create mode 100644 samples/oauth2-browser/config.template.js

diff --git a/samples/jsapi-integration/.gitignore b/samples/jsapi-integration/.gitignore
new file mode 100644
index 0000000..a2d72a2
--- /dev/null
+++ b/samples/jsapi-integration/.gitignore
@@ -0,0 +1 @@
+config.js
\ No newline at end of file
diff --git a/samples/jsapi-integration/README.md b/samples/jsapi-integration/README.md
index 1103b8f..3356e8a 100644
--- a/samples/jsapi-integration/README.md
+++ b/samples/jsapi-integration/README.md
@@ -4,11 +4,11 @@ This demo shows how to use `arcgis-rest-js` with the ArcGIS API for JavaScript.
 
 ## Running this sample
 
-For this sample, you do not need to install any dependencies - it uses ArcGIS REST JS from the Unpkg CDN. To run this sample, you just need to host the `index.html` file. There are a variety of ways to do that; one simple way is to use the [serve](https://www.npmjs.com/package/serve) package:
-
-```bash
-npx serve
-```
+1. [Register an app](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/register-your-application/) and copy the Client ID.
+1. [Add redirect URIs](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/add-redirect-uri/) for `http://localhost:3000`.
+1. Copy `config.template.ts` to `config.ts` and replace the `clientId` with the Client ID from step 1.
+1. Run `npx serve` in this directory to spin up the development server.
+1. Visit [http://localhost:3000](http://localhost:3000).
 
 ### Local ArcGIS REST JS
 
diff --git a/samples/jsapi-integration/config.template.js b/samples/jsapi-integration/config.template.js
new file mode 100644
index 0000000..010dfd1
--- /dev/null
+++ b/samples/jsapi-integration/config.template.js
@@ -0,0 +1,4 @@
+const config = {
+  clientId: "",
+  redirectUri: "http://localhost:3000/authenticate"
+};
\ No newline at end of file
diff --git a/samples/oauth2-browser/.gitignore b/samples/oauth2-browser/.gitignore
index e69de29..a2d72a2 100644
--- a/samples/oauth2-browser/.gitignore
+++ b/samples/oauth2-browser/.gitignore
@@ -0,0 +1 @@
+config.js
\ No newline at end of file
diff --git a/samples/oauth2-browser/README.md b/samples/oauth2-browser/README.md
index 7217080..80ab9c5 100644
--- a/samples/oauth2-browser/README.md
+++ b/samples/oauth2-browser/README.md
@@ -6,14 +6,9 @@ See the ArcGIS Rest JS guide to [Authentication in Browser-based Apps](https://d
 
 ## Running this sample
 
-1. Run `npx serve` in this directory to spin up the development server.
-1. Visit [http://localhost:3000](http://localhost:3000).
-
-## Running with your own credentials
-
-1. Run `npm run build` in the root directory
-1. [Register an app](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/register-your-application/) and copy the Client ID into `config.js` in the `clientId` property.
+1. [Register an app](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/register-your-application/) and copy the Client ID.
 1. [Add redirect URIs](https://developers.arcgis.com/documentation/mapping-apis-and-services/security/tutorials/add-redirect-uri/) for `http://localhost:3000` (for inline redirects) and `http://localhost:3000/authentication.html` (for popup redirects) to your registered application.
+1. Copy `config.template.ts` to `config.ts` and replace the `clientId` with the Client ID from step 1.
 1. Run `npx serve` in this directory to spin up the development server.
 1. Visit [http://localhost:3000](http://localhost:3000).
 
diff --git a/samples/oauth2-browser/config.template.js b/samples/oauth2-browser/config.template.js
new file mode 100644
index 0000000..f189567
--- /dev/null
+++ b/samples/oauth2-browser/config.template.js
@@ -0,0 +1,5 @@
+const config = {
+  clientId: "",
+  popupRedirectUri: "http://localhost:3000/authenticate.html",
+  inlineRedirectUri: "http://localhost:3000/"
+};
\ No newline at end of file

From d25f4aabc31d974d85f941deb8b110614357b3f4 Mon Sep 17 00:00:00 2001
From: Gavin Rehkemper <grehkemper@esri.com>
Date: Fri, 10 Jan 2025 14:52:41 -0600
Subject: [PATCH 23/23] update link instructions

---
 README.md | 20 ++++----------------
 1 file changed, 4 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index ea16752..0ee2c92 100644
--- a/README.md
+++ b/README.md
@@ -10,22 +10,10 @@ If you'd like to use a local version of ArcGIS REST JS while running one of the
 
 For samples that use NPM to install ArcGIS REST JS as a dependency, follow these steps.
 
-1. In the ArcGIS REST JS directory, run these commands:
-
-   ```bash
-   npm install
-   npm run build
-   ```
-
-2. In this sample's directory, run these commands,
-
-   1. Replacing `..\..\path\to` with the path to where you have ArcGIS REST JS stored, and
-   2. Using the associated package folder(s) that are being used by the current sample (e.g. `packages\arcgis-rest-feature-service`, `packages\arcgis-rest-geocoding`, etc.)
-
-   ```bash
-   npm install
-   npm link ..\..\path\to\arcgis-rest-js\packages\arcgis-rest-feature-service\
-   ```
+1. In the ArcGIS REST JS repo run any relevant build commands for the packages with which you are working.
+1. In the terminal, `cd` onto the package you want to link. E.g. `cd packages/arcgis-rest-request`.
+1. Run `npm link`.
+1. In this repo, `cd` into the demo you want to run and run the `npm link` command for the package you want to link. `npm link @esri/arcgis-rest-request`
 
 Remember that you must run `npm run build` in the ArcGIS REST JS repository after making changes to see those changes when running the sample.