PHPackages                             erickmerchant/wright - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. erickmerchant/wright

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

erickmerchant/wright
====================

a static site generator

2.0.0(12y ago)042MITPHPPHP &gt;=5.5

Since Mar 8Pushed 11y agoCompare

[ Source](https://github.com/erickmerchant/wright)[ Packagist](https://packagist.org/packages/erickmerchant/wright)[ RSS](/packages/erickmerchant-wright/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependencies (6)Versions (13)Used By (0)

Wright
======

[](#wright)

A static site generator written in PHP.

This README is a work in progress, but should serve as the primary documentation for Wright.

Dependencies
------------

[](#dependencies)

Wright requires PHP 5.5 or greater, and SQLite3 which should be enabled by default in PHP.

Wright allows relationships between data, so when publishing by first writing everything into SQLite it can stay performant.

Getting Started
---------------

[](#getting-started)

You should check out [wright-skeleton](http://github.com/erickmerchant/wright-skeleton) for an example of how to set up a site.

At the bare minimum you'll need the right directory structure, a sitemap settings file, and a template to get started.

The CLI
-------

[](#the-cli)

Make sure ./vendor/bin/wright is executable. You can symlink it to ./wright. Then run `./wright` to get a list of available commands, their arguments and options. Run `./wright [name-of-command] --help` to get help with any command.

Anywhere a directory (also referred to as a collection) or path is called for always include the full path from the current directory. In other words use `data/posts/` instead of `posts/`. This allows you to use tab completion.

### Commands

[](#commands)

`./wright publish`

Publishes your site. It looks at settings/sitemap.yml and creates pages based on it, putting them in site/.

`./wright make`

Used to add a new file to data/.

`./wright move`

Used to move a file from one place in data to another place. Think of moving a draft from data/drafts/ to data/posts/.

Directories
-----------

[](#directories)

### base/

[](#base)

The contents of the base directory are copied over to site/ without modification when publishing.

### data/

[](#data)

The data directory is where your content lives. You use `./wright make` to add files here and then edit them in your editor of choice.

### settings/

[](#settings)

Settings for defaults and your sitemap. (see Settings below)

### templates/

[](#templates)

Your templates. Wright uses Twig. Check out [its docs](http://twig.sensiolabs.org/documentation) to learn more.

### includes/

[](#includes)

The includes directory contains PHP files that set extensions, converters, hooks, and middleware. The only thing required is one converter.

Settings
--------

[](#settings-1)

### sitemap.yml

[](#sitemapyml)

The sitemap settings file tells Wright what pages to create when it publishes your site. It consists of a mapping. Every item is a route with some settings.

This is a portion of the sitemap from the [wright-skeleton](https://github.com/erickmerchant/wright-skeleton)

```
/posts/:
    data: posts
    template: posts
/posts/:slug/:
    data: posts/*
    template: post
```

The first route is straight forward. It tells Wright to grab the data at data/posts.md and feed it to the template called posts. The second route is a bit more complex. `posts/*` tells Wright to use that route for every post, each entry in the posts directory. For each post `:slug` will get expanded or replaced with the slug from that post.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~6 days

Total

12

Last Release

4383d ago

Major Versions

0.9.4 → 1.0.02014-05-06

1.2.1 → 2.0.02014-05-18

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1448088?v=4)[Erick Merchant](/maintainers/erickmerchant)[@erickmerchant](https://github.com/erickmerchant)

---

Top Contributors

[![erickmerchant](https://avatars.githubusercontent.com/u/1448088?v=4)](https://github.com/erickmerchant "erickmerchant (76 commits)")

### Embed Badge

![Health badge](/badges/erickmerchant-wright/health.svg)

```
[![Health](https://phpackages.com/badges/erickmerchant-wright/health.svg)](https://phpackages.com/packages/erickmerchant-wright)
```

###  Alternatives

[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)[concrete5/core

Concrete core subtree split

19159.3k48](/packages/concrete5-core)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)[lullabot/drainpipe

An automated build tool to allow projects to have a set standardized operations scripts.

41716.4k2](/packages/lullabot-drainpipe)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
