Click here to Skip to main content
15,172,078 members
Articles / Web Development / ASP.NET
Posted 16 Nov 2014


60 bookmarked

Introducing Dynamic Bundles for ASP.NET MVC

Rate me:
Please Sign up or sign in to vote.
4.87/5 (34 votes)
13 Dec 2014CPOL6 min read
Co-locate HTML, CSS, JavaScript and image files that make up a page or component. Auto generate your MVC bundles to ensure the right files are loaded in the right order.


When your site grows in complexity, it makes sense to keep it maintainable by using components, such as partial views, DisplayTemplates and EditorTemplates.

The problem is that while you can organize your HTML this way, your CSS, JavaScript and images are still stored in their own directories - with no clear indication exactly what CSS, etc. is used by which partials. Essentially, the implementation of each partial is spread over up to 4 directories.

That makes it very easy to break a partial when changing a CSS or JavaScript file - because the dependencies between CSS, JavaScript and HTML are not always clear. That also makes it hard to reuse a partial somewhere else.

You can solve this to some extent by using MVC areas, but those are used mainly to create sub-sites.

The solution is to co-locate all assets (CSS, JavaScript and images) that support some HTML with that HTML, in the same directory. Assets that support all pages in a controller can go in the view directory for that controller. And assets that are shared throughout the site can go into a top level directory.

This can lead to lots of small, focused CSS and JavaScript files. That's a good thing, but it makes creating your MVC bundles harder - your pages still have to load the right CSS and JavaScript in the right order. To help with this, Dynamic Bundles generates the bundles for you when the page loads. Caching keeps overhead to a minimum.

Key benefits

Dynamic Bundles is an extension of the Razor view engine and MVC bundles. It greatly improves maintainability and code reuse of ASP.NET MVC sites:

  • Co-locate the HTML, CSS, JavaScript and images that make up a page or component in the same directory, instead of organizing these files in separate directories by type. This clearly exposes dependencies.
  • Auto generate CSS and JavaScript bundles that contain the right files in the right order, based on their file organisation. No need to recompile when files are added or deleted. Caching keeps CPU usage and disk accesses minimal.
  • Provides the same minification and file combining as standard MVC bundles.

File Structure

Lets compare the file structure of a classic MVC site with one that uses Dynamic Bundles.

Classic MVC

  • HTML, CSS, JavaScript and image files organized in separate directories by type.
  • CSS and JavaScript that support different pages and components often put in the same physical files, creating hidden dependencies.
  • Long brittle urls from CSS files to background images.
  • Unclear what CSS, JavaScript and images are required for a given component, making reuse harder.
Image 1

Dynamic Bundles

  • HTML, CSS, JavaScript and image files that belong together sit in the same directory.
  • The view engine included in Dynamic Bundles lets you put partial views and layout files in their own sub directories.
  • Splitting CSS, JavaScript by component encourages developers to keep these files small and focussed.
  • Short simple image background image urls in your CSS.
  • Co-locating all assets that make up a component makes reuse much easier.
Image 2


Lets compare the way that bundles are created with a classic MVC site with one that uses Dynamic Bundles.

Classic MVC

  • You have to create and maintain bundles yourself.
  • You have to make sure to include the correct files, and in the right order.
  • When CSS and JavaScript files are added or deleted, the site needs to be recompiled.


public static void RegisterBundles(BundleCollection bundles)
    // Need to create bundles yourself, in code. To make any change,
    // you have to recompile. Must always make sure to include the
    // right files in the right order.

    bundles.Add(new ScriptBundle("~/bundles/jquery").Include(

    bundles.Add(new ScriptBundle("~/bundles/shared/js").Include(

    bundles.Add(new ScriptBundle("~/bundles/pile/js").Include(

    bundles.Add(new StyleBundle("~/Content/shared/css").Include(

    bundles.Add(new StyleBundle("~/Content/account/css").Include(



Dynamic Bundles

  • Bundles are auto generated. No need to create bundles yourself.
  • Ensures only required CSS and JavaScript files are loaded, and in the right order.
  • Optimizes client side caching, by combining files into bundles by area, controller, shared and layout.
  • When CSS and JavaScript files are added or deleted, new bundles are automatically generated without recompilation.


public class BundleConfig
    public static void RegisterBundles(BundleCollection bundles)
        // No need to register bundles in BundleConfig


@*Nominate where to load the bundles.
The bundles themselves are automatically generated.*@


  1. Install Dynamic Bundles
  2. Add view engine to global.asax
  3. Add layout container
  4. Update Web.config for views
  5. Co-locate assets
  6. Create explicit dependencies

1. Install Dynamic Bundles

Install the DynamicBundles package from NuGet:

Install-Package DynamicBundles

2. Add view engine to global.asax

Update your global.asax.cs or global.asax.vb, to add the DynamicBundles view engine:

public class MvcApplication : System.Web.HttpApplication
    protected void Application_Start()

        // Add DynamicBundles view engine. This functions the same as the Razor view engine,
        // but can find views sitting in their own directories, such as ~/Views/Home/Index/Index.cshtml
        // Note: this leaves the other view engines in place, so they can still be used.
        ViewEngines.Engines.Add(new DynamicBundles.DynamicBundlesViewEngine()); 


3. Add layout container

In classic MVC sites, pages sit within a _Layout.cshtml or _Layout.vbhtml file, which contains shared headers, footers, etc.

The problem when introducing Dynamic Bundles is that you want to separate CSS, JavaScript and pictures that are specific to the layout from those that are shared by the entire site.

To make this separation happen, create a new file _LayoutContainer.cshtml (you'll see the content in a moment). This and the _Layout.cshtml go into their own directory. The result looks like this:

Classic MVC

Image 3

Dynamic Bundles

Image 4

Contents of _LayoutContainer.cshtml

<!DOCTYPE html>
    @*Nominate where to load the bundles. The bundles themselves are automatically generated.*@



Changes to _Layout.cshtml

  1. Set Layout to _LayoutContainer.cshtml, which acts as the overall container of the site.
  2. Remove the doctype and html tags.
  3. Remove all style and script rendering, including rendering of script sections.
    // Add _LayoutContainer as the container for the _Layout.cshtml file itself.
    Layout = "../_LayoutContainer/_LayoutContainer.cshtml";

<!DOCTYPE html>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width" />
    <title>Dynamic Bundles for ASP.NET MVC</title>



    @RenderSection("scripts", required: false)

4. Update Web.config for views

In addition to the Web.config file in the root directory of your site, each MVC site also has a Web.config file in its Views directory. If your site uses areas, each area has a Views directory as well, with its own Web.config file.

The Web.config files in the Views directories need to be updated to:

  1. Install the Dynamic Bundles page base type. This gets each view to register the assets it needs, so bundles with the right files can be generated.
  2. Allow the web server to serve CSS, JavaScript and image files from the Views directory.
    <pages pageBaseType="System.Web.Mvc.WebViewPageDynamicBundles.WebViewPage">

    The BlockViewHandler blocks all requests. In classic MVC sites, it is used to block all requests for files from
    a Views directory. With Dynamic Bundles where CSS, JavaScript and images files are co-located with the view files,
    we only want to block requests for the view files.
      <remove name="BlockViewHandler"/> 
      <!-- Replace path="*.cshtml" with path="*.vbhtml" if you use Visual Basic. -->
      <add name="BlockViewHandler" path="*.cshtml" verb="*" preCondition="integratedMode" type="System.Web.HttpNotFoundHandler" />

5. Co-locate assets

Finally co-locate your asset files (CSS, JavaScript, images) with the views where they are used:

  • Move all assets that are shared throughout the site in the _LayoutContainer directory.

    Image 5

  • Move all assets that are shared by all views for a controller into that controller's directory.

    Image 6

  • If there are assets specific to a single view file, create a sub directory for that view file and put all assets (including the view itself) into that sub directory. Be sure to name the sub directory the same as the view file, without the extension.

    Image 7

  • Dynamic Bundles will add both the assets in the sub directory and those in its parent directory(s), less specific assets first. In the example below, when /Product/List is loaded, first the assets in ~/Views/Product and then those in ~/Views/Product/List are added.

    This works for both controller specific views and shared (partial) views. Dynamic Bundles makes sure that assets are only ever added once to a bundle.

    Image 8

6. Create explicit dependencies

You may have dependencies from one directory on another. For example, a JavaScript file assumes that a file in another directory has been loaded.

You can specify these dependencies with .nuspec files. These have the same structure as their NuGet counterparts (definition).

If Dynamic Bundles finds a nuspec file in a directory, it will find the directories specified in that nuspec file and add the assets in those directories to the bundles. If those directories have nuspec files themselves, Dynamic Bundles processes those nuspec files as well, etc. This is a fully recurrent process.

To create a dependency from a directory X to some other directories, include a .nuspec file in directory X that looks like this:

<?xml version="1.0"?>
<package >
        <dependency id="../AccountDetailsAssets" />
        <dependency id="~/Views/Shared/DetailsAssets" />

Note that:

  • The name of the .nuspec file doesn't matter, as long as it has the extension .nuspec.
  • You can specify root relative paths (starting with ~/) and paths relative to the .nuspec file, but not absolute paths (such as C:\Dev\Views\Accounts).


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Matt Perdeck
Australia Australia
Twitter: @MattPerdeck
Current project: JSNLog JavaScript Logging Package

Matt has over 9 years .NET and SQL Server development experience. Before getting into .Net, he worked on a number of systems, ranging from the largest ATM network in The Netherlands to embedded software in advanced Wide Area Networks and the largest ticketing web site in Australia. He has lived and worked in Australia, The Netherlands, Slovakia and Thailand.

He is the author of the book ASP.NET Performance Secrets ( in which he shows in clear and practical terms how to quickly find the biggest bottlenecks holding back the performance of your web site, and how to then remove those bottlenecks. The book deals with all environments affecting a web site - the web server, the database server and the browser.

Matt currently lives in Sydney, Australia. He recently worked at Readify and the global professional services company PwC. He now works at SP Health, a global provider of weight loss web sites such at CSIRO's and

Comments and Discussions

GeneralGood explanation Pin
idreeskhan3-Sep-15 1:56
Memberidreeskhan3-Sep-15 1:56 
QuestionWhen some javascript/ccs file is used in few views Pin
slbtuga7-Apr-15 0:46
Memberslbtuga7-Apr-15 0:46 
GeneralGreat article! Pin
Nguyen Khanh Hung20-Jan-15 23:27
MemberNguyen Khanh Hung20-Jan-15 23:27 
QuestionAlternate approach Pin
Deverop2-Jan-15 4:27
MemberDeverop2-Jan-15 4:27 
GeneralGood for multi-tenant site Pin
Robert J. Good17-Nov-14 10:57
professionalRobert J. Good17-Nov-14 10:57 
GeneralMy vote of 5 Pin
Assil17-Nov-14 2:09
professionalAssil17-Nov-14 2:09 
QuestionCo-existing asset files??? Pin
Venkatesh Mookkan16-Nov-14 12:02
MemberVenkatesh Mookkan16-Nov-14 12:02 
AnswerRe: Co-existing asset files??? Pin
Matt Perdeck16-Nov-14 13:08
MemberMatt Perdeck16-Nov-14 13:08 
GeneralMy vote of 5 Pin
Halil ibrahim Kalkan16-Nov-14 4:43
MemberHalil ibrahim Kalkan16-Nov-14 4:43 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.