Installation #
Getting Glaze running takes less than a minute. Install it globally with Composer
and the glaze binary is available from any directory. No system configuration
needed — just PHP and Composer, which you likely already have.
Requirements #
- PHP 8.2 or higher
- Composer 2 or higher
- GD or Imagick extension (for Glide image transforms; GD ships with most PHP builds)
Global install (recommended) #
Installing globally makes glaze available from any directory:
composer global require josbeir/glaze
composer require josbeir/glaze
Verify it works:
glaze --help
vendor/bin/glaze --help
If glaze is not found, Composer’s global bin directory is not in your shell $PATH. Find it and add it:
# Find the path
composer global config bin-dir --absolute
# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
export PATH="$HOME/.composer/vendor/bin:$PATH"
Reload your profile (source ~/.zshrc) and run glaze --help again.
Per-project install #
If you prefer to pin Glaze to a specific project:
mkdir my-site && cd my-site
composer init --no-interaction
composer require josbeir/glaze
Then use the project-local binary for every command:
vendor/bin/glaze --help
vendor/bin/glaze init .
vendor/bin/glaze build
Available commands #
Once the CLI is working, glaze --help lists four commands:
-
init— scaffold a new project in an empty directory -
serve— start a local development server -
build— generate static output fromcontent/andtemplates/ -
new— create a new content page with frontmatter stub
That is the whole CLI surface. You will not need to memorize more than these.
Next step #
Continue with Quick start to scaffold and run your first site in under five minutes.