Skip to main content
skill CX Codex

bootstrap-npm — Claude Code skill: what it does, how to install

bootstrap-npm — a skill for Claude Code and Cursor builds a Bootstrap 6 starter project using npm and command-line tools without a bundler. Runs when setting up Bootstrap with npm or compiling Sass.

MIT 639 installs ★ 175,109 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add twbs/bootstrap --skill bootstrap-npm -a claude-code
Open on GitHub

What bootstrap-npm does

The skill sets up a Bootstrap 6 project that compiles Sass to CSS using npm command-line tools and PostCSS without a JavaScript bundler. It requires Node.js, terminal familiarity, and dependencies such as sass, autoprefixer, and postcss-cli. Bootstrap 6 targets browsers that support oklch() and color-mix().

The workflow covers creating the scss and css directories, configuring postcss.config.js and stylelint.config.mjs, and adding the Sass import via the modern @use rule. Local tooling includes nodemon for watching changes and sirv for local serving.

What it helps with

  • build a Bootstrap 6 starter project without a bundler
  • compile Sass to CSS from the command line
  • configure PostCSS and stylelint for Bootstrap
  • set up npm scripts for Bootstrap development

Example prompts for the agent

  • Set up a Bootstrap 6 starter project using npm and sass
  • Create project directories and configure postcss for bootstrap-npm
  • Run the development server to check the compiled styles

How to install bootstrap-npm

1Skills CLI (Vercel)

npx skills add twbs/bootstrap --skill bootstrap-npm -a claude-code

2Manually: put the files in place

~/.claude/skills/bootstrap-npm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/bootstrap-npm/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about bootstrap-npm

How to install bootstrap-npm in Claude Code?

Run npx skills add twbs/bootstrap --skill bootstrap-npm -a claude-code followed by checking ~/.claude/skills/bootstrap-npm/SKILL.md.

What does bootstrap-npm do?

It sets up a Bootstrap 6 project compiling Sass to CSS via npm command-line tools without requiring a JS bundler.

What is required to run bootstrap-npm?

It requires Node.js, terminal familiarity, and npm packages including bootstrap, sass, postcss, and nodemon.

Source text

SKILL.md · MIT
---
name: bootstrap-npm
description: Build a Bootstrap 6 starter project using just npm and command-line tools (no bundler). Use when setting up Bootstrap with npm, compiling Bootstrap's Sass to CSS from the command line, or creating an npm-based Bootstrap project.
guide: /guides/npm
---

# Bootstrap 6 with npm

Set up a Bootstrap 6 project that compiles Sass to CSS using npm command-line tools, with no JavaScript bundler. Bootstrap's pre-built JS bundle is loaded directly via a `<script>` tag. Requires Node.js and terminal familiarity.

## Workflow

- [ ] Step 1: Set up npm and install dependencies
- [ ] Step 2: Create the project structure
- [ ] Step 3: Configure npm scripts and config files
- [ ] Step 4: Import Bootstrap's Sass
- [ ] Step 5: Verify

---

## Step 1: Set up npm and install dependencies

1. Create the project and initialize npm:

   ```sh
   mkdir my-project && cd my-project
   npm init -y
   ```

2. Install Bootstrap and its optional peer dependencies (omit `@floating-ui/dom` if not using menus/popovers/tooltips; omit `vanilla-calendar-pro` if not using the datepicker):

   ```sh
   npm i --save [email protected] @floating-ui/dom vanilla-calendar-pro
   ```

3. Install the tools to compile and post-process CSS:

   ```sh
   npm i --save-dev autoprefixer postcss postcss-cli sass
   ```

4. Install local dev tooling (watch, run scripts, serve, lint):

   ```sh
   npm i --save-dev nodemon npm-run-all sirv-cli stylelint stylelint-config-twbs-bootstrap
   ```

---

## Step 2: Create the project structure

```sh
mkdir {css,scss}
touch index.html scss/styles.scss postcss.config.js stylelint.config.mjs
```

Target layout:

```text
my-project/
├── css/
├── scss/
│   └── styles.scss
├── stylelint.config.mjs
├── index.html
├── package-lock.json
├── package.json
└── postcss.config.js
```

---

## Step 3: Configure npm scripts and config files

1. `postcss.config.js` — run Autoprefixer after Sass:

   ```js
   const autoprefixer = require('autoprefixer')

   module.exports = {
     plugins: [
       autoprefixer
     ]
   }
   ```

2. `index.html` — link the compiled CSS and load Bootstrap's pre-built JS bundle (no bundler here, so use `dist`):

   ```html
   <!doctype html>
   <html lang="en">
     <head>
       <meta charset="utf-8">
       <meta name="viewport" content="width=device-width, initial-scale=1">
       <title>Bootstrap w/ npm</title>
       <link rel="stylesheet" href="css/styles.css">
     </head>
     <body>
       <div class="container py-4 px-3 mx-auto">
         <h1>Hello, Bootstrap and npm!</h1>
         <button class="btn-solid theme-primary">Primary button</button>
       </div>
       <script type="module" src="node_modules/bootstrap/dist/js/bootstrap.bundle.min.js"></script>
     </body>
   </html>
   ```

3. `package.json` — add scripts. Note `--load-path=node_modules` so Sass resolves `bootstrap`:

   ```json
   {
     "scripts": {
       "css-compile": "sass --load-path=node_modules --style expanded --source-map --embed-sources scss:css",
       "css-prefix": "postcss --config postcss.config.js --replace \"css/*.css\" \"!css/*.min.css\"",
       "build": "npm-run-all --sequential css-compile css-prefix",
       "watch": "nodemon --watch scss/ --ext scss --exec \"npm run build\"",
       "serve": "sirv --port 8080 --dev .",
       "start": "npm-run-all build --parallel watch serve",
       "lint": "stylelint \"scss/**/*.scss\""
     }
   }
   ```

4. `stylelint.config.mjs`:

   ```js
   /** @type {import('stylelint').Config} */
   export default {
     extends: 'stylelint-config-twbs-bootstrap'
   }
   ```

5. Start the dev server:

   ```sh
   npm start
   ```

---

## Step 4: Import Bootstrap's Sass

Add to `scss/styles.scss` using the modern `@use` rule (never `@import`):

```scss
// Import all of Bootstrap's CSS
@use "bootstrap/scss/bootstrap";
```

Customize tokens with `with ()` — include only the keys you want to change:

```scss
@use "bootstrap/scss/bootstrap" with (
  $root-tokens: (
    --border-radius: .25rem,
    --spacer: 1.5rem,
  )
);
```

Override CSS custom properties through the token maps (`$root-tokens` and each component's `$*-tokens` map), following [Customize › Sass](https://getbootstrap.com/docs/6.0/customize/sass/#compile-time-overrides). Token names are written **unprefixed** in Sass (e.g. `--border-radius`, `--spacer`); Bootstrap's dist/CDN CSS runs PostCSS to add the `--bs-` prefix, so compiling the source yourself keeps them unprefixed.

---

## Step 5: Verify

1. Run `npm start` and open `http://localhost:8080` — the `.container` and `.btn-solid.theme-primary` button should be styled once the CSS compiles.
2. Confirm `css/styles.css` is generated and updates when you edit `scss/styles.scss` (watch is running).
3. Confirm no console errors from the JS bundle.
4. Run `npm run lint` to check Sass against Bootstrap's stylelint config.
5. Bootstrap 6 requires a browser that supports `oklch()` and `color-mix()`.

For an optimized build that imports only the parts of Bootstrap you use, see the [twbs/examples sass-js project](https://github.com/twbs/examples/tree/main/sass-js).

© twbs · MIT · twbs/bootstrap

Similar skills

All skills for Frontend and UI →

From the same set11

The whole set →
bootstrap-component-js The bootstrap-component-js Claude Code skill guides JavaScript work on Bootstrap 6 components. It applies when adding a TypeScript module, wiring events and the data API, or wrapping a third-party library. CX Codex +1 687installs bootstrap-v6-install bootstrap-v6-install — a skill for Claude Code and Cursor that sets up Bootstrap 6 via CDN or package manager. The script configures Sass, JavaScript, and local paths. CX Codex +1 677installs bootstrap-utility-api bootstrap-utility-api — a skill for Claude Code that manages the Bootstrap 6 utility API. It helps add, modify, or remove utility classes by editing the $utilities Sass map. CX Codex +1 676installs bootstrap-v5-v6-migration bootstrap-v5-v6-migration is a Claude Code skill that guides project upgrades from Bootstrap 5 to 6. It runs when updating build tools, CSS classes, components, Sass tokens, or scripts. CX Codex +1 667installs bootstrap-vite The bootstrap-vite Claude Code skill sets up Bootstrap 6 CSS and JavaScript in a Vite project. It activates for project setup or when bundling Bootstrap Sass through Vite. CX Codex +1 641installs bootstrap-parcel The bootstrap-parcel Claude Code skill sets up Bootstrap 6 in a Parcel project. It connects Sass and JavaScript, adds a start script, and guides the build check. CX Codex +1 612installs bootstrap-webpack bootstrap-webpack — a skill for Claude Code and Codex that bundles Bootstrap 6 CSS and JavaScript with Webpack. Activates when configuring loaders for Sass or starting a fresh Bootstrap build. CX Codex +1 607installs bootstrap-v4-v6-migration The bootstrap-v4-v6-migration Claude Code skill guides a Bootstrap 4 project through an upgrade to Bootstrap 6 via version 5. It activates for migration requests involving legacy classes, attributes, or JavaScript. CX Codex +1 604installs

Project sponsors

Companies that keep this analytics open