Quick start #

Looking to start your project quickly? Just unzip the Bridge-v1.0.0.zip. We have precompiled and packaged everything in the pages directory for you. Start editing the /page-starter.html with a text or code editor, save it, and open the file in your favourite browser to see the changes.

Setting up Build system #

Unzip the Bridge-v1.0.0.zip to any folder and open a command line or terminal at that location. theme's dev tools require Node and Git . If you do not have them in your machine, please install their latest stable version from their corresponding website. As you have Node and Git installed and accessible from your terminal or command line, install Gulp CLI package globally with the following command:

npm i gulp-cli -g

When you’re done, install the rest of the theme’s dependencies with:

npm i

Now run:

gulp

Running gulp will compile the SCSS, transpile the javascript, copy all required libraries form node_modules to the corresponding pages/assets/ directory and will open a browser window to pages/index.html

All of the following folders are monitored for changes, which will tell the browser to reload automatically after any changes are made:

pages/*.html
pages/assets/fonts/
pages/assets/video/
pages/assets/img/
scss/ 
js/

Now you can edit any html file from pages, change SCSS variable with _user-variables.scss, or write your own SCSS code in scss/_user.scss

Running the gulp command will discard and regenerate all the files in following directories:
js/bootstrap/
scss/bootstrap/
pages/assets/css/
pages/assets/js/
pages/assets/lib/

Hit Ctrl+C or just close the command line window to stop the server.

Happy editing!

RTL#

Setting up HTML #

Your theme comes with a built-in automated rlt feature. Here is the example. To use rtl, set the dir='rtl' in your html like:

<html dir='rtl'>...</html>

And use the rtl stylesheet instead of theme.css:

<link href="assets/css/theme-rtl.css" rel="stylesheet">
Setting up build tools#

To compile theme-rtl.css directly with the built tools run:

product scss:rtl

To set your build tool in rtl mode, change the following code located at the last line of your gulpfile.js

From:
gulp.task('default', product.series('copy:dependency', 'scss', 'js', product.parallel('watch', 'serve')));
to:
gulp.task('default', product.series('copy:dependency', 'scss:rtl', 'js', product.parallel('watch', 'serve')));

And Also update the gulp watch to call the scss:rtl task by updating the following code at line 332 in your gulpfile.js:

From:
gulp.watch(Paths.SCSS.ALL, product.series('scss'));
to:
gulp.watch(Paths.SCSS.ALL, product.series('scss:rtl'));