💡 Quick Start

Default listening port is 8090. On Windows, if binding fails, grant the application administrator privileges; if localhost-only access is enough, switch to StartServer("127.0.0.1") (1.7.7+) to avoid the elevation requirement. It is recommended to use the latest version of PicoServer to ensure full functionality.

1. Install PicoServer

Search for PicoServer in Visual Studio's NuGet Package Manager and install it, or run the following in your project directory:

dotnet add package PicoServer

2. Minimal WebAPI

Just three lines of core code to start a lightweight Web service in any .NET application.

C#

using System;
using System.Threading.Tasks;
using System.Net;
using PicoServer;

class Program
{
    private static readonly WebAPIServer MyAPI = new WebAPIServer();

    static void Main()
    {
        MyAPI.AddRoute("/", Hello);
        MyAPI.StartServer();

        Console.WriteLine("Server started: http://127.0.0.1:8090");
        Console.ReadKey();

        MyAPI.StopServer();
    }

    private static async Task Hello(HttpListenerRequest request, HttpListenerResponse response)
    {
        await response.WriteAsync("Hello PicoServer");
    }
}

VB.NET

Imports System
Imports System.Threading.Tasks
Imports System.Net
Imports PicoServer

Module Program
    Private ReadOnly MyAPI As New WebAPIServer()

    Sub Main()
        MyAPI.AddRoute("/", AddressOf Hello)
        MyAPI.StartServer()

        Console.WriteLine("Server started: http://127.0.0.1:8090")
        Console.ReadKey()

        MyAPI.StopServer()
    End Sub

    Private Async Function Hello(request As HttpListenerRequest, response As HttpListenerResponse) As Task
        Await response.WriteAsync("Hello PicoServer")
    End Function
End Module

3. Verify It Works

After building and running the program, access it in your browser or via curl:

curl http://127.0.0.1:8090

A response of Hello PicoServer means the installation was successful.

📚 Documentation Navigation

• Basic Features — Routing, Parameters, Response, Static Files, CORS, Cookie
• Data & Files — File Upload/Download, Streaming
• Real-time Communication — SSE, Long Connection, WebSocket
• Security & Auth — Token, JWT, Blacklist, Encryption
• Advanced Customization — Custom Middleware, Dynamic Routing
• Extensions — Attribute Routing, AOT Compatibility