Home

Welcome to Ava 👋

Congratulations! Your site is up and running. This is your homepage, rendered from a simple Markdown file at content/pages/index.md.

What is Ava?

Ava is a flat-file CMS built for developers and writers who love working with files. No databases, no build steps—just Markdown files, PHP templates, and blazing-fast caching.

Why you'll love it

  • 📝 Your Editor, Your Way — Write in any editor. Content is just Markdown.
  • ⚡ Instant Publishing — Edit, save, refresh. No build queues.
  • 🎨 Full HTML Control — Templates are PHP. No framework to fight.
  • 🔍 Built-in Search — Dynamic search works out of the box.
  • 📦 Truly Portable — Back up with cp -r. Version with Git.

Quick Start Guide

1. Create Your First Page

Add a new file at content/pages/contact.md:

---
title: Contact
slug: contact
status: published
---

# Get in Touch

Drop us a line at hello@example.com

Save it and visit /contact. That's all it takes!

2. Write a Blog Post

Create content/posts/my-first-post.md:

---
title: My First Post
slug: my-first-post
date: 2025-01-01
status: published
---

# Hello World

This is my first blog post with Ava.

Your post will appear at /blog/my-first-post.

Tip: Use the CLI for faster content creation: ./ava make post "My First Post"

3. Customize Your Theme

Templates live in themes/default/templates/. They're just PHP with a powerful helper:

<article>
    <h1><?= $ava->e($content->title()) ?></h1>
    <?= $ava->body($content) ?>
</article>

Check out the theme files—they're fully commented to help you learn!

Learn More

Ready to build something great? Start by editing this page, then explore the blog and about pages. Make Ava yours! 🚀