Skip to content
matt-goldmanPublic

Repository files navigation

blake logo

Blake

🍞 Bake your Blazor into beautiful static sites

The static site generator for .NET developers who want familiar tools, not foreign languages.

Blake.Types Blake.MarkdownParser Blake.BuildTools Blake.CLI
NuGet Version NuGet Version NuGet Version NuGet Version

GitHub Workflow Status

📚 Read the docs • 🚀 Quick Start • 🌟 See it in action


🌟 See it in action

Live examples built with Blake:

🌐 Blake Documentation - The official Blake docs site
Modern documentation with clean design and full-text search

🎨 Tailwind Sample Blog - A beautiful blog template
Responsive blog with Tailwind CSS styling and modern typography


🚀 Quick start

Get up and running in seconds:

1️⃣ Install Blake globally

dotnet tool install -g blake

2️⃣ Create a new site

# Create from template
blake new --template tailwind-sample

# Create without a template (uses the default Blazor WASM template)
blake new

# Or init an existing Blazor WASM site
blake init

3️⃣ Start building

blake bake && dotnet run
# or
blake serve  # does both bake and serve

That's it! ✨ Your static site is ready at your configured port

🔧 Advanced usage

Add Blake to existing Blazor app:

blake init

Generate content only:

blake bake

List all templates:

blake new --list

Generate a new content scaffold:

blake new content -t "Adding new templates to Blake"
blake new content "Positional title works too"
blake new content --directory Posts/Tech "Nested post"
blake new content # creates "Untitled" content in current directory

✨ Why Blake?

Tired of learning new templating languages just to blog? Blake brings static site generation to your comfort zone.

🎯 Built for .NET developers

  • No foreign syntax - Use Razor templates you already know
  • No config chaos - Folder structure determines everything
  • No build mysteries - Just Blazor, just bake, just works

🧠 Guided by Occam's Razor

The solution with the fewest assumptions is often the best.

Other generators: "Put layouts here, templates there, config everywhere, sprinkle fairy dust, pray it builds."

Blake: "Put content wherever makes sense. Add a template.razor. Done."

⚡ Key features

✅ Convention over configuration - Smart defaults, zero setup
✅ Familiar tooling - Razor, Markdown, Blazor components
✅ Plugin system - Extend functionality without complexity
✅ Live templates - Community-driven starter templates
✅ Modern workflow - Integrates with existing .NET tools

🤔 Blake vs. Others

Love Hugo, Jekyll, or Gatsby? They're fantastic! But they make too many assumptions:

  • 😭 Hugo: Assumes you're happy to learn Go templating + TOML/YAML config
  • 😭 Jekyll: Assumes you're cool with Liquid templating + Ruby ecosystem
  • 😭 Gatsby: Assumes you want a static site with GraphQL + React + complex build chains
  • 🤩 Blake: Assumes you have the .NET CLI installed

Blake doesn't try to be everything to everyone. It tries to be exactly what feels intuitive to .NET developers who just want to write and publish.


📖 Documentation

Complete documentation →


Ready to bake? 🍞✨

Get Started → • View Templates → • Join Community →

Releases

Packages

Contributors

Languages