Directory Structure

Vibe Site uses your filesystem as the source of truth. Here's the expected layout.

Root Structure

/
  index.md          # Homepage, renders to /
  nav.md            # Navigation menu
  blog/             # Blog posts (flat, date-sorted)
  notes/            # Digital garden (hierarchical)
  snippets/         # Code files (flat)
  talks/            # Talk pages (flat)
  projects/         # Project pages (flat)
  recipes/          # Recipe pages (flat)
  slides/           # Slide decks (flat, no backlinks)
  tags/             # Custom tag pages
  contexts/         # Custom context pages
  images/           # Images (processed)
  static/           # Static files (copied as-is)
  layouts/          # Custom HTML layouts

Special Files

index.md

The root index.md becomes your homepage at /. It can contain directives:

# My Site


  مرحبا بكم في bim 2024-04-01
  How bim Works 2024-03-15
  Building a Digital Garden with Backlinks 2024-03-01
  Tags and Contexts Explained 2024-02-15
  Markdown Features in Vibe Site 2024-02-01


  Writing Content 2026-02-03
  Getting Started 2026-02-03
  Language Detection 2026-02-03
  Collections 2026-02-03
  Tags and Contexts 2026-02-03
  Directives 2026-02-03
  Slides 2026-02-03
  Image Processing 2026-02-03
  Code Snippets 2026-02-03
  Features 2026-02-03

nav.md

Define navigation as a Markdown list:

- [Home](/)
- [Blog](/blog/)
- [Notes](/notes/)

Ignored Paths

All dot-prefixed files (.git, .obsidian, .DS_Store)
node_modules/, target/, dist/
Exception: dot files in static/ are preserved