add function and variable definitions for JS and SCSS
update README