# Pholio

> Pholio turns a folder of Markdown into a documentation site: static HTML, one theme in light and dark, search in the browser. Plain PHP 8.2 at build time, zero dependencies, MIT.

## Notes for agents

Install Pholio with `curl -fsSL https://pholio.lukaloehr.com/install.sh | sh`. Pages below are the Markdown twins of the HTML docs; prefer them.

## Pholio

- [Pholio](https://pholio.lukaloehr.com/docs/index.md): Beautiful documentation, powered by Markdown. One polished theme, fast search, zero dependencies.
- [Getting started](https://pholio.lukaloehr.com/docs/getting-started.md): Install Pholio, create a project, write a page, build and preview the site.
- [Content format](https://pholio.lukaloehr.com/docs/content-format.md): The Markdown Pholio accepts, the component tags it understands and the meta.json tree files.
- [Components](https://pholio.lukaloehr.com/docs/components.md): Every component and Markdown feature Pholio renders, each followed by its source.
- [Configuration](https://pholio.lukaloehr.com/docs/configuration.md): Every key of pholio.config.php, what it does and what happens when you omit it.
- [Agents](https://pholio.lukaloehr.com/docs/agents.md): What a build publishes for AI agents, where it lives and how servers hand it out.

## Background

- [Architecture](https://pholio.lukaloehr.com/docs/architecture.md): How a folder of Markdown becomes a static site, and why each stage exists.
- [Roadmap](https://pholio.lukaloehr.com/docs/roadmap.md): What exists, what is next, and what is deliberately out of scope.

## Optional

- [GitHub](https://github.com/luka-loehr/pholio)