Site bootstrap

How to start a new Foundry site repo correctly to avoid the common setup mistakes found during the First Light build.

go.mod — Stable Default Uses .foundry/modules

Stable / deploy-safe default:

replace github.com/jerrybroughton/likestyle-foundry-core => ./.foundry/modules/likestyle-foundry-core

This is the normal locked-materialized mode used for local site work, CI, and deploy validation. It keeps the site aligned to the version pinned in the site lock and avoids accidental framework drift.

go.mod — Explicit Foundry-dev Exception

Only for intentional framework testing:

replace github.com/jerrybroughton/likestyle-foundry-core => ../likestyle-foundry-core

Use the sibling-repo replace only when you are deliberately validating active Foundry changes against a consumer site before release. That mode should be treated as temporary and should not be the default committed site baseline.

CSS Loading Order

In layouts/partials/head-end.html, CSS must load in this order:

1. foundry-dark-mode.css (from module)
2. Site palette CSS (e.g., bm-palette-a.css)
3. Site theme CSS (e.g., property-proof-site.css)

Transparent Nav — Hero Detection

When nav.transparent: true, the header JS should only apply white-text transparent styling on pages that open with a dark photo hero. See layouts/partials/body-end.html in property-proof-site-site for the reference implementation.

Flow System — bg: dark Text Contrast

When using bg: dark on a section, all child block text uses --foundry-text which defaults to dark in light mode. The flow system overrides this via .foundry-block--bg-dark { --foundry-text: light } in foundry-flow.css. If text still looks dark, check that foundry-flow.css is loading after theme.css.

Stats-Band Counter Animation

The data-foundry-count counter animation only runs on pure number values matching /^\d+(\.\d+)?[%xX+]?$/.

Values that animate: "4", "10", "365", "98%" Values that do NOT animate: "20 min", "Up to 10", "Fully", "Monthly+"

Always use pure integers or percentages for stats you want to count up.

masonry-gallery Image Keys

The masonry-gallery block accepts both src: and url: as the image path key:

images:
  - url: "/images/photo.jpg"   # works
    alt: "Description"
  - src: "/images/photo.jpg"   # also works
    alt: "Description"

Block Background + Theme Alternating Rows

The Shield theme applies a light surface gradient to every even .foundry-block > section. When using bg: dark or bg: brand via the flow system, foundry-flow.css clears this with background: none !important. If you add a new theme, make sure the flow system’s bg rules override any alternating-row styles.