Setup Development Environment - webifycms/app GitHub Wiki

Prerequisites

  • An environment that can run Docker or Docker Desktop.

Installation

# create a 'webifycms-stack' folder in your home directory
mkdir -p ~/webifycms-stack && cd ~/webifycms-stack

# let's clone the application into the created folder
git clone https://github.com/webifycms/app.git # clone app into current directory

# clone the extensions that are required
git clone https://github.com/webifycms/ext-base.git # clone ext-base into the current directory
git clone https://github.com/webifycms/ext-admin.git # clone ext-admin into the current directory
git clone https://github.com/webifycms/ext-user.git # clone ext-user into the current directory
git clone https://github.com/webifycms/ext-site.git # (optional) clone ext-site into the current directory

NOTE: At this point, you can also clone the extension that you would like to contribute, or if you want to start from scratch, you can clone the extension template and rename the folder with the extension name that you prefer.

Create .env file

cd app && cp .env.sample .env

NOTE: The above command will create a .env file from the sample file provided in the project root and fill the values in the file according to your needs. And make sure the APP_ENVIRONMENT is set to 'development' and APP_DEBUG is set to false.

NOTE: There are some other default values, and you can change them as needed. Add the configured APP_BASE_URL value to the host file.

At this point, the expected folder structure will be like this:

.
└── webifycms-stack/
    ├── app/
    │   ├── ...
    │   ├── .env
    │   ├── .env.sample
    │   └── ...
    ├── ext-base
    ├── ext-admin
    └── ext-user

Install Dependencies

# first checkout to the local branch in the 'app' and the 'extensions'
php composer install

Run the Application

Up the containers, that's it.

docker compose up