Home

Imp developer guide

Imp (“In Memory Pages”) is a lightweight ASP.NET Core page framework. It maps request paths to .NET classes, creates page objects through dependency injection, binds query-string values to page properties, and renders either direct responses or XML-based templates embedded in the application assembly.

Embedded templates are compiled once and cached in memory. Imp is useful when you want class-based routing and a deliberately small rendering model without adopting MVC, Razor Pages, or a client-side framework.

Start here

1. Getting started — install Imp and render a page.
2. Architecture and request lifecycle — understand where Imp belongs in ASP.NET Core.
3. Routing and page classes — map URLs and query strings to C#.
4. Embedded templates and layouts — keep markup in cached assembly resources.
5. Run the Todo sample for a complete application.

Build with Imp

Goal	Guide
Write HTML directly from a class	Pages and direct rendering
Compose layouts and page templates	Embedded templates and layouts
Insert runtime values and repeat items	Dynamic content, constants, and loops
Process forms safely	Forms, postbacks, and antiforgery
Inject application services	Dependency injection and lifetimes
Protect selected pages	Authentication and secure pages
Route database-backed permalinks	Routing and page classes
Rewrite static asset URLs	Static assets and CDN paths
Diagnose rendering failures	Troubleshooting

Packages and source

• KitchenPC.Imp supports the actively maintained .NET 8 and .NET 10 LTS releases.
• The maintained Imp repository contains the library, unit tests, and sample application.
• The Todo sample targets .NET 10 and uses a direct project reference.
• Imp is available under the MIT License.

Reference

• Configuration reference
• API quick reference
• Testing and diagnostics
• Build, package, and contribute
• Upgrade to Imp 0.2