diff --git a/README.md b/README.md
index dca70aad..90c552b7 100644
--- a/README.md
+++ b/README.md
@@ -24,3 +24,96 @@ npm run lint
1. Install the [AEM CLI](https://github.com/adobe/aem-cli): `npm install -g @adobe/aem-cli`
1. Start AEM Proxy: `aem up` (opens your browser at `http://localhost:3000`)
1. Open the `{repo}` directory in your favorite IDE and start coding :)
+
+
+### Local Proxy for APIs
+There are numerous APIs that this site relies on, including but not limited to:
+
+* Account (login, profile, etc)
+* Blog
+* Properties (search, listing, etc)
+* Agent (details, search)
+* Suggestions
+
+All of these APIs are hosted on an AMS system. To make use of them locally, a proxy is needed.
+
+There are two ways to set up the local proxy:
+
+* [Real Domain Proxy](#real-domain-proxy)
+ * Less configuration, but must be aware when proxy is/isn't running.
+* [Local Proxy to Remote](#local-proxy-to-remote)
+ * More configuration, but explicit domain for proxy - clear delineation of live and proxied traffic.
+
+Either way, you need to download and install a local proxy. These instructions use [Proxyman](https://proxyman.io/download). Once you download and install Proxyman, you will need to also install the Proxyman CA certs. These are needed to be able to route the secure traffic.
+
+
+#### Real Domain Proxy
+
+In this setup, the proxy is configured to route non-API traffic on the Staging domain to your local computer. So all requests _except_ the APIs will go the local host. The API calls will remain routed to the Stage domain.
+
+1. Create a new Allow List entry:
+ * _Tools_ => _Allow List_
+ * Name: `BHHS Stage`
+ * Rule: `https://stage.commonmoves.com*`
+ * Any, Use Wildcard
+ * Include all subpaths of this URL: Checked
+
+1. Create a new Map Remote Entry:
+ * _Tools_ => _Map Remote_
+ * Matching Rule:
+ * Name: `BHHS API`
+ * Rule: `https://stage.commonmoves.com(?!(/bin|/content)).*`
+ * Any, Use Regex
+ * Include all subpaths of this URL: Checked
+ * Map To:
+ * Protocol: `http`
+ * Host: localhost
+ * Port: 3000
+
+
+
+#### Local Proxy to Remote
+
+This setup uses a locally resolved domain, which will Proxyman will use to route the traffic. All non-API traffic will route to localhost, all API traffic will go to the Stage domain.
+
+1. Add an entry to `/etc/maps`:
+ Proxyman won't proxy localhost, so a custom domain is required. Add the following (if you already have a host entry for 127.0.0.1, simply add the new domain)
+> 127.0.0.1 proxyman.debug
+
+2. Create a self-signed cert. This is necessary for the AEM Cli to so that cookies can be persisted. It really doesn't matter what you answer for the questions. Just make sure you do not create the certs in the code repo, or add them to Git.
+
+(`/some/path` is used as a reference here, find an appropriate spot on your local computer)
+
+```
+$ cd /some/path
+$ openssl req -x509 -sha256 -nodes -newkey rsa:2048 -days 365 -keyout localhost.key -out localhost.crt
+```
+
+3. Create a new Allow List entry:
+ * _Tools_ => _Allow List_
+ * Name: *Localhost*
+ * Matching Rule `https:\/\/proxyman\.debug:\d+.*`
+ * Any, Use Regex
+ * Include all subpaths of this URL: checked
+
+4. Create a new Map Remote Entry:
+ * _Tools_ => _Map Remote_
+ * Matching Rule
+ * Name: *BHHS API*
+ * Rule: `https://proxyman.debug:\d+(/bin|/content).*`
+ * Any, Use Regex
+ * Include all subpaths of this URL: checked
+ * Map To
+ * Protocol: `https`
+ * Host: `stage.commonmoves.com`
+ * Port: `443`
+
+5. Staring the AEM local proxy requires also passing in the Cert info, to run using https:
+
+(`/some/path` is the same place you previously created the cert)
+
+```
+% aem up --tls-cert /some/path/localhost.crt --tls-key /some/path/localhost.key
+```
+
+To view Proxied site use: https://proxyman.debug:3000/
diff --git a/blocks/blog-details/blog-details.js b/blocks/blog-details/blog-details.js
index 392cf2da..626f65e1 100644
--- a/blocks/blog-details/blog-details.js
+++ b/blocks/blog-details/blog-details.js
@@ -1,6 +1,3 @@
-const urlParams = new URLSearchParams(window.location.search);
-export const API_HOST = urlParams.get('env') === 'stage' ? 'https://ignite-staging.bhhs.com' : 'https://www.bhhs.com';
-
function getBlogDetailsPath() {
const url = window.location.pathname;
const startIndex = url.indexOf('/blog/blog-detail/') + '/blog/blog-detail/'.length;
@@ -8,11 +5,11 @@ function getBlogDetailsPath() {
}
function buildApiPath() {
- return `${API_HOST}/blog/blog-detail/jcr:content/${getBlogDetailsPath()}.json`;
+ return `/blog/blog-detail/jcr:content/${getBlogDetailsPath()}.json`;
}
function buildImageUrl(path) {
- return `${API_HOST}${path}`;
+ return `${path}`;
}
/**
diff --git a/blocks/blog-listing/blog-listing.js b/blocks/blog-listing/blog-listing.js
index 7248bd4a..3bcacea9 100644
--- a/blocks/blog-listing/blog-listing.js
+++ b/blocks/blog-listing/blog-listing.js
@@ -2,9 +2,6 @@ import {
readBlockConfig,
} from '../../scripts/aem.js';
-const urlParams = new URLSearchParams(window.location.search);
-export const API_HOST = urlParams.get('env') === 'stage' ? 'https://ignite-staging.bhhs.com' : 'https://www.bhhs.com';
-
const DEFAULT_SCROLL_INTERVAL_MS = 6000;
const DEFAULT_DESCRIPTION_LENGTH = 141;
const category = window.location.pathname.split('/').filter(Boolean)[1] ?? '';
@@ -18,9 +15,9 @@ let scrollInterval;
function buildApiPath(offset, count) {
let url;
if (category === '') {
- url = `${API_HOST}/content/bhhs-franchisee/ma312/en/us/blog/jcr:content/root/blog_home.blogs.offset_${offset}.count_${count}.json`;
+ url = `/content/bhhs-franchisee/ma312/en/us/blog/_jcr_content/root/blog_home.blogs.offset_${offset}.count_${count}.json`;
} else {
- url = `${API_HOST}/content/bhhs-franchisee/ma312/en/us/blog/blog-category/jcr:content/root/blog_category.blogCategory.category_${category}.offset_${offset}.count_${count}.json`;
+ url = `/content/bhhs-franchisee/ma312/en/us/blog/blog-category/_jcr_content/root/blog_category.blogCategory.category_${category}.offset_${offset}.count_${count}.json`;
}
return url;
}
@@ -49,10 +46,6 @@ function trimDescription(description) {
return `${trimmedDescription.substring(0, DEFAULT_DESCRIPTION_LENGTH)}...`;
}
-function buildImageUrl(path) {
- return new URL(`${API_HOST}${path}`).href;
-}
-
function prepareBlogArticleUrl(link) {
return link.replace(/\.html$/, '');
}
@@ -72,9 +65,9 @@ function buildBlogItem(block, data, addClass = false) {
blogContainer.innerHTML = `