**tl;dr: This is placeholder content. Delete it once you've used it to learn how the theme handles images, GIFs, and video.**

Welcome to the Codicio blog. This post exists so you have a working example to copy: real frontmatter, headings, and — most importantly — every way this theme lets you embed media.

## Images

Drop files in `public/assets/img/<year>/<slug>/` and reference them with a normal Markdown image. Paths are absolute from `public/`:

![Codicio dashboard mockup](/assets/img/2026/welcome-to-codicio/dashboard.png)

When you need styling control, use raw HTML instead:

<img src="/assets/img/2026/welcome-to-codicio/circuit.png" alt="Data + AI circuit" style="max-width: 100%; height: auto; border-radius: 12px;" />

## Animations

For short, looping animations this theme uses **animated GIFs**, embedded exactly like an image — there are no `.mp4`/`.webm` files in the original site, just GIFs. The clip below is a placeholder; swap in your own:

![Placeholder animation](/assets/img/2026/welcome-to-codicio/demo.gif)

To record terminal/UI GIFs, tools like [Kap](https://getkap.co/), [Gifski](https://gif.ski/), or `ffmpeg` work well. Keep them under a few MB so pages stay fast.

## Video

For longer clips, embed a YouTube video with the theme's shortcode — put it on its own line (placeholder video below):

{% youtube https://www.youtube.com/watch?v=aqz-KE-bpKQ %}

In `.mdx` posts you can also use the `<TwitterEmbed />` and `<YouTubeEmbed />` components directly.

## Writing posts

- Posts live in `src/content/blog/` and can be organized in year folders (e.g. `2026/`).
- Frontmatter (`title`, `pubDatetime`, `description`, `tags`) is validated in `src/content.config.ts`.
- Set `draft: true` in the frontmatter to hide a post while you work on it.

That's it — duplicate this file, change the frontmatter, and start writing.[^1]

[^1]: All copy here is placeholder text matching the original theme's formatting. The colors, logo, avatar, and images come from the Codicio brand kit in `codicio_homepage`.