Typostrap.io distribution of TYPO3 Neos

Open-source version of Typostrap.io project, the prototyping tool built on top of TYPO3 Neos CMS and Zurb Foundation framework.

Background

This is a Typostrap distribution of TYPO3 Neos CMS. It is based on TYPO3 Neos Base distribution, but with M12.Foundation plugin installed (and its dependencies). M12.Foundation aims to implement all Foundation components, in the best possible way, inside TYPO3 Neos CMS.

This work uses Docker containers. It will launch one container with MariaDB database and another container with Nginx/PHP to serve TYPO3 Neos. Therefore some familiarity with Docker is desired.

Usage

Short version

map DOCKER_IP neos-typostrap dev.neos-typostrap in your /etc/hosts file
clone this repository and run:

docker-compose pull
docker-compose up

Once you see success: nginx entered RUNNING state in the console, go to http://neos-typostrap:8899/ in your browser. Your Neos Typostrap edition is ready!

Long version

You will need a machine with Docker daemon to run Docker containers. The easiest way to start with Docker is using Boot2Docker. Follow the documentation from there.
Run boot2docker ip to get Docker host IP (we will refer to it as a DOCKER_IP).
Add line with DOCKER_IP neos-typostrap dev.neos-typostrap to /etc/hosts file on your machine.
You will need Docker Compose installed on your machine, arguably the simplest tool to orchestrate running multiple Docker containers. Follow the documentation there.
Clone this repository (optionally: just grab docker-compose.yml file from here).
Run docker-compose pull to pull the necessary containers from hub.docker.com. Note: this might take a little while (~1.4GB).
Run docker-compose up.
Wait till all containers are running. You will see messages about setting up TYPO3 Neos and at the end you will see something like success: nginx entered RUNNING state and success: php-fpm entered RUNNING state.
Go to http://neos-typostrap:8899/neos to login to the back-end. Use username: admin, password: password to sign in.
The front-end page is available under http://neos-typostrap:8899/. Caveat: It is completely blank until you add and publish some content there, so don't be surprised.

At any time you can stop containers by pressing CTRL+C. Later on simply run fig up again to continue from where you left it.

Development

Fig starts SSH container on port :5555. Run ssh -p 5555 www@DOCKER_IP and you are inside. The code resides inside ~/neos-typostrap directory. You can use this access to run ./flow tool and edit/change/upload files via SFTP.

Authorisation to this SSH is possible via your public key. Set IMPORT_GITHUB_PUB_KEYS in fig.yml to your GitHub username and your key will be imported from there automatically (using public GitHub API).

Author(s)

Marcin Ryzycki marcin@m12.io
Samuel Ryzycki samuel@m12.io

dimaip / neos-typostrap-distribution