Skip to content

Docs: tell PostCSS installers to copy .browserslistrc too - #60

Merged
minimaldesign merged 1 commit into
mainfrom
docs-copy-browserslistrc
Aug 1, 2026
Merged

Docs: tell PostCSS installers to copy .browserslistrc too#60
minimaldesign merged 1 commit into
mainfrom
docs-copy-browserslistrc

Conversation

@minimaldesign

Copy link
Copy Markdown
Owner

What changed

One sentence added to Install with PostCSS in src/content/docs/start.mdx:

Copy [.browserslistrc][browserslistrc] from the repo root as well: it sets the compile floor that keeps postcss-preset-env from polyfilling the features mCSS uses natively.

Plus the [browserslistrc] link reference (alphabetical, between bemit and components) and a lastUpdate bump to 2026-07-31.

Why

The install section enumerates what a source install copies: src/styles/framework/, your own folder next to it, the entry file. .browserslistrc was not on that list, so an installer inherits whatever target the host project already has. That is the exact condition #56 was about: a broader target and postcss-preset-env starts polyfilling light-dark() and flattening nesting again, undoing what 1.3.0 just fixed.

The Browser support section (line 415) already says to keep the file, but only someone who reads that far finds out it exists. This links to it from the point where the copying happens.

Notes for review

  • Prose-only, one file. No CSS, no config, no dist/ churn.
  • lastUpdate was still 2026-07-28 even though Raise the compile floor to Baseline 2024, stop polyfilling light-dark() #57 rewrote the Browser support section on the 31st, so this bump also catches that up. Drop it if you would rather the date tracked only this change.
  • Verified in the production build: both links render, and id="browser-support" exists in the output so the in-page anchor resolves.

🤖 Generated with Claude Code

The install section lists what to copy (framework/, your own folder, an
entry file) but never mentioned .browserslistrc, so a source install
inherited whatever browserslist target the host project already had.
With a broader target postcss-preset-env starts polyfilling light-dark()
and flattening nesting, which is exactly what 1.3.0 removed.

The Browser support section already says to keep the file; this points
at it from the place where the copying actually happens.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@netlify

netlify Bot commented Aug 1, 2026

Copy link
Copy Markdown

Deploy Preview for mcssdev ready!

Name Link
🔨 Latest commit 10bd709
🔍 Latest deploy log https://app.netlify.com/projects/mcssdev/deploys/6a6d39d6d022780008fd17b0
😎 Deploy Preview https://deploy-preview-60--mcssdev.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 100
Accessibility: 98
Best Practices: 100
SEO: 97
PWA: 60
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@minimaldesign
minimaldesign merged commit 9930bcc into main Aug 1, 2026
5 checks passed
@minimaldesign
minimaldesign deleted the docs-copy-browserslistrc branch August 1, 2026 00:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant