Projects

Projects is a portfolio section for your blog: a place to show the work you want people to see, with a link to what you built and a link to what you wrote about it. It works across all themes.

What it is

A Projects block on your homepage and a dedicated /projects page. Each project is a card with a name, an optional logo, a short description, tags, and up to two links: one to a blog post and one to the project itself.

Adding projects

Projects live in Settings > Sections. The Projects manager sits at the top of that tab, above your other sections.

Add a project and fill in the fields you want:

  • Name - required. Shown on the card.
  • Description - a short line about the project.
  • Logo - an optional image for the card.
  • Tags - used for filtering on the projects page.
  • Blog post link - link to a post you wrote. You can pick one of your posts or point anywhere.
  • Project URL - link to the live project, repo, or site.

Reorder projects by dragging them; the order carries through to your blog.

The projects page

Also in the Projects manager, set the title and description for your /projects page. The title defaults to something sensible; use it to name the page ("Selected work", "Things I've built") and add a line of context.

How it renders

  • Home page - a Projects block appears with a "see all" link when you have more projects than fit.
  • /projects page - the full list, with tag filtering and pagination so a long portfolio stays browsable.

Click behavior

What happens when a visitor clicks a project depends on its links:

  • Both links set - a modal opens with "Read blog" and "View project" so the visitor chooses.
  • One link set - the card goes straight to that link, no modal.
  • No links - the card is static, not clickable.

From the CLI

Everything here is scriptable. See Portfolio (CLI) to create, edit, reorder, and set the page title from the terminal.