Skip to content

HAX with a lightweight CMS backend to manage your microsite universe

License

Notifications You must be signed in to change notification settings

future-push/HAXcms

Repository files navigation

HAXCMS

HAX CMS 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.

Install and win the future, NOW!

  • Clone this repo: git clone https://github.com/elmsln/haxcms.git
  • install docker
  • install ddev or install docksal or install lando or install vagrant (We support 'em all!)
  • open a terminal window, go to the directory 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!

Setup surge

If using ddev (the others need some clean up) you can automate the publishing of HAXCMS sites to surge.sh. The install routine for docker / local development tries to automate this but its difficult (and generic). So, if you want to use surge.sh for actually publishing your sites, go to the project directory and login ddev ssh (or equivalent though ddev is the only one working right now). Then type surge login and create / enter your username / password. Now you'll be able to publish the micro-sites direct to domains you define in the ui!

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.

Features

  • All of HAX without needing a bloated CMS to power it
  • Incredibly simple, readable file structure of flat HTML files and lightning fast, high scale micro-sites
  • No database (simple .json files help manage the data)
  • Files you can reach out and touch, fork, and theme with ease!
  • Support for multiple sites
  • BUILT IN surge.sh PUBLISHING!!!!!

Install

Download, checkout and get this package on a server (this is a PHP based implementation so your server should have PHP and Apache or Nginx at minimum). Go to the project root and type bash haxtheweb.sh which will step you through configuration.

Usage

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

License

Apache 2.0

About

HAX with a lightweight CMS backend to manage your microsite universe

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 66.3%
  • HTML 21.6%
  • JavaScript 8.1%
  • Shell 3.6%
  • Other 0.4%