Html Version

Shreyu is built using Bootstrap v4.3.1. The code is super clean and well structured. The extensive use of SCSS along with Gulp build tools, allows easy modification of look and feel. The setup is one time only and highly recommended. However, if you are not planning to make any modification for styling, you might want to use already provided dist (compiled) version as well.

What's included

Extract the zip file you received after purchase and you would find the exact below files and folders:

  • shreyu/html --
    • ├── dist - A pre-compiled folder containing html, assets including css, js, etc
    • ├── src
      • ├── fonts - fonts files
      • ├── images - images files
      • ├── html
        • ├── partials - partials - including top bar, left sidebar, menus, etc
        • ├── templates - reusable partials templates e.g. dashboard
      • ├── js - all javascript files
      • ├── scss - all scss (sass) files
    • ├── gulpfile.js
    • ├── package.json
    • ├── yarn-lock.json
    • ├── README.md
Pre-requisites

We are using gulp. It allows to have complete automatation for build. In case if you don't know - Gulp is a a toolkit for automating painful or time-consuming tasks in frontend development workflow, so you can stop messing around and build something. You can read it more about it here. Please follow below steps to install and setup all pre-requisites:

  1. Nodejs

    Make sure to have the Node.js installed & running in your computer. If you already have installed nodejs on your computer, you can skip this step.

  2. Yarn

    Yarn is a package manager and dependency management. It allows easy management of all the third party dependency and plugins.

    Make sure to have the Yarn installed & running in your computer. If you already have installed yarn on your computer, you can skip this step.

  3. Gulp

    Make sure to have the Gulp installed & running in your computer. If you already have installed gulp on your computer, you can skip this step.

  4. Git

    Make sure to have the Git installed & running in your computer. If you already have installed git on your computer, you can skip this step

Getting Started

Once you have all pre-requisites installed and running, you are ready to get start with the template. First, go to the root folder (the folder created when you extract the zip) where the package.json is available and run the following command:

yarn install

This will download all required dependencies defined in package.json file. Once it finished running the command, it will generate a folder name node_modules where you'll be able to see downloaded packages.

Now you're good to go in running the template and view it in browser by running the command below:

yarn start

The template should be up and running in your browser.

You can also create a production ready build by running the command below:

yarn build

This will create a folder named dist in same folder. You might want to take this folder and deploy on root of your web server.

Customization

You can easily customize various elements including navbar, topbar, form elements etc by simply editing Sass files available in /src/scss directory. You can also remove unneeded components from app.scss file.

How to add new page?

We have provided a starter page (check src/html/pages-starter.html) which helps you to create new page. Please note following some important points.

  • Make sure that you have included css/bootstrap.min.css,css/app.min.css, css/icons.min.css and js/vendor.min.js, js/app.min.js in your html
  • Most of the default/basic form elements along with few advanced elements are available and bundled in the above css and js and so you don't need to include any css or js separately.
  • Note that, few elements e.g. charts, data tables, calendar, maps etc. requires you to include corresponding css and js files in your html.
How to change colors?

In order to change colors (including primary, secondary, success, info, danger, warning, etc.), do the following:

  • A file src/scss/_variables.scss is containing the overridden colors and other configurations of bootstrap. You can change any values here and it would get reflected in any bootstrap based components or elements.
How to change footer?

In order to add, change or remove any ui elements from footer or sidebar, simply edit in file src/html/partials/footer.html. The change would be reflected in all files automatically.

Layout and Sidebar

You can change or customize the overall layout or left side navigation easily. There are examples available for horizontal nav, dark theme, RTL, condensed side nav, fixed width (boxed), etc. You can check them under layouts menu option. Additionally, you can also modify the left side nav, topbar, etc.

How to change left side nav width?

In order to change the width of left side navigation bar, open a file src/scss/_variables.scss and change the value of variable $leftbar-width. The default value is set to 240px.

How to change background or menu text color?

In order to change the background color, open a file src/scss/scss/_variables.scss and change the value of variable $bg-leftbar-light the default light value is set to #ffffff, $bg-leftbar-dark the default dark value is set to #323742.

When you change the background color, you might want to change the color of menu accordingly. To change the color of menu item, change the variable $menu-item (Default is set to #4B4B5A). Similarly, change the value of variables $menu-item-hover and $menu-item-active.

You can change other styles by making modifications in src/scss/custom/structure/_left-menu.scss.

2019 © Shreyu. All Rights Reserved. Crafted with by Coderthemes