README.md

Roadiz Standard Edition CMS

Roadiz is a modern CMS based on a polymorphic node system which can handle many types of services and contents.
Its back-office has been developed with a high sense of design and user experience.
Its theming system is built to live independently from back-office allowing easy switching
and multiple themes for one content basis. For example, it allows you to create one theme
for your desktop website and another one for your mobile, using the same node hierarchy.
Roadiz is released under MIT license, so you can reuse
and distribute its code for personal and commercial projects.

Develop with Vagrant

For development, here are some useful commands:

# Edit your Vagrantfile and use a dedicated IP# add this IP to your /etc/hosts
nano Vagrantfile;# Adapt Makefile with your theme name and NPM/Yarn# This will be useful to generate assets and clear cache# in one command
nano Makefile;cd themes/FooBarTheme;# Install NPM dependenecies for your front-end dev environment.# Use YARN
yarn;# OR use vanilla NPM
npm install;# Init Vagrant dev VM# This may take several minute if your # launching Vagrant up for the first time# as it has to download Roadiz box which is ~ 1,2GBcd ../../;
vagrant up;

If you have a full PHP-MySQL server running directly on your development machine you can
ignore Vagrant and use it. Make sure that your virtual host is configured to use web/
folder as server root.

Develop with Docker

Docker on Linux will provide awesome performances and a production-like environment
without bloating your development machine:

On Linux

Pay attention that PHP is running with www-data user. Linux docker host must
update the docker/php72-nginx-alpine/Dockerfile file to reflect your local user UID.

Update line: && usermod -u 1000 www-data \ using your on UID, you can find it with id command.

On Mac or Windows

Unfortunately, on macOS and Windows performances will be worse than Vagrant due to
the volumes sharing system. You can use docker-sync to improve IO performances with your shared volumes.
Use following command instead ofdocker-compose up -d: