Your first page
From a fresh checkout to a page in your browser.
On this page
Install the project
You need PHP 8.4 or later and Composer. The repository quick start supports Linux, macOS, and WSL2. See installation requirements for extensions and optional services.
git clone https://github.com/anvyr/loom.git
cd loom
./install.sh
./loom serve --host=127.0.0.1 --port=8000
The installer checks the environment, installs dependencies, and sets up the application. Choose CommonMark if you want Markdown content. Open http://127.0.0.1:8000.
Add a page
Create user/content/pages/hello.vlt in the checkout:
---
title: Hello, Loom
status: published
---
@html
<h1>Hello, Loom.</h1>
<p>A page served from a file.</p>
The default content root is user/content/pages. An application can change it in its content configuration; this website uses a symlink to its top-level content/ folder.
The file path determines the URL. status: published makes the page available with debug mode disabled. You do not need a database for file-backed pages.
Open it
In another terminal, rebuild the page index:
./loom index:rebuild
Visit http://127.0.0.1:8000/hello. Edit and commit the page alongside your application. If it is missing, follow the page troubleshooting guide.
Next, learn how files become pages.