Projects Showcase

Wed, 25 Dec 2024 00:00:00 +0000

Mono includes a projects showcase that displays work in an organized, card-based layout. Unlike blog posts, projects are defined in a single data file for easy management.

Setting Up Projects

Create data/projects.toml to define projects. The file organizes projects into sections (categories) containing items (individual projects):

toml
[[section]]
 name = "Open Source"
 description = "Projects I maintain and contribute to"

 [[section.items]]
 title = "My App"
 description = "A useful application"
 url = "https://github.com/username/my-app"
 icon = "/images/projects/my-app.svg"

 [[section.items]]
 title = "CLI Tool"
 description = "A command-line utility"
 url = "https://github.com/username/cli-tool"
 symbol = "CLI"

[[section]]
 name = "Client Work"
 description = "Selected professional projects"

 [[section.items]]
 title = "Portfolio Site"
 description = "Personal website built with Hugo"
 url = "https://example.com"
 symbol = "WEB"

Each section has a name (required) and optional description. Each item requires title, description, and url. For the visual identifier, provide either an icon (path to an image, ideally SVG) or a symbol (2-3 character text fallback). If neither is specified, “PRJ” is used as the default.

Projects on Mono

Projects Showcase

Setting Up Projects