Merge pull request #7487 from layer5io/fix/gatsby-lite-dev-memory

fix(dev): reduce Gatsby local memory usage

Author: hortison

CONTRIBUTING.md

@@ -519,6 +519,8 @@ Environment variables are named values used to configure how an application beha
 | Variable | Possible Values | Description |
 |---------|----------------|------------|
 | `BUILD_FULL_SITE` | `true`, `false` | When set to `true`, enables a full site build including all collections. If not explicitly set to `true`, the project defaults to a lightweight build. |
+| `LITE_BUILD_PROFILE` | `content`, `core` | Selects which collections are excluded when `BUILD_FULL_SITE=false`. `core` is the default for `make site`, `npm start`, and `npm run dev`, while `content` keeps blog, news, events, and resources enabled. |
+| `BUILD_COLLECTIONS_EXCLUDE` | comma-separated collection names | Adds extra collections to exclude from a lightweight build without editing project files. |
 | `NODE_ENV` | `development`, `production` | Determines the build and rendering mode used by Gatsby. This is automatically set by Gatsby. <br><br>• `development` - Uses **Deferred Static Generation (DSG)** i.e pages built on demand for faster startup.  <br>• `production` - Uses **Server-Side Rendering (SSR)** i.e pages rendered on each request for fresh content. |
 | `CI` | `true`, `false` | Indicates that the build is running in a **Continuous Integration (CI)** environment (e.g., GitHub Actions). When set to `true`, special logic is applied to page paths and redirects for GitHub Pages compatibility. This is typically set automatically by the CI system and does not need to be configured manually. |
 

Makefile

@@ -21,7 +21,8 @@ setup:
 # "make site" - The default lightweight build keeps the dev server fast by skipping heavy collections.
 ## Run a partial build of layer5.io on your local machine.
 site:
-	@echo "🏗️  Building lightweight site version (excluding Members and Integrations collections)..."
+	@echo "🏗️  Building lightweight site version (core profile excludes Members, Integrations, Blog, News, Events, and Resources collections)..."
+	@echo "   Use LITE_BUILD_PROFILE=content make site to include content collections while still skipping the heaviest routes."
 	@npm run develop:lite
 
 # "make site-full" forces the dev server to include every collection.
@@ -32,7 +33,7 @@ site-full:
 
 ## Run layer5.io on your local machine. Alternate method.
 site-fast:
-	NODE_OPTIONS=--max-old-space-size=8192 gatsby develop
+	BUILD_FULL_SITE=false LITE_BUILD_PROFILE=core GATSBY_CPU_COUNT=4 SHARP_CONCURRENCY=4 UV_THREADPOOL_SIZE=4 NODE_OPTIONS=--max-old-space-size=8192 gatsby develop
 
 ## Build layer5.io on your local machine.
 build:

gatsby-browser.js

@@ -2,6 +2,9 @@ import "./fonts.css";
 import "slick-carousel/slick/slick.css";
 import "slick-carousel/slick/slick-theme.css";
 
+export const disableCorePrefetching = () =>
+  process.env.NODE_ENV === "development";
+
 document.addEventListener("DOMContentLoaded", () => {
   /** init gtm after 3500 seconds - this could be adjusted */
   setTimeout(initGTM, 3500);