Skip to content

Guides2 min read

Hello world

What TutoReviews is for, and how posts are organised.

Abdelkouddouss MekkaouiFull Stack Developer

Welcome to TutoReviews. This is a placeholder post — replace or delete it once you publish something real. It exists so the site builds, the category and tag routes have something to generate, and the search index isn’t empty.

How posts are organised

Every post has exactly one category, drawn from the list in src/data/categories.ts. Categories are broad topics and show up as the nav tabs on the home page. The category field is validated against that list at build time, so a typo fails the build rather than shipping a dead link.

Tags are freeform and describe whatever else is worth grouping on — a technology, a product, a format. A post can have as many as it needs.

Adding a post

Drop a .md or .mdx file into src/content/blog/. The filename becomes the URL, so hello-world.mdx is served at /post/hello-world/.

The frontmatter above shows every field. title, description, pubDate, heroImage and category are required; tags and draft are optional.

Set draft: true to keep a post out of the site while you work on it. Drafts are excluded from the home page, category and tag pages, related posts, the sitemap and the RSS feed.

Code blocks

Fenced code is highlighted at build time with no client-side JavaScript, and ships both a light and a dark theme:

ts
export function greet(name: string): string {
	return `Hello, ${name}`
}

What to change next

  • src/data/site.config.ts — the site URL, author and description
  • src/data/categories.ts — your own categories
  • src/data/links.ts — your social links
  • public/favicon.svg and public/open-graph.png — your own artwork

Each of those is marked with a TODO where a placeholder is still in place.

Share this article