Learn more about the file structure of Spaces Bootstrap Directory Listing Template
The following folders and files are considered as “source” files as these are which you are supposed to work with when developing.
html/ folder you’ll find all of the html templates.
partials/ are included in other html files with the help of gulp-file-include. Such files are
_head.html and so on.
Please check the official gulp-file-include documentation to learn how to use these partials.
All assets such as CSS, JS, images and fonts can be found in the
scss/ is one of the most important files in our product. Here you’ll find two folders and one important file:
scss/bootstrapis the scss code from Bootstrap 4. As our product is an extension of the Bootstrap 4 components, we made use of the variables and mixins provided by them.
scss/spacesholds the variables, mixins and custom components developed by Themesberg for spaces.
spaces/mixinsis where you can find the custom mixins developed by us similar to the ones from Bootstrap 4.
spaces/utilitieshas styles for custom helper classes for spacings, borders, shadows and many more.
spaces/vendoris the folder that holds styles for the external libraries we use for spaces. We use them here so that there will be only one minified css file. This way the files will load faster.
*.scssThe remaining files are the styles used for each component from spaces.
spaces.scssis where all the other scss files are imported. This file is later used in gulpfile.js to compile the code in CSS.
gulpfile.jsis where you’ll find the Gulp functions that generate, compile and serve our code.
index.htmlis the main html template.
package.jsonholds the theme dependencies.
README.mdcan never miss from a project. Here you can find basic information regarding the software we’ve developed.
.gitignoreis used to ignore folders such as node_modules or dist if you have a git instance.
These folders and files are generated by using based on our (gulp commands) and
dist/ folder will be generated when running the
gulp build:dist command. You’ll find html, js and css code in a minified state. Ideally you shouldn’t modify the content of these files, as they are supposed to be the generated code that you’ll use to go live.
html&css/ folder can be generated by running
gulp build:dev. This folder will have all the necessary files, unminified files of the project. We recommend to use this folder if you want a copy of the theme without Sass, Gulp or npm.
You might be wondering what the
.temp/ folder is all about. Long story short you don’t have to worry about it, as you shouldn’t modify files from there. It is dynamically generated by Gulp to serve the files to a local server through BrowserSync and show you how the product will look when it will finally get generated for production.
css/ folder is generated by gulp as it holds the compiled scss files. These files are automatically included by our html templates.
We recommend you to use scss as it is a powerful language where you can change variables to update colors, shadows, font families to your liking. If you choose otherwise, you can modify the main
spaces.css file by writing simple CSS.
Warning: if you write your own CSS in the
spaces.css file and run gulp it will override your file based on what the scss files hold.
node_modules/ folder contains external libraries generated based on