feat: improve build profile DevEx — a la carte collection picker, copy buttons, contributing guide link by yi-nuo426 · Pull Request #7588 · layer5io/layer5

yi-nuo426 · 2026-04-04T17:41:53Z

Summary

This PR improves the developer experience around site build profiles, make targets, and the lite-mode placeholder page that contributors see when visiting a disabled route.

Make targets

make site-content — new target for the content profile (blog/news/events/resources included; members/integrations skipped). Previously the content profile existed in code but had no make target — it was only discoverable via an echo hint in make site.
make site-custom — new target for fully à la carte builds. Uses a new none base profile (zero preset exclusions) so BUILD_COLLECTIONS_EXCLUDE is the only thing that controls what is skipped. Example: BUILD_COLLECTIONS_EXCLUDE=members,events make site-custom
make profiles — new target that lists all profiles, their excluded collections, and the BUILD_COLLECTIONS_EXCLUDE escape hatch.
make cache-clean — new target that clears the Gatsby cache without triggering a full production rebuild. The existing make clean does both, which surprised contributors who just wanted to reset cache.
make site-analyze — fixed missing ## help comment and .PHONY entry (was invisible to make help output).
site-fast — description updated from the useless "Alternate method" to a precise description of what it actually skips.

npm scripts

develop:content — mirrors develop:lite with LITE_BUILD_PROFILE=content.
develop:custom — uses LITE_BUILD_PROFILE=none for the à la carte target.
start:content — alias consistent with the existing start / start:full pattern.

build-collections.js

Added none profile — excludes nothing by default, making BUILD_COLLECTIONS_EXCLUDE the sole driver of exclusions for make site-custom.

Lite-mode placeholder page

The placeholder shown when a contributor visits a disabled route (e.g. /blog in core mode) now has three improvements:

Copy-to-clipboard buttons on every suggested make command.
A la carte collection picker — six checkboxes that dynamically generate the correct make command as you toggle them. The current route's collection is pre-checked.
Link to the contributing guide (CONTRIBUTING.md#environment-variables) for full profile documentation.

Lint-staged fix

Added --no-warn-ignored to the ESLint call in .lintstagedrc.js. src/utils/ is in ESLint's ignore list, but lint-staged passes files explicitly, causing a warning that tripped --max-warnings=0 on every commit touching a src/utils/ file.

Test plan

- Add `make site-content` target for the content profile (blog/news/events/resources included; members/integrations skipped) — previously only discoverable via an echo hint - Add `make site-custom` target backed by a new `none` profile that starts with zero preset exclusions, so BUILD_COLLECTIONS_EXCLUDE fully controls what is skipped - Add `make profiles` target that lists all profiles with their excluded collections and documents the BUILD_COLLECTIONS_EXCLUDE escape hatch - Add `make cache-clean` to clear Gatsby cache without triggering a full production rebuild (the existing `make clean` does both, which surprised contributors) - Add `develop:content` and `develop:custom` npm scripts to support the new targets - Fix `site-analyze` missing ## help comment and .PHONY entry - Improve `site-fast` description from "Alternate method" to something accurate - Update lite-placeholder.js with three contributor-facing improvements: * Copy-to-clipboard button on every suggested make command * A la carte collection picker — checkboxes generate the exact make command needed; the current route's collection is pre-checked for convenience * Link to the contributing guide's Environment Variables section - Pass `collection` name through gatsby-node.js litePlaceholderPages context so the template can pre-select the relevant checkbox - Add `none` profile to build-collections.js as the foundation for a la carte builds - Fix lint-staged silently failing on files in ESLint-ignored directories (add --no-warn-ignored to suppress the spurious warning that tripped --max-warnings=0) Signed-off-by: Lee Calcote <lee.calcote@layer5.io>

Copilot

Pull request overview

This PR improves developer experience around build profiles/targets and enhances the lite-mode placeholder UX to help contributors quickly re-enable disabled collections.

Changes:

Adds new build profiles and ergonomics: site-content, site-custom, profiles, and cache-clean; improves Makefile help text and fixes site-analyze visibility.
Adds npm scripts for content and custom lite development modes.
Upgrades the lite placeholder page with copy-to-clipboard buttons, an à la carte collection picker, and a link to contributing docs.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 7 comments.

Show a summary per file

File	Description
src/utils/build-collections.js	Adds a `none` lite profile to enable fully à la carte exclusion via `BUILD_COLLECTIONS_EXCLUDE`.
src/templates/lite-placeholder.js	Adds copy buttons, collection picker, and contributing guide link to the lite-mode placeholder page.
package.json	Adds `develop:content`, `develop:custom`, and `start:content` scripts for new profiles.
gatsby-node.js	Passes `enabledBy` and `collection` into placeholder context to drive UI defaults.
Makefile	Introduces new targets (`site-content`, `site-custom`, `profiles`, `cache-clean`) and improves help output.
.lintstagedrc.js	Prevents `--max-warnings=0` failures caused by ESLint “ignored file” warnings during lint-staged runs.

src/templates/lite-placeholder.js

- Guard navigator.clipboard with isSecureContext + optional chaining before writing; eliminates throws in non-secure or unsupported contexts - Store setTimeout id in useRef and clear in useEffect cleanup to avoid state-update-on-unmounted-component React warning on rapid unmount - Add type="button" to prevent unintended form submission - Add aria-live polite status span so screen readers announce copy success - Remove duplicate <SEO> from component body; keep only the Head export (Gatsby 5 manages head state via the exported Head — dual rendering produced duplicate meta tags) - Replace index-based isContentProfile check with Set membership test to guard against future collection renames or insertions Signed-off-by: Lee Calcote <lee.calcote@layer5.io>

yi-nuo426 · 2026-04-08T04:40:34Z

/gemini review

Copilot

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

src/templates/lite-placeholder.js

Copilot · 2026-04-08T04:41:54Z

src/templates/lite-placeholder.js

+          background: copied ? "#00b39f" : "transparent",
+          border: "1px solid #00b39f",
+          borderRadius: "4px",
+          color: copied ? "#fff" : "#00b39f",


The same brand color literal (#00b39f) is duplicated across multiple inline style objects, which makes future theme/color updates error-prone. Consider extracting a shared constant (or using an existing theme token) and reusing it in the style objects to keep the styling consistent and easier to change.

Fixed — extracted a BRAND_COLOR constant and replaced all inline occurrences.

Copilot · 2026-04-08T04:41:54Z

src/templates/lite-placeholder.js

+        All build profiles and environment variables are documented in the{" "}
+        <a
+          href="https://github.com/layer5io/layer5/blob/master/CONTRIBUTING.md#environment-variables"
+          style={{ color: "#00b39f" }}


The same brand color literal (#00b39f) is duplicated across multiple inline style objects, which makes future theme/color updates error-prone. Consider extracting a shared constant (or using an existing theme token) and reusing it in the style objects to keep the styling consistent and easier to change.

Fixed — same BRAND_COLOR constant covers this occurrence as well.

…lder Signed-off-by: Yi Nuo <218099172+yi-nuo426@users.noreply.github.com>

banana-three-join

LGTM and really cool feature! :]

Siddhi-sahu

Everything looks solid👍
just to confirm - For site-custom , is there validation for invalid collection names in BUILD_COLLECTIONS_EXCLUDE??? maybe a simple guard would help, what do you think??

saurabhraghuvanshii · 2026-04-08T07:44:02Z

@yi-nuo426 I tried to build the site using make site, which runs develop:lite, but it doesn’t seem to work as expected. It consumes all my resources, and even after stopping the process, Gatsby keeps running in the background, crashing my laptop.

Siddhi-sahu · 2026-04-08T12:26:43Z

@yi-nuo426 I tried to build the site using make site, which runs develop:lite, but it doesn’t seem to work as expected. It consumes all my resources, and even after stopping the process, Gatsby keeps running in the background, crashing my laptop.

yes same

leecalcote · 2026-04-08T17:03:24Z

@yi-nuo426 I tried to build the site using make site, which runs develop:lite, but it doesn’t seem to work as expected. It consumes all my resources, and even after stopping the process, Gatsby keeps running in the background, crashing my laptop.

@saurabhraghuvanshii is this different than your current experience?

leecalcote · 2026-04-08T17:04:52Z

@Siddhi-sahu, @saurabhraghuvanshii, when you run LITE_BUILD_PROFILE=content make site, do you have a similar experience?

Siddhi-sahu · 2026-04-08T17:39:24Z

@Siddhi-sahu, @saurabhraghuvanshii, when you run LITE_BUILD_PROFILE=content make site, do you have a similar experience?

yes, same, at least for me.

saurabhraghuvanshii · 2026-04-08T18:03:29Z

@yi-nuo426 I tried to build the site using make site, which runs develop:lite, but it doesn’t seem to work as expected. It consumes all my resources, and even after stopping the process, Gatsby keeps running in the background, crashing my laptop.

@saurabhraghuvanshii is this different than your current experience?

Yes. but I noticed same behaviour on master branch so issue is something else.

arjunmehta-git · 2026-04-09T07:37:40Z

Already approved — just want to add a note for the community here.

This is a genuinely thoughtful developer experience improvement, @yi-nuo426. The à la carte collection picker, copy-to-clipboard buttons on every make command, and the contributing guide link in the placeholder page all address real friction points that come up repeatedly in community onboarding. The make profiles target and make cache-clean are small additions that will save contributors from a lot of unnecessary full rebuilds.

Regarding the memory issue raised by @saurabhraghuvanshii and @Siddhi-sahu: confirmed that the behavior they're seeing exists on master as well — so it's not a regression introduced by this PR. That's a separate tracking item.

The --no-warn-ignored fix to .lintstagedrc.js is a nice catch that will save contributors from confusing lint failures on src/utils/ files.

Great contribution.

Copilot AI review requested due to automatic review settings April 4, 2026 17:41

github-actions bot added the area/site-config label Apr 4, 2026

Copilot AI reviewed Apr 4, 2026

View reviewed changes

alexquincy requested review from Bhumikagarggg, Rajesh-Nagarajan-11 and saurabhraghuvanshii April 6, 2026 18:44

saurabhraghuvanshii requested review from YASHMAHAKAL and rishiraj38 April 6, 2026 18:56

yi-nuo426 requested a review from Copilot April 8, 2026 04:40

Copilot AI reviewed Apr 8, 2026

View reviewed changes

fix: responsive grid and extract brand color constant in lite-placeho…

664de31

…lder Signed-off-by: Yi Nuo <218099172+yi-nuo426@users.noreply.github.com>

banana-three-join reviewed Apr 8, 2026

View reviewed changes

Siddhi-sahu reviewed Apr 8, 2026

View reviewed changes

Merge branch 'master' into work/gracious-yalow

0a66839

leecalcote approved these changes Apr 8, 2026

View reviewed changes

Conversation

yi-nuo426 commented Apr 4, 2026

Summary

Make targets

npm scripts

build-collections.js

Lite-mode placeholder page

Lint-staged fix

Test plan

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

yi-nuo426 commented Apr 8, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Copilot AI Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

yi-nuo426 Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

yi-nuo426 Apr 8, 2026

Choose a reason for hiding this comment

Uh oh!

banana-three-join left a comment

Choose a reason for hiding this comment

Uh oh!

Siddhi-sahu left a comment

Choose a reason for hiding this comment

Uh oh!

saurabhraghuvanshii commented Apr 8, 2026

Uh oh!

Siddhi-sahu commented Apr 8, 2026

Uh oh!

leecalcote commented Apr 8, 2026

Uh oh!

leecalcote commented Apr 8, 2026

Uh oh!

Siddhi-sahu commented Apr 8, 2026

Uh oh!

saurabhraghuvanshii commented Apr 8, 2026

Uh oh!

arjunmehta-git commented Apr 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants