Menu
CoddyTech

A Static HTML Page

Part of the Minimal APIs section of Coddy's ASP.NET Core journey. Lesson 12 of 20.

A web app often sends files that never change: HTML pages, CSS, images. ASP.NET Core serves them from the wwwroot folder of the project once the static files middleware is added. Middleware is code every request passes through on its way to the endpoints; the next chapter writes some.

var app = builder.Build();
app.UseStaticFiles();

With wwwroot/about.html and wwwroot/css/site.css in the project, GET /about.html and GET /css/site.css answer those files, with a Content-Type that matches the extension: text/html, text/css. The address is the path inside wwwroot, without wwwroot itself. A request for a file that does not exist goes on to the endpoints, so GET / still reaches MapGet("/").

challenge icon

Challenge

Easy

The API gets a home page. wwwroot/index.html is new in your project.

  1. In Program.cs, on the line after var app = builder.Build();, add app.UseStaticFiles();.
  2. In wwwroot/index.html, below the first paragraph, add <p><a href="/api/recipes">All recipes</a></p>.

Try it: press Run. The first request is GET /index.html: status 200, Content-Type: text/html, and the page shows with its heading Recipe Box. The Source tab shows its HTML. Click All recipes to send GET /api/recipes. Send GET /: still Recipe API is running.

Try it yourself

using Microsoft.AspNetCore.Http.HttpResults;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

var recipes = new List<Recipe>
{
    new(1, "Tomato Soup", "soup", 25),
    new(2, "Pancakes", "breakfast", 15),
    new(3, "Lentil Soup", "soup", 40),
};
var nextId = 4;
var favoriteIds = new List<int>();

app.MapGet("/", () => "Recipe API is running");
app.MapGet("/api/recipes", (string? category) =>
    recipes.Where(r => category is null || r.Category == category));
app.MapGet("/api/recipes/{id:int}", (int id) =>
{
    var recipe = recipes.FirstOrDefault(r => r.Id == id);
    if (recipe is null)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    return Results.Ok(recipe);
});

app.MapPost("/api/recipes", (NewRecipe input) =>
{
    if (string.IsNullOrWhiteSpace(input.Name))
        return Results.BadRequest(new { error = "Name is required" });
    if (input.Minutes <= 0)
        return Results.BadRequest(new { error = "Minutes must be more than 0" });
    var recipe = new Recipe(nextId++, input.Name, input.Category, input.Minutes);
    recipes.Add(recipe);
    return Results.Created($"/api/recipes/{recipe.Id}", recipe);
});

app.MapPut("/api/recipes/{id:int}", (int id, NewRecipe input) =>
{
    var index = recipes.FindIndex(r => r.Id == id);
    if (index == -1)
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    var recipe = new Recipe(id, input.Name, input.Category, input.Minutes);
    recipes[index] = recipe;
    return Results.Ok(recipe);
});

app.MapDelete("/api/recipes/{id:int}", Results<NoContent, NotFound> (int id) =>
{
    var removed = recipes.RemoveAll(r => r.Id == id);
    return removed > 0 ? TypedResults.NoContent() : TypedResults.NotFound();
});

var favorites = app.MapGroup("/api/favorites");
favorites.MapGet("/", () => recipes.Where(r => favoriteIds.Contains(r.Id)));
favorites.MapPost("/{id:int}", (int id) =>
{
    if (!recipes.Any(r => r.Id == id))
        return Results.NotFound(new { error = $"Recipe {id} not found" });
    if (!favoriteIds.Contains(id))
        favoriteIds.Add(id);
    return Results.NoContent();
});
favorites.MapDelete("/{id:int}", (int id) =>
{
    favoriteIds.Remove(id);
    return Results.NoContent();
});

app.Run();

All lessons in Minimal APIs