Contributing to the Blog

Want to write for the Solidiom blog? This guide walks you through adding yourself as an author and publishing your first post.

1. Add yourself as an author

Add an entry to <code>apps/site/src/data/authors.json</code>. Each entry follows this format:

{
  "id": "your-github-username",
  "name": "Your Full Name",
  "description": "Short bio (e.g. "Solidiom core contributor")",
  "avatar": "https://github.com/your-github-username.png",
  "github": "your-github-username",
  "linkedin": "your-linkedin-username",
  "website": "https://your-website.com"
}

Note: <code>id</code> must be unique and is used to reference you in articles. <code>linkedin</code> and <code>website</code> are optional.

2. Create your post

All posts are written in Markdown. Add your file to <code>apps/site/src/content/en/articles/</code> (or <code>es/articles/</code> for Spanish).

File name

Use <code>YYYY-MM-DD-post-title.md</code> as the file name.

Post frontmatter

The YAML frontmatter at the top of your file sets the date, authors, and metadata:

---
contentSchemaVersion: 1
title: "Your Post Title"
description: "A short description shown in the blog listing."
keywords: [solidiom, web, component]
locale: en
maturity: draft
date: "2026-08-10"
authors:
  - your-github-username
tags: [solidiom, architecture]
---

Your article content here...

Note: The <code>authors</code> values must match an <code>id</code> entry in <code>authors.json</code>.

3. Post body

The formatting of the article body is up to you. We recommend adding a page break after the opening paragraph to create a synopsis on the blog listing page.

Opening paragraph of your post...

<!-- more -->

Rest of the article content...

4. Available frontmatter fields

Field	Type	Description
`contentSchemaVersion`	`1`	Content schema version.
`title`	`string`	Article title.
`description`	`string`	Short description shown in the blog listing.
`keywords`	`string[]`	Terms for search and SEO.
`locale`	`"en" \| "es"`	Article locale.
`date`	`Date`	Publication date in ISO format.
`authors`	`string[]`	Author IDs from authors.json.
`tags`	`string[]`	Tags displayed on the article.
`maturity`	`"draft" \| "beta" \| "ga"`	Content maturity level.

5. Preview and submit

From the <code>apps/site/</code> directory, run <code>pnpm dev</code> to preview your post at <code>http://localhost:4321/blog/your-title/</code>.

Once you're happy, open a Pull Request with your changes. The team will review your post before it goes live.