Skip to content

Complete npm guide and migrate all guides to Sass @use modules#42135

Draft
Copilot wants to merge 2 commits intov6-devfrom
copilot/finish-npm-guide-sass-modules
Draft

Complete npm guide and migrate all guides to Sass @use modules#42135
Copilot wants to merge 2 commits intov6-devfrom
copilot/finish-npm-guide-sass-modules

Conversation

Copy link
Contributor

Copilot AI commented Mar 8, 2026

The npm guide was incomplete (placeholder sections only) and all bundler guides were using the deprecated Sass @import syntax instead of the modern @use module system.

npm guide — completed

Filled in the stubbed-out Configure npm and Import Bootstrap sections:

  • postcss.config.js with Autoprefixer
  • index.html linking compiled CSS and Bootstrap's pre-built JS bundle from node_modules
  • Full npm script set: css-compile, css-prefix, build, watch, serve, start, lint
  • .stylelintrc.json extending stylelint-config-twbs-bootstrap
  • Updated project structure tree to include postcss.config.js and .stylelintrc.json
  • Fixed erroneous "Vite" reference in setup step 3

All bundler guides — @import@use

Bootstrap v6 is fully @use/@forward-based and compiles without deprecation warnings when consumed via @use. Updated webpack, Parcel, and Vite guides accordingly:

// Before
@import "bootstrap/scss/bootstrap";

// After
@use "bootstrap/scss/bootstrap";
  • webpack: removed silenceDeprecations from sass-loader options, updated css-loader comment, removed the deprecation warning note
  • Parcel: removed the optional .sassrc.js silenceDeprecations block
  • Vite: removed silenceDeprecations from vite.config.js css.preprocessorOptions, removed the deprecation warning note

The npm guide references two screenshots (npm-dev-server.png, npm-dev-server-bootstrap.png) that follow the same naming convention as other guides but don't exist yet as image assets.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • telemetry.astro.build
    • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node node /home/REDACTED/work/bootstrap/bootstrap/node_modules/.bin/astro build --root site (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

Finish the npm guide in our Guides docs section. Be sure to use modern Sass modules instead of imports. Also be sure to include mention of all dependencies needed, including the postcss ones. Model the flow off our other, complete guides. Then, make sure the other guides are updated to the latest Sass modules approach.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Co-authored-by: mdo <98681+mdo@users.noreply.github.com>
Copilot AI changed the title [WIP] Complete npm guide with modern Sass modules Complete npm guide and migrate all guides to Sass @use modules Mar 8, 2026
Copilot finished work on behalf of mdo March 8, 2026 18:28
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.

2 participants