Documentation of vali admin
│ ├── docs - compiled files │ ├── css │ ├── images │ └── js └── src - Layout and style source files ├── pug - Layout source └── sass - Style source
Compilation of source files
The theme is built using SASS and PugJs which are in turn compiled into HTML and CSS by Grunt. If you are not familiar with Grunt, here is an article to get started. If you are familiar with Grunt follow the instruction mentioned bellow to edit or customize the source.
If you don't want to edit theme you can use the compiled files directly inside
npm install command in project root directory to install and build dependencies.
npm run dev task to edit and compile source files on the go or use
npm run build task to compile all source files at once.
The layout is built using PugJs. All the layout source files are located in
src/pug directory. There are two sub directories inside this directory:
layout- Includes common HTML skeleton layout which is extended by all the pages
includes- Includes layout partials like sidebar and navbar and footer
The styles are written in SASS. All the style files are located in
src/sass directory. There is a file in this directory
main.sass which imports all the files and exported as main.css There are four sub directories inside this directory:
1-tools- It includes styles of all the external libraries and a file
_var.scsswhich contains the variables required for the application
2-basics- It contains the basic style like overall structure css and theming options
3-component- It contains the styles for the components like card, widgets, sidebar, navbar etc
4-pages- It contains the styles for the specific pages like login page, lock-screen page
To customize the primary color of the theme and sidebar you need to change the variables in the
1-tools/_var.scss. The detailed documentation about changing the colors is mentioned in this file itself.
If you don't want to use particular component or plug-in just comment the import statement for that particular component in
src/sass/main.scss and compile the SASS by running
npm run build command.
Compatibility with other frameworks
If you are using Node JS as your web server you can use pug as your layout engine to render html templates as is without compiling them to HTML. More details are available here.
To enable RTL support
- Uncomment this line
- Build the source files using
npm run buildcommand.
Contribution & Issues
If you liked the theme do star and fork it on GitHub. If you find anything missing or want to contribute to this documentation, the source is available here. If you have an issue or feature request regarding theme please report it here.