Combres helps your ASP.NET and ASP.NET MVC applications perform faster and rank better with YSlow and PageSpeed.
Platforms:
- ASP.NET 3.5-4.5
- ASP.NET MVC 2-5
Features:
- One stop shop for JS/CSS combination, minification, compression and caching (with Expires/Cache-Control, ETag and server-side caching).
- Easy to use, simply download it via NuGet, declare JS and CSS resource groups in an XML file and use them in your pages, Combres will take care of the rest.
- Detect changes in Combres config file, managed JS/CSS files and support auto-versioning, so you don't have to manually rebundle JS/CSS resources after making changes to them
- Extensible architecture with many extension points.
- And many more: CDN, HTTPS, debug mode, external JS/CSS (dynamically requested from other servers), Less CSS etc.
- Proven solution with many thousands of downloads in NuGet, CodePlex and The Code Project
Check out this Code Project article for a thorough introduction.
Install from NuGet
PM> Install-Package combres
PM> Install-Package combres.log4net (optional)
PM> Install-Package combres.mvc (optional)
Optional steps for ASP.NET 3.5 users, those using ASP.NET 4 or above can safely ignore:
- Delete the generated file
AppStart_Combres.cs
- Open
global.asax
code-behind file:- Import
Combres
namespace - Add this line to the first line of either
RegisterRoutes()
orApplication_Start()
:RouteTable.Routes.AddCombresRoute("Combres")
- Import
Edit App_Data/Combres.xml
to declare your JS and CSS resources
Use resource groups in your pages as follows:
<%= WebExtensions.CombresLink("siteCss") %>
<%= WebExtensions.CombresLink("siteJs") %>
ASP.NET MVC developers can import Combres.Mvc
namespace and declare CSS/JS like below:
@using Combres.Mvc;
...
@Url.CombresLink("siteCss")
@Url.CombresLink("siteJs")
That should be it. Start your browser to observe Combres in action. For more advanced usages, refer to these resources:
2.3.0.4
- Built with dotless 1.4.1.0, YUICompressor.NET 2.7.0.0 and AjaxMin 5.14.5506.26202
- Remove strong name to build with latest version of YUICompressor
2.2.2.18
- Only support .NET 4.0 or above. .NET 3.5 users should use Combres 2.2.2.17.
- Use Fasterflect 2.1.3
2.2.2.17
- Reverse to Fasterflect 2.1.0 to fix #6
2.2.2.15
- Fix issues 7675, 7656, 7673, 7660, 7654
- Built with dotLess 1.3.1.0, Fasterflect 2.1.2, AjaxMin 4.48.4489.28432 and Log4Net 1.2
- Move Log4Net logger implementation to separate Combres.Log4Net package
NuGet Combres.Log4Net
- Add this attribute the combres element:
logProvider="Combres.Log4Net.Log4NetLogger, Combres.Log4Net"
2.2.2.6
- Built with latest versions of Log4Net, YUI Compressor and MS Ajax Minifier
- Add MSAjaxCssMinifier to minify CSS resources
- Add line break to JS resources when combining
2.2.2.2
- Add support for sslHost
- Fixed missing content-type issue
2.2.2.0
- Support host prefix
2.2.1.8
2.2.1.5
- Support AS.NET MVC 3 and Razor
- Fix 7647
- Add
EnableClientUrls()
toWebExtensions
andMvcExensions
for generating JS variables providing access to Combres resource sets MvcExtensions
returnsMvcHtmlString
instead ofstring
2.1
- Enable Dot Less for combined contents (instead of individual files) via
DotLessCssCombineFilter
- Support Azure
- Enable custom server-side caching via
<combres cacheProvider="my.custom.cache" .../>
- Support local closure compilation via
LocalClosureJSMinifier
- Support cache-vary extensibility to allow developers to control Combres caching behavior
- Fix issue 6547
2.0
- Implement 6103, 5633, 5572, 6088, 6056, 5605, 5941, 78751, 4349
- Support per-resource minification scheme
- Fix bug in etag handling which may cause client to receive expired content
- Add overload of
CombresLink()
which acceptshtmlAttributes
object - Combres now maintains the order of resources in multiple-minifiers resource sets
1.2
- Change detection and auto-versioning
- Fix bug when auto-versioning generates different version across application processes
- Fix 69854, 5489
- Add filters:
DotLessCssFilter
,HandleCssVariablesFilter
- Fix
ChangeMonitor#IsSamePath()
as per this discussion thread - Update
SimpleOjectBinder
to allow case-insensitive binding - Add
forwardCookie
attribute to<resource>
element whose mode isDynamic
. - Handle both gzip & deflate for remote resources
1.1
- Support YUI, MS Ajax and Google Closure minifiers
- Support turn-off minification
- Fix 5460
- Use default minifier if minifierRef, jsMinifierRef, cssMinifierRef is not specified
- Support
auto
mode fordebugEnabled
(to usedebug
setting fromweb.config
)