Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Tinyweb is a lightweight web framework for ASP.NET that embraces HTTP and aims to be ridiculously simple.
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib Removed support for NHaml and NDjango and removed samples from project
tools Removed two unused wiki images


Tinyweb is a lightweight web framework for ASP.NET that embraces HTTP and aims to be ridiculously simple.

No Abstractions Please

Tinyweb moves away from the MVC pattern for developing web applications. Instead, you start with separate addressable resources that respond directly to the HTTP method that was used to access the resource. Every resource is a class and every implemented HTTP method (get, post, put, delete) is a method on the class.

With Tinyweb, you're writing code that is conceptually close to the way HTTP actually works.


Getting started is as simple as creating a resource (a class with a method) and calling Tinyweb.Init() from Application_Start. That's it. You don't even have to specify the resource URL (unless you want to), Tinyweb will infer it from the class name. View engines (Spark & Razor), model binding and all that goodness are supported too.


Create a handler:

public class HelloWorldHandler
    public IResult Get()
        return View.Spark("Hello.spark");

You now have a resource that supports HTTP GET at the location /hello/world and returns a rendered Spark template. Let's tell Tinyweb to load itself and our work here is done.

public class Global : HttpApplication
    protected void Application_Start(object sender, EventArgs e)

It's Still ASP.NET

Tinyweb is just another web framework, but underneath it's still the same ASP.NET you've been using for years. You still have access to Request, Response, Session, Cache and all of that other stuff that makes you squeal in delight.


Details of all features of the framework and how to use them can be found in the docs.


Links to blogs and other resources about Tinyweb:

Introducing Tinyweb

Tinyweb on Mac OS X & Mono

ASP.NET - Thinking In Resources

Tinyweb Series: 1 Getting Started

Tinyweb Series: 2 Building APIs

Tinyweb Series: 3 Dependency Injection & Filters

Tinyweb Series: 4 Views & Model Binding

Tinyweb Series: 5 To-do Demo

Micro Web Frameworks in .NET 101: Tinyweb

Tinyweb and HttpListener


The following full applications have been built with Tinyweb:

Tweet Conversations

Sentiment Analysis Demo


The easiest way to get started with Tinyweb is to NuGet it:

Install-Package Tinyweb


2.2.6 Bug fix for accept header parsing when the system culture is different

2.2.5 Bug fixes for Spark and view caching courtesy of Matt Burton

2.2.4 Area support for a less duplicative way of defining multiple handlers using the handler namespace (thanks Matt Burton) and bootstrap performance enhancements

2.2.3 Made all result types testable by making their input public, allowing test inspection before rendering

2.2.2 Fixed model binder to support binding to nullable types

2.2.1 Spark now has caching, making both Spark and Razor lightning fast when rendering views. Also fixed bug where some global filters were being created twice

2.2.0 Tinyweb now supports the Razor view engine thanks to Ben Dornis

2.1.5 Fix for Url.For helper to include the virtual application path

2.1.4 Fixed bug with Result.JsonOrXml when no accept header is specified - it now defaults to JSON

2.1.3 Fixed lazy loading bug that caused init to load handlers twice during scanning

2.1.2 Added Ignore attribute for excluding specific properties of a class from model binding

2.1.1 Fixed bug caused by Result.Redirect allowing ThreadAbort exceptions to flow through to the Tinyweb.OnError delegate for every redirect

2.1.0 Added support for an error handler for managing errors thrown during handler/filter execution and added access to HandlerData to model binding

2.0.1 Fixed bug that prevented handlers accessing session state from the RequestContext

2.0.0 Support for global and handler filters for before/after processing and changed public API by renaming IHandlerResult to IResult, forcing semver v2.0.0

1.0.2 When Tinyweb.AllowFormatExtensions is set, Result.JsonOrXml allows the use of a URL override for specifying the requested content type (i.e. /resource.json)

1.0.1 Update for binding of array types, lower casing of routes and internal Spark integration refactoring

1.0.0 Release of stable public API and switch to semantic versioning


Many thanks to the following people who have contributed to Tinyweb:

Something went wrong with that request. Please try again.