Lyra 0.0.1

🌟 Lyra - Lightweight, AOT-Ready Web API Framework for .NET

Lyra is a minimal, fast, and AOT-friendly web API framework for C#. Inspired by Express.js, it’s designed for microservices, internal tools, and self-hosted apps that need performance without the bloat.

✅ Express-like routing and middleware — in pure C#
✅ Self-hosted with HttpListener — no Kestrel or ASP.NET
✅ AOT-friendly JSON binding — works with source generators
✅ Lightweight and composable — just one DLL and you're ready

🚀 Why Lyra?

🚀 Get Started Instantly

You don’t need a package. Just clone the repo and run a sample:

git clone https://github.com/syanmi/Lyra.git
cd Lyra/sandbox/LyraSampleApp/
start /b dotnet run
curl http://localhost:8080/hello

Or create a simple app like this:

var app = new LyraApp();

app.Get("/hello", ctx => LyraResult.Text("Hello from Lyra!"));

await app.RunAsync();

• No NuGet installation needed
• No build templates or scaffolding tools
• Just C# and .NET — ready to go

🧬 AOT-Ready JSON Binding

app.UseJsonContext(MyJsonContext.Default);

[JsonSerializable(typeof(MyRequest))]
public partial class MyJsonContext : JsonSerializerContext {}

• Uses System.Text.Json source generators
• Reflection-free & trimming-friendly
• Ideal for native AOT builds

🧱 Middleware and SubApps

var sub = new LyraApp();
sub.Get("/hi", ctx => LyraResult.Text("Hello from SubApp!"));

app.Use(async (ctx, next) =>
{
    Console.WriteLine("Before SubApp");
    await next();
});

app.Map("/sub", sub);

• Compose multiple apps like Express's app.use('/path', sub)
• Build modular and reusable APIs

📂 Static File Serving (🚧coming soon)

app.UseStaticFiles("wwwroot");

• Serve static files for admin tools or dashboards

📦 Current Features

📌 Roadmap

CLI tools (dotnet new lyra) and NuGet packaging are planned for v1.0

📄 License

MIT License.
Contributions welcome!

⭐ Like Lyra?

If Lyra helps you build faster and smaller .NET apps, a ⭐ would mean a lot!

✅ Summary

Lyra is for developers who want:

• Fast startup and small output size
• Native AOT-ready web APIs
• Express-like simplicity in C#
• No heavy dependencies or runtime costs

🔗 Related

• Express.js
• ASP.NET Minimal APIs
• System.Text.Json Source Generators