Welcome — and how to use this site as your template

A starter post that demonstrates every front-matter field your articles can use. Duplicate this file, swap the content, and you're publishing.

This is a starter post. Delete it once you publish your first real article.

Why this file exists

Three reasons:

  1. It lets npm run build succeed before you’ve written anything real.
  2. It shows you every supported front-matter field in one place.
  3. It demonstrates how the sources and faq blocks render — both visually and in the page’s JSON-LD.

Front-matter fields

FieldRequiredWhat it does
titlePage <title>, h1, OG title
descriptionMeta description, OG description, RSS summary
pubDatePublished date (ISO format)
updatedDateOptional. Shown as “Updated …” and sent to schema.org dateModified
categoryOne of: home, bedroom, office, bagua, elements, basics
tagsFree-form array. Renders as chips + article:tag meta
authorDefaults to “Feng Shui Lab Editorial”
draftSet true to hide from build
sourcesArray of references. Renders as a sidebar + schema.org citation
faqArray of { q, a }. Renders as accordion + FAQPage JSON-LD

How to write a real article

Copy this file to a new name (e.g. bedroom-feng-shui-101.md), then:

  • Pick a category that fits.
  • Fill description with one sentence — it’s used in three places.
  • List 2–4 sources with a short note on why each one is authoritative.
  • Add 3–5 faq items targeting the exact questions people ask Google or ChatGPT about your topic. This is the single highest-leverage GEO move you can make per post.

The accordion below shows the FAQ items as they would appear to a reader. The same data is emitted to <script type="application/ld+json"> in the page head, where AI crawlers pick it up.

Frequently asked

Can I add new categories?

Yes — edit src/consts.ts and src/content.config.ts to add a new key. Both files share the same enum, so keep them in sync.

What does the sources field do?

Each source becomes a schema.org Citation on the article's JSON-LD. AI search engines use these citations to decide whether to surface your post.

What does the faq field do?

Each Q/A pair gets rendered as an accordion at the bottom of the post and also as a FAQPage JSON-LD block in the page head — both Google rich results and AI Overviews can pick it up.