# 1 Clone this repo
git clone https://github.com/wapbamboogie/bootstrap-4-boilerplate.git
# 2 Navigate into the repo directory
cd bootstrap-4-boilerplate
# 3 Install all node packages
npm install
# 4 Get started
gulp serve - starts localhost server with browser-sync, watches html sass js with hot reloading
gulp - minify css/js and builds your app into the dist directory, ready for production
This project requires you to have a installation of nodejs with npm This project also requires you to have global installations of gulp.
# Install gulp globally
npm install -g gulp
gulp serve
The gulp serve command starts a local Browsersync server that serves your files in the browser. It automatically reload the current page when changing html, sass and js files. The output of all sass files go to main.css. All js files are concatenated into main.js. You can access the project live in development with other devices on the same network. Go to the "External" address specified by Browsersync in the terminal in the browser of your device.
gulp serve
gulp (build)
The default gulp command is set to creating a "dist" directory with a production version of the project, ready to be deployed. It minifies and renames js/css assets as well as cleaning the old "dist" directory. CSS is autoprefixed for the latest two browser versions.
gulp
gulp concatScripts
The gulp concatScripts command combines the specified js ressources into main.js. You can add new js files to this command on line 16 in gulpfile.js You might want to run concatScripts once seperately after adding new js files.
gulp concatScripts
You can overwrite specific bootstrap sass variables by uncommenting lines in assets/css/1-frameworks/bootstrap/bootstrap-user-variables.scss
If you need a server with PHP support you can use the project with MAMP Pro or similiar.
- Place the project folder in the htdocs folder
- Create a new host in the hosts panel of MAMP Pro and choose the project folder as the document root
- Enable Symlinks settings in the "Extended" tab of the host configuration
- On line 59 in gulpfile.js change the browserSync.init function to the following:
browserSync.init({
proxy: "http://name-of-your-mamp-host:8888",
open: "external"
});
- Start the MAMP services and run "gulp serve" as before