Project tutorial
Build a Blazor Blog
Build Ironwharf Gazette with Blazor SSR, Bootstrap 5, hand-wired cookie auth, EF Core, owned post CRUD, search, password recovery, and Azure/Kestrel deployment.
How this project works
Ironwharf Gazette is an original teaching blog in twelve complete snapshots. Clone once and run any numbered folder without rebuilding earlier stages.
The path starts with minimal ASP.NET hosting, adds Blazor components and Bootstrap, then introduces isolated Postgres databases. Later parts add cookie auth, media, ownership, pagination, search, reset tokens, and Azure deploy notes.
Snapshots 4–12 seed [email protected] and [email protected] with password123.
Local Postgres runs through Docker Compose on host port 5445 with databases ironwharf_01–ironwharf_12.
Start with part 1 Open GitHub repo
Parts in order
Work through the parts in sequence. Each lesson explains the ideas in plain language, then points you to a complete runnable snapshot on GitHub for that stage.
- Part 1: Getting StartedCreate a minimal ASP.NET app on port 5081.
- Part 2: RoutingOrganize Blazor component routes with MapRazorComponents.
- Part 3: Layout and UIRender Blazor layouts with Bootstrap 5 CDN.
- Part 4: Data LayerPersist authors and posts with EF Core and PostgreSQL.
- Part 5: Feed and DetailBuild a database-backed feed and post detail components.
- Part 6: RegistrationValidate accounts and store BCrypt password hashes.
- Part 7: Login and SessionsAuthenticate with hand-wired cookie auth.
- Part 8: Profiles and MediaShow author profiles and accept constrained avatar uploads.
- Part 9: Posts CRUD and OwnershipCreate, edit, and delete posts with owner authorization.
- Part 10: Pagination and SearchPaginate the feed and search post text.
- Part 11: Password ResetIssue expiring one-use password reset tokens.
- Part 12: DeployPrepare Ironwharf Gazette for Azure Container Apps and Kestrel.