PHPackages                             elmsln/haxcms - 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. elmsln/haxcms

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

elmsln/haxcms
=============

Headless CMS for managing and publishing hybrid static, web component driven sites.

0.12.3(6y ago)129555[4 PRs](https://github.com/elmsln/HAXcms/pulls)Apache-2.0PHPPHP ^7.1CI passing

Since Feb 25Pushed 2d ago20 watchersCompare

[ Source](https://github.com/elmsln/HAXcms)[ Packagist](https://packagist.org/packages/elmsln/haxcms)[ RSS](/packages/elmsln-haxcms/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (5)Versions (20)Used By (0)Security (4)

[![Project Status: Active – The project has reached a stable, usable state and is being actively developed.](https://camo.githubusercontent.com/39c688bf243eeb6d3bfc529dcf3cb27443613deb696c8fa9f49bccf1e63e3bef/68747470733a2f2f7777772e7265706f7374617475732e6f72672f6261646765732f6c61746573742f6163746976652e737667)](https://www.repostatus.org/#active)[![OpenSSF Scorecard](https://camo.githubusercontent.com/f96fd1bba23facf141ef468901a1f9aac0e3a1c84de2405aded12b72aa1c6fc7/68747470733a2f2f6170692e736563757269747973636f726563617264732e6465762f70726f6a656374732f6769746875622e636f6d2f6861787468657765622f686178636d732d7068702f6261646765)](https://securityscorecards.dev/viewer/?uri=github.com/haxtheweb/haxcms-php)[![Community Support](https://camo.githubusercontent.com/f3ac944caa877617554161a50713fa84c806cc281008b0abf405e9c69b5676e3/68747470733a2f2f62616467656e2e6e65742f62616467652f737570706f72742f636f6d6d756e6974792f6379616e3f69636f6e3d617765736f6d65)](/SUPPORT.md)[![License: Apache 2.0](https://camo.githubusercontent.com/b29de0acdfd19013f1f02689b15c933e4a6c145be9efa718288f88ba3280b1c5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d417061636865253230322e302d626c75652e737667)](https://opensource.org/licenses/Apache-2.0)[![Contributor Covenant](https://camo.githubusercontent.com/4ae39ae593b602cf0ae07972b61c73728b77ec8e2cf40f579a2441948208036b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f436f6e7472696275746f72253230436f76656e616e742d322e312d3462616161612e737667)](/CODE_OF_CONDUCT.md)[![Discord](https://camo.githubusercontent.com/155081771f1f717ebd6be59f0cb88fb4ac65ee4a70fec13715509f7e280fdd50/68747470733a2f2f62616467656e2e6e65742f62616467652f69636f6e2f646973636f72643f69636f6e3d646973636f7264266c6162656c)](https://discord.gg/EKYJAjqGhf)[![Lit](https://camo.githubusercontent.com/fd08a6e52668ed07d1259bf09a985b2363fb58f2d3a32616720c332427231a87/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d4c69742d3332346666663f7374796c653d666c6174266c6f676f3d646174613a696d6167652f737667253262786d6c3b6261736536342c50484e325a79426d615778735053496a5a6d5a6d4969423261575633516d393450534977494441674d545977494449774d43496765473173626e4d39496d6830644841364c79393364336375647a4d7562334a6e4c7a49774d44417663335a6e496a3438634746306143426b50534a744d54597749446777646a6777624330304d4330304d4870744c54517749445177646a6777624451774c545177656d30774c546777646a6777624330304d4330304d4870744c54517749445177646a6777624451774c545177656d30744e4441744e4442324f4442734e4441744e444236625451774c545177646a6777624330304d4330304d4870744c545177494445794d4859344d4777744e4441744e444236625330304d4330304d4859344d4777304d4330304d486f694c7a34384c334e325a7a34253344)](https://lit.dev/)[![#HAXTheWeb](https://camo.githubusercontent.com/aaec6ab2d69c788638ea56b5ac89132241fdc8005c5476785263a5c9bd57bdda/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2d4841585468655765622d39393939393946463f7374796c653d666c6174266c6f676f3d646174613a696d6167652f737667253262786d6c3b6261736536342c50484e325a7942705a4430695a6d56684d5445785a5441744d6a45775a433030593251774c574a684d5751745a475a6d4f5451794f4463304e6a67314969426b595852684c57356862575539496b78686557567949444569494868746247357a50534a6f644852774f693876643364334c6e637a4c6d39795a7938794d4441774c334e325a794967646d6c6c64304a76654430694d434177494445344e4334304944457a4e5334354e79492b5047526c5a6e4d2b50484e306557786c5069356c4d574a6a4d6a41794e5330784f4441774c54526b597a49744f4463344e53316a4e445a6c5a4445774d3259304f544a375a6d6c7362446f6a4d6a4d785a6a49774f3330384c334e306557786c506a77765a47566d637a3438634746306143426a6247467a637a30695a544669597a49774d6a55744d5467774d4330305a474d794c5467334f445574597a51325a5751784d444e6d4e446b794969426b50534a4e4e7a67754d4463734f444d754e4456574e5456494f4459754d6e59344c6a457a614445324c6a4932646a51754d44646f4e4334774e3159344d7934304e5567354f433430566a59334c6a4535534467324c6a4a574f444d754e4456614969382b5048427662486c6e6232346763473970626e527a505349784e544d754d544d674e6a4d754e7941784e544d754d544d674e5445754d7a6b674d5451774c6a5530494455784c6a4d35494445304d4334314e43417a4f5334774f5341784d6a63754f5455674d7a6b754d446b674d5449334c6a6b31494449324c6a6335494445774d6934334f4341794e6934334f5341784d4449754e7a67674d7a6b754d446b674d5445314c6a4d3249444d354c6a4135494445784e53347a4e6941314d53347a4f5341784d6a63754f5455674e5445754d7a6b674d5449334c6a6b314944597a4c6a63674d5451774c6a55304944597a4c6a63674d5451774c6a553049446332494445794e79347a4e6941334e6941784d6a63754d7a59674f4467754d7941784d5451754e7a67674f4467754d7941784d5451754e7a67674d5441774c6a5978494445774d6934784f5341784d4441754e6a45674d5441794c6a4535494445784d6934354d5341784d6a63754d7a59674d5445794c6a6b78494445794e79347a4e6941784d4441754e6a45674d544d354c6a6b31494445774d4334324d5341784d7a6b754f5455674f4467754d7941784e5449754e5451674f4467754d7941784e5449754e5451674e7a59674d5459314c6a637949446332494445324e5334334d6941324d793433494445314d7934784d7941324d7934334969382b5048427662486c6e6232346763473970626e527a5053497a4d7934784d7941324d79343349444d7a4c6a457a494455784c6a4d35494451314c6a6379494455784c6a4d35494451314c6a637949444d354c6a4135494455344c6a4d7849444d354c6a4135494455344c6a4d7849444932446a6b344d7934304f4341794e6934334f5341344d7934304f43417a4f5334774f5341334d4334344f53417a4f5334774f5341334d4334344f5341314d53347a4f5341314f43347a4d5341314d53347a4f5341314f43347a4d5341324d793433494451314c6a63794944597a4c6a63674e4455754e7a49674e7a59674e5467754f446b674e7a59674e5467754f446b674f4467754d7941334d5334304f4341344f43347a494463784c6a5134494445774d4334324d5341344e4334774e7941784d4441754e6a45674f4451754d4463674d5445794c6a6b78494455344c6a6735494445784d6934354d5341314f4334344f5341784d4441754e6a45674e4459754d7a45674d5441774c6a5978494451324c6a4d78494467344c6a4d674d7a4d754e7a49674f4467754d79417a4d7934334d6941334e6941794d4334314e4341334e6941794d4334314e4341324d79343349444d7a4c6a457a4944597a4c6a63694c7a34384c334e325a7a34253344)](https://haxtheweb.org/)[![X](https://camo.githubusercontent.com/dc0c98bf81c8d219993d21ddebf4997de1b66a27a13fab5a96665bdb1c5d0580/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f6861787468657765622e7376673f7374796c653d736f6369616c266c6162656c3d466f6c6c6f77)](https://twitter.com/intent/follow?screen_name=haxtheweb)[![Deploy](https://camo.githubusercontent.com/4eea217b02568cc464752586784ae247b22e99fea520a15b6f919b15934ba8ca/68747470733a2f2f7777772e6865726f6b7563646e2e636f6d2f6465706c6f792f627574746f6e2e737667)](https://heroku.com/deploy)

HAX
===

[](#hax)

The authoring experience of HAX and the ability to make fast, static file backed websites rapidly. Get all the details you want on [HAXTheWeb.org](https://haxtheweb.org/)! HAX seeks to be the smallest possible back-end CMS to make HAX work and be able to build websites with it. Leveraging JSON Outline Schema, HAX is able to author multiple pages, which it then writes onto the file system. This way a slim server layer is just for basic authentication, knowing how to save files, and placing them in version control.

Features
--------

[](#features)

- All the UX of HAX brought to a small CMS
- Incredibly simple, readable file structure of flat HTML files and lightning fast, high scale micro-sites
- cdn friendly configuration
- 0 config, 100% offline capable, PWA generation
- clean, simple theme layer abstracted from content
- No database (simple `.json` files help manage relationships, all pages html+webcomponents)
- Files you can reach out and touch, fork, and theme with ease!
- Support for multiple sites
- automatic git repo creation and management (never touch commandline again, but dive in if you really needed)
- Built in gh-pages publishing
- Support for PHP and Express based backends

Hosted solutions
================

[](#hosted-solutions)

Reclaim Hosting / Cloud
-----------------------

[](#reclaim-hosting--cloud)

-  - 1 click install via cPanel (low cost, quick and easy to setup)
-  - 1 click install for a high scale / dedicated resources

HAXiam
======

[](#haxiam)

- HAX can also be installed in a "[HAXiam](https://github.com/haxtheweb/haxiam)" configuration where institutional users automatically get their own HAX spaces to work in by logging in.
- Contact via issue queue if interested in this solution and collaborating to improve it's deployment methodology

Requirements (PHP)
==================

[](#requirements-php)

- Supports PHP 8.3+
- Requires `zip`, `gd`, and `xml` modules be installed
- Apache 2.4

Requirements (node, still in development)
=========================================

[](#requirements-node-still-in-development)

```
cd system/backend/nodejs
yarn run dev
```

Quick Install
-------------

[](#quick-install)

```
$ curl -fsSL https://raw.githubusercontent.com/haxtheweb/haxcms/master/scripts/haxcmsme.sh -o haxcmsme.sh && sh haxcmsme.sh
```

Installation Guides
-------------------

[](#installation-guides)

- There are full installation instructions available at  which details many different install routines.

### Containers

[](#containers)

- Clone this repo: `git clone https://github.com/haxtheweb/haxcms.git`
- Install a server container (recommended). Here are some options (We support 'em all!):
    - [docker](https://store.docker.com/search?type=edition&offering=community)
    - [ddev](https://ddev.readthedocs.io/en/latest/#installation)
    - [docksal](https://docksal.io/installation/)
    - [lando](https://docs.devwithlando.io/installation/installing.html)
    - [vagrant](https://www.vagrantup.com/downloads.html)
- Open a terminal window, go to the directory where you downloaded your container app and type `ddev start` (for ddev) or `fin init` (for docksal) or `lando start && lando magic` (for lando) or `vagrant up` (for vagrant).
- Go to the link any of them give you in a browser.
- Username/password is `admin`/`admin` to get building out static sites locally that you can push up anywhere!
- Click the icon in the top-right and you're off and running!

### MAMP

[](#mamp)

- Download [MAMP](https://www.mamp.info/)
- Download this repo
- Place HAXcms files in the htdocs folder of MAMP.
- Turn MAMP on and click "My website"
- Copy the password it gives you, click to access HAX and then HAX YOUR WEB!

Scope
-----

[](#scope)

Generate `.html` files which have only "content" in them. Meaning the contents of the page in question. A simple method of adding new pages and managing the organization of those pages into a simple hierarchy (outline). Support for multiple mini web sites so that you can write a lot about different topics. HAXcms is only intended to be a micro-site generator and play nicely with the rest of the HAX ecosystem without needing a monster CMS in order to utilize it.

Usage
-----

[](#usage)

Go to `yoursite.com` and login with the username and password you entered in the `_config/config.php` by clicking on the login icon

Windows
-------

[](#windows)

[Cygwin command line](https://www.cygwin.com/) is lightly tested, but slower than true Bash environment.

### Windows Install

[](#windows-install)

To properly configure git endlines for Windows, run this configuration

```
$ git config --global core.autocrlf true
```

### Fedora (31/32) Troubleshooting

[](#fedora-3132-troubleshooting)

Newer versions of Fedora use cgroupsv2 which is currently not supported by Docker. To avoid a cgroup error before running HAX locally (e.g. before using "ddev start" or "fin init") run the following commands.

```
sudo mkdir /sys/fs/cgroup/systemd
sudo mount -t cgroup -o none,name=systemd cgroup /sys/fs/cgroup/systemd
```

MCP and deployment profiles
---------------------------

[](#mcp-and-deployment-profiles)

- MCP policy defaults are controlled via `_config/config.json`.
- New installs include:
    - `deploymentProfile`: `single-site`, `self-hosted-multi-site`, or `haxiam-managed`
    - `mcp.enabled`: global MCP toggle
    - `mcp.readOnly`: write-protection toggle for future MCP write tools
- Default behavior:
    - `haxiam-managed` defaults MCP to disabled unless explicitly enabled.
    - Other profiles default to MCP enabled with read-only mode on.

Get Help / Issues / Support
===========================

[](#get-help--issues--support)

- Discord Channel -
- Unified issue queue -
- Using Merlin directly in any HAX spaces and type "Issue" to jump start a report!

Watch and Learn more about HAX here:
------------------------------------

[](#watch-and-learn-more-about-hax-here)

- Try Hax:
- HAXCellence
- Youtube channel -

Related links and tech
======================

[](#related-links-and-tech)

- [NPM Package list](https://www.npmjs.com/org/haxtheweb)
- [HAXcms (NodeJS)](https://github.com/haxtheweb/haxcms-nodejs)
- [HAXcms (PHP)](https://github.com/haxtheweb/haxcms-php)
- [Storybook docs](https://open-apis.hax.cloud/)
- [HAX \[dot\] PSU](https://hax.psu.edu)
- [HAX doc site](https://haxtheweb.org/)
- [HAX + 11ty](https://github.com/haxtheweb/hax11ty)

[![HAX Traveler: World Changer](https://raw.githubusercontent.com/haxtheweb/art/refs/heads/main/haxtheweb/hax-traveler-world-changer.jpg)](https://raw.githubusercontent.com/haxtheweb/art/refs/heads/main/haxtheweb/hax-traveler-world-changer.jpg)

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance65

Regular maintenance activity

Popularity23

Limited adoption so far

Community29

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 97.2% 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 ~13 days

Total

17

Last Release

2416d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4406e85edba4ec7270b4fd14b2db0ec33c9d62ce9fa2246f8491d9ef2de13d82?d=identicon)[btopro](/maintainers/btopro)

---

Top Contributors

[![btopro](https://avatars.githubusercontent.com/u/329735?v=4)](https://github.com/btopro "btopro (1596 commits)")[![heyMP](https://avatars.githubusercontent.com/u/3428964?v=4)](https://github.com/heyMP "heyMP (11 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (8 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (4 commits)")[![collinkleest](https://avatars.githubusercontent.com/u/43449691?v=4)](https://github.com/collinkleest "collinkleest (4 commits)")[![cgldevel](https://avatars.githubusercontent.com/u/11019355?v=4)](https://github.com/cgldevel "cgldevel (3 commits)")[![liljimmyk99](https://avatars.githubusercontent.com/u/49504930?v=4)](https://github.com/liljimmyk99 "liljimmyk99 (2 commits)")[![thereal54](https://avatars.githubusercontent.com/u/41977924?v=4)](https://github.com/thereal54 "thereal54 (2 commits)")[![ChristianMurphy](https://avatars.githubusercontent.com/u/3107513?v=4)](https://github.com/ChristianMurphy "ChristianMurphy (2 commits)")[![winstonwumbo](https://avatars.githubusercontent.com/u/96748487?v=4)](https://github.com/winstonwumbo "winstonwumbo (1 commits)")[![zlstravel](https://avatars.githubusercontent.com/u/54683917?v=4)](https://github.com/zlstravel "zlstravel (1 commits)")[![chationary](https://avatars.githubusercontent.com/u/54826837?v=4)](https://github.com/chationary "chationary (1 commits)")[![DeGarmoTech](https://avatars.githubusercontent.com/u/54869358?v=4)](https://github.com/DeGarmoTech "DeGarmoTech (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![McGarvelcuddy](https://avatars.githubusercontent.com/u/54725578?v=4)](https://github.com/McGarvelcuddy "McGarvelcuddy (1 commits)")[![mortenson](https://avatars.githubusercontent.com/u/2091002?v=4)](https://github.com/mortenson "mortenson (1 commits)")[![nishiSCIS](https://avatars.githubusercontent.com/u/54913972?v=4)](https://github.com/nishiSCIS "nishiSCIS (1 commits)")[![timmmmyboy](https://avatars.githubusercontent.com/u/3890972?v=4)](https://github.com/timmmmyboy "timmmmyboy (1 commits)")[![webuxr](https://avatars.githubusercontent.com/u/1559023?v=4)](https://github.com/webuxr "webuxr (1 commits)")

---

Tags

cmscourseedtecheducationelmshaxhaxcmshaxthewebjslmsngdlephppublishingwebcomponentswebsite

### Embed Badge

![Health badge](/badges/elmsln-haxcms/health.svg)

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

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[craftcms/cms

Craft CMS

3.6k3.6M2.6k](/packages/craftcms-cms)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19462.3M1.3k](/packages/drupal-core)[civicrm/civicrm-core

Open source constituent relationship management for non-profits, NGOs and advocacy organizations.

728272.9k20](/packages/civicrm-civicrm-core)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[blair2004/nexopos

The Free Modern Point Of Sale System build with Laravel, TailwindCSS and Vue.js.

1.2k2.3k](/packages/blair2004-nexopos)

PHPackages © 2026

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