Skip to content
This repository

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

branch: master
readme.md

Tinyweb

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.

Simplicity

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.

Example

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)
    {
        Tinyweb.Init();
    }
}

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.

Documentation

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

Resources

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

Applications

The following full applications have been built with Tinyweb:

Tweet Conversations

Sentiment Analysis Demo

NuGet

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

Install-Package Tinyweb

Versions

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

Contributors

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

Something went wrong with that request. Please try again.