Static

Note

As /static is publicly accessible, avoid adding sensitive files into this directory.

Keep the root path of /static simple and clean. Only favicons should be placed there. They ultimately get picked up by the base_root.html template.

css/

CSS gets automatically compiled via /private/config.rb into this folder. You can add additional files such as *.htc if required. But always add CSS files through Sass.

fonts/

All fonts should be placed here including icon fonts. You can create sub-directories to create a better overview. This folder might not be required if you are implementing fonts via services such as Google Fonts or fonts.com.

img/

Demo images (which might be later integrated as media files via Filer) should be placed within /static/img/dummy. This folder will be ignored by the gulp preprocess and gulp images commands.

Make use of grouping and create additional sub-directories such as /static/img/icons or /static/img/visuals if the file count seems to be excessive.

js/

The same structure approach as described within Private is applied to the JS directory. /layout, /settings and /sites are not required, but may be used. jQuery is an essential part and should be treated the same as the Bootstrap component.

swf/

Old school, currently only required to use /static/js/libs/swfobject.min.js.