Quick and easy UI framework
CSS JavaScript HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Puddletown UI Bootstrap πŸ‘’

UI development environment with npm scripts, built with gulp & webpack. Produces fully optimized dist directories for templating.

Getting started

Install all modules, set up a fresh git repo and start the server.

npm run setup

and navigate to:


The project for dev and testing is built to the build directory.

Make all of your edits in the src directory.

running the application again after stopping server

npm start

To build the final project build for distribution/ templating

npm run build

The dist directory will be created with the output

Editing the CSS

SCSS is transpiled into CSS. Just edit the scss files.

They are structured as follows. Usually the 0000.scss is a good place to start. Just trash everything you don't want and build what you do.

β”œβ”€β”€ _0000.scss # the default style sheet (mobile first) 
β”œβ”€β”€ _0480.scss # the style sheet that begins at the 480px width breakpoint
β”œβ”€β”€ _0760.scss # 760px width breakpoint
β”œβ”€β”€ _0980.scss # etc
β”œβ”€β”€ _1200.scss
β”œβ”€β”€ _1400.scss
β”œβ”€β”€ _1600.scss
β”œβ”€β”€ includes
β”‚Β Β  β”œβ”€β”€ _colors.scss # all color info
β”‚Β Β  β”œβ”€β”€ _fonts.scss # all font info
β”‚Β Β  β”œβ”€β”€ _mixins.scss # all SASS mixin info
β”‚Β Β  β”œβ”€β”€ _plugins.scss # just dump all plugin code here
β”‚Β Β  β”œβ”€β”€ _reset.scss # keeps things clean in between browsers
β”‚Β Β  β”œβ”€β”€ _responsive.scss # master routing for all the top level scss files
β”‚Β Β  └── _typography.scss # includes with all typography info
└── styles.scss # master scss routing file

Editing the javascript

Javascript is bundled by webpack and babel is set for es5 - es7. Trash what you don't need and write exactly what and how you want.

To run tests on your javascript using mocha

npm test

Enjoy the SASS and bundled javascript!