Presspack v2.0

1. Description

The aim of this project is to centralize a main scaffolding to be used as starter project for derivated projects. The stack is based on Worpress and to set up a new project you can use this as from Gitlab Repo to start up.

2. Local Development

Getting Started

After cloning its repository:

1. Go to project root directory
2. Run cp .env.sample .env && cp auth.json.sample auth.json
3. Edit .env file accordingly
4. Edit auth.json file, add your personal gitlab token with at least the scope api (https://docs.gitlab.com/ee/user/profile/personal_access_tokens.html#create-a-personal-access-token)
5. Run make composer-update OR simply composer update, if you have composer installed
6. Run make build if it's the first time, or make start to start the project.
7. Wait a bit, until WP installation done and open localhost or localhost/wp-admin (please check for the correct http port. -- default is 80)

Step by step

A step-by-step guide to start (launch) the project, and start working on it.

EXAMPLE:

1. make start should get you http://localhost (runs a docker-compose up with the right file)
2. Run make composer-update to install back-end dependencies
3. Go to (adminer) http://localhost/db to import some seed data
4. Run npm install to install front-end dependencies
5. Run npm dev to start working on the front-end
6. Run npm prod to create production assets (CSS/JS)
7. make stop will take down your containers (runs a docker-compose stop with the right file)

Troubleshooting

⚠️ this deletes your local DB (down -v), and rebuilds everything, but:

If something doesn't work: try running make clean

3. Deploy

1. Run make prod
2. Upload the theme folder to the server