You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Mar 30, 2023. It is now read-only.
Copy file name to clipboardExpand all lines: README.md
+12-9Lines changed: 12 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@
8
8
9
9
## About
10
10
11
-
`bootstrap-npm-starter` is a GitHub template repository for creating new Bootstrap-powered npm projects, maintained by Bootstrap co-author @mdo. You can also use it as your own Bootstrap prototyping sandbox. It's built with Bootstrap v4 with plans to update for v5.
11
+
`bootstrap-npm-starter` is a GitHub template repository for creating new Bootstrap 4 based npm projects, maintained by Bootstrap co-author @mdo. You can also use it as your own Bootstrap prototyping sandbox. For Bootstrap 5 examples, see [our new `twbs/examples` repo](https://github.com/twbs/examples).
@@ -19,15 +19,15 @@ Setup as a starter template, you can easily generate a new GitHub repository. Fr
19
19
## What's included
20
20
21
21
- Single HTML page (`index.html`) to demonstrate how to include Bootstrap.
22
-
- Includes [Bootstrap](https://getbootstrap.com) (currently using v4.6.0) source files via npm.
23
-
- Includes [Bootstrap Icons](https://icons.getbootstrap.com) (v1.4.0), which includes over 1,200 icons available as SVGs and web fonts.
24
-
- npm scripts (see `package.json`) for compiling and autoprefixing Sass, watching for changes, and starting a basic local server.
22
+
- Includes [Bootstrap](https://getbootstrap.com) (currently using v4.6.2) source files via npm.
23
+
- Includes [Bootstrap Icons](https://icons.getbootstrap.com) (v1.9.1), which includes over 1,800 icons available as SVGs and web fonts.
24
+
- npm scripts (see `package.json`) for compiling and autoprefixing Sass, watching for changes, and starting a local server with live reload.
25
25
- Example stylesheet (`scss/starter.scss`) highlighting two ways to include and customize Bootstrap.
26
26
- Example JavaScript file (`assets/js/starter.js`) showing how to import all of Bootstrap, or just the parts you need.
27
27
28
28
## Usage
29
29
30
-
Be sure to have [Node.js](https://nodejs.org/) installed before proceeding.
30
+
Be sure to have [Node.js](https://nodejs.org/) installed before proceeding.**We recommend using Node's LTS releases, which is currently at v16.x. We only test our compiled CSS against v16.**
31
31
32
32
```shell
33
33
# Clone the repo
@@ -40,17 +40,20 @@ npm i
40
40
# Compile Sass
41
41
npm run css-compile
42
42
43
+
# Start server and watch Sass
44
+
npm start
45
+
43
46
# Watch Sass for changes (uses nodemon)
44
47
npm run watch
45
48
46
-
# Start local server (uses sirv-cli)
49
+
# Start local server
47
50
npm run server
48
51
49
52
# Watches Sass for changes and starts a local server
50
53
npm start
51
54
```
52
55
53
-
For the most straightforward development, open two Terminal tabs to execute `npm run server` and `npm run watch` at the same time.
56
+
For the most straightforward development, open Terminal and run `npm start`.
54
57
55
58
Open <http://localhost:3000> to see the page in action.
56
59
@@ -60,7 +63,7 @@ The following npm scripts are available to you in this starter repo. With the ex
60
63
61
64
| Script | Description |
62
65
| --- | --- |
63
-
|`server`| Starts a local server (<http://localhost:3000>) for development |
66
+
|`server`| Starts a local server (<http://localhost:3000>) for development with live reloads |
64
67
|`watch`| Automatically recompiles CSS as it watches the `scss` directory for changes |
65
68
|`css`| Runs `css-compile` and `css-prefix`|
66
69
|`css-compile`| Compiles source Sass into CSS |
@@ -121,4 +124,4 @@ At the root of the repo, `.stylelintignore` is used to list files that we ignore
0 commit comments