Configuration

Cassette uses code-based configuration to define asset bundles and what processing to apply to them. Your web application can contain a public class that implements Cassette.ICassetteConfiguration.

During application start-up, Cassette will create your configuration class and call the Configure method.

Here's the outline of a configuration class:

using Cassette.Configuration;

public class CassetteConfiguration : ICassetteConfiguration
{
    public void Configure(BundleCollection bundles, CassetteSettings settings)
    {
        // Put configuration here...
        // Add bundles to the bundles collection.
    }
}

The Cassette.Aspnet nuget package adds the CassetteConfiguration.cs file to your project.

Cassette settings

The CassetteSettings controls the runtime behavior of Cassette.

IsDebugingEnabled: When true, asset bundles are concatenated, minified, cached, versioned, etc.; Default value is read from Web.config.
UrlModifier: If you need to change how Cassette generates URLs for assets and bundles, this is the place to provide your own implementation of Cassette.IUrlModifier.; The main use case would be prefixing URLs with a static/CDN domain name.; Please ask in the Cassette Google Group for help with this.
IsHtmlRewritingEnabled: Defaults to true.; When true Cassette will buffer and rewrite page HTML output. This means that if a partial view references a stylesheet after <head> has been rendered, the required <link> can still be inserted.; Please note, this does not work in IIS when <urlCompression dynamicCompressionBeforeCache="true"/>. You will need to disable IsHtmlRewritingEnabled if you use that feature of IIS.

Web.config

Cassette provides a optional configuration section you can add to Web.config.

<configuration>
  <configSections>
    <section name="cassette" type="Cassette.Configuration.CassetteConfigurationSection, Cassette"/>
  </configSections>
  <cassette debug="true" rewriteHtml="true"/>
</configuration>

If the debug attribute is missing then the value of <system.web>/<compilation debug="..."> is used.