Netiqo Framework

.NET micro-framework for building lightweight, self-hosted web servers with support for routing, HTTPS, and static files

Download Now Documentation

Main Features

Everything you need to create professional embedded and local web servers

🚀

Self-Hosted Lightweight

Create embedded or local web servers accessible via Wi-Fi or LAN without complex configurations.

🛣️

Advanced Routing

Full support for GET/POST routing with logging from code, JSON, XML or attributes.

🔐

HTTPS Integrated

Native support for SSL/TLS certificates with automatic configuration via SslStream.

📁

Static Files

Automatic service of static files from the wwwroot/ folder for CSS, JS, images, and more.

⚙️

Configurable Host

Flexible setup with customizable IP, port, certificates and logging for every need.

🎯

Dynamic HTML

Static or dynamic HTML responses with custom handlers and form parsing.

Setup and Instant Startup

With Netiqo Framework you can create a self-hosted web server in very few lines of code. The host automatically configures itself and handles routing, HTTPS and static files.

Perfect for embedded applications, local microservices, and development servers accessible from across the Wi-Fi network.

Program.cs
using Netiqo.Framework;

// Host creation
var host = new Host("127.0.0.1", 8080);

// Optional Logging
host.LogMessage += Console.WriteLine;

// Manual route registration
host.RegisterRoute(new Route("/", HttpMethod.GET, 
    htmlResponse: "<h1>Homepage</h1>"));

// Loading route from JSON
host.LoadRoutesFromJson("routes.json");

// Route via attributes
host.RegisterRoutesFromAttributes(new MyController());

// Starting the server
await host.StartAsync();

How to Get Started

Follow these simple steps to get your Netiqo server up & running

1

Install Netiqo

Add Netiqo.Framework to your .NET 9.0+ project via NuGet or direct reference

2

Create Host

Configures host with IP, port and optionally HTTPS certificates for secure connections

3

Register Routes

Define routes via code, JSON, XML or attributes on controllers for maximum flexibility

4

Start the Server

Launch the self-hosted server and access it from any device on your local network

Full Documentation

Routing and Advanced Configuration

Learn about the different ways to configure routes and manage HTTPS

routes.json & Controller
// routes.json
[
  {
    "Path": "/about",
    "Method": "GET",
    "HtmlResponse": "<h1>About Us</h1>"
  }
]

// Controller with attributes
public class MyController 
{
    [Route("/login", HttpMethod.POST)]
    public string HandleLogin(string body)
    {
        var parsed = HttpUtility.ParseQueryString(body);
        return $"<h1>Welcome, {parsed["username"]}</h1>";
    }
}

// HTTPS with certificates
var host = new Host("127.0.0.1", 443, 
    "C:\\certs\\netiqo.pfx", "password");

Maximum Flexibility

Netiqo Framework supports several approaches to defining routes: from JSON/XML files for external configurations to attributes on methods for a more traditional approach.

Native HTTPS support with PFX certificates enables automatic secure connections via SslStream, ideal for production-ready applications.