Configuration

Jekyll assets uses your default _config.yml built into Jekyll. A lot of our configuration transforms based on the JEKYLL_ENV variable set in your environment. Such as digesting and whether or not to enable the CDN. Some of them can be explicitly overridden but a few cannot right now. You should set your JEKYLL_ENV=development on your development machine and JEKYLL_ENV=production when building to push.

Development Defaults

assets:
  compress:
    css: false
    js: false

  #

  autowrite: true
  cache: .asset-cache
  cache_type: filesystem
  skip_baseurl_with_cdn: false
  skip_prefix_with_cdn: false
  prefix: "/assets"
  digest: true

  #

  sources:
    - _assets/css
    - _assets/images
    - _assets/javascripts
    - _assets/stylesheets
    - _assets/fonts
    - _assets/img
    - _assets/js

  #

  features:
    liquid: false
    integrity: false
    automatic_img_size: true
    automatic_img_alt : true

Production Defaults

assets:
  compress:
    css: true
    js:  true

  #

  autowrite: true
  cache: .asset-cache
  cache_type: filesystem
  skip_baseurl_with_cdn: false
  skip_prefix_with_cdn: false
  prefix: "/assets"
  digest: true

  #

  sources:
    - _assets/css
    - _assets/images
    - _assets/javascripts
    - _assets/stylesheets
    - _assets/fonts
    - _assets/img
    - _assets/js

  #

  features:
    liquid: false
    integrity: false
    automatic_img_size: true
    automatic_img_alt : true

Your Source Folders

The listed resources in the example are all defaults. It should be noted that we append your sources instead of replace our resources with yours. So if you add _assets/folder then we will append that to our sources and both will work. NOTE: if you use our _assets base folder container as a base folder for your sprockets, we will not append our sources, we will only use that folder as the sole source (base folder.)