diff --git a/.blackfire.yml b/.blackfire.yml
new file mode 100644
index 0000000..2d3acb4
--- /dev/null
+++ b/.blackfire.yml
@@ -0,0 +1,81 @@
+tests:
+    'The homepage should be fast':
+        path: 
+          - '/'
+        assertions:
+            - 'main.wall_time <= 250ms'
+    'Some Composer dependencies have known security issues and should be upgraded':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'not has_vulnerable_dependencies()' }
+    '"assert.active" is a dev_only feature and should be disabled in production':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'runtime.configuration.assert_active === false' }
+    '"display_errors" should be disabled':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'not is_configuration_enabled("display_errors")' }
+    '"display_startup_errors" should not be enabled':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'not is_configuration_enabled("display_startup_errors")' }
+    '"max_execution_time" should be less than 30 seconds for Web requests':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'runtime.configuration.max_execution_time <= 30' }
+    '"session.use_strict_mode" should be enabled':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'runtime.configuration.session_use_strict_mode === true' }
+    '"zend.detect_unicode" should be disabled as BOMs are not portable':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'runtime.configuration.zend_detect_unicode === false' }
+    'The realpath cache ttl should be more than one hour in production':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'runtime.configuration.realpath_cache_ttl >= 3600' }
+    'The session garbage collector should be disabled in production':
+        path:
+            - '/.*'
+        assertions:
+            - { expression: 'runtime.configuration.session_gc_probability === 0' }
+
+scenarios: |
+    #!blackfire-player
+
+    name "Drupal Scenarios"
+
+    group homepages
+        visit url("/")
+            name "Homepage (English)"
+            expect status_code() == 200
+        visit url("/es")
+            name "Homepage (Español)"
+            expect status_code() == 200
+
+    group articles
+        visit url("/en/articles")
+            name "Articles"
+            expect status_code() == 200
+
+    group admin_anonymous
+        visit url("/en/admin/content")
+            expect status_code() == 403
+        visit url("/en/admin/structure")
+            expect status_code() == 403
+
+    scenario
+        name "Anonymous Visit"
+        include homepages
+        include articles
+        include admin_anonymous
diff --git a/.ddev/config.yaml b/.ddev/config.yaml
new file mode 100644
index 0000000..0bd50b1
--- /dev/null
+++ b/.ddev/config.yaml
@@ -0,0 +1,207 @@
+name: api
+type: drupal8
+docroot: web
+php_version: "7.4"
+webserver_type: nginx-fpm
+router_http_port: "8000"
+router_https_port: "8443"
+xdebug_enabled: false
+additional_hostnames: []
+additional_fqdns: []
+database:
+  type: mariadb
+  version: "10.3"
+nfs_mount_enabled: false
+mutagen_enabled: false
+use_dns_when_possible: true
+composer_version: "2"
+web_environment: []
+nodejs_version: "16"
+
+# Key features of ddev's config.yaml:
+
+# name: <projectname> # Name of the project, automatically provides
+#   http://projectname.ddev.site and https://projectname.ddev.site
+
+# type: <projecttype>  # drupal6/7/8, backdrop, typo3, wordpress, php
+
+# docroot: <relative_path> # Relative path to the directory containing index.php.
+
+# php_version: "7.4"  # PHP version to use, "5.6", "7.0", "7.1", "7.2", "7.3", "7.4", "8.0", "8.1"
+
+# You can explicitly specify the webimage but this
+# is not recommended, as the images are often closely tied to ddev's' behavior,
+# so this can break upgrades.
+
+# webimage: <docker_image>  # nginx/php docker image.
+
+# database:
+#   type: <dbtype> # mysql, mariadb
+#   version: <version> # database version, like "10.3" or "8.0"
+# Note that mariadb_version or mysql_version from v1.18 and earlier
+# will automatically be converted to this notation with just a "ddev config --auto"
+
+# router_http_port: <port>  # Port to be used for http (defaults to port 80)
+# router_https_port: <port> # Port for https (defaults to 443)
+
+# xdebug_enabled: false  # Set to true to enable xdebug and "ddev start" or "ddev restart"
+# Note that for most people the commands
+# "ddev xdebug" to enable xdebug and "ddev xdebug off" to disable it work better,
+# as leaving xdebug enabled all the time is a big performance hit.
+
+# xhprof_enabled: false  # Set to true to enable xhprof and "ddev start" or "ddev restart"
+# Note that for most people the commands
+# "ddev xhprof" to enable xhprof and "ddev xhprof off" to disable it work better,
+# as leaving xhprof enabled all the time is a big performance hit.
+
+# webserver_type: nginx-fpm  # or apache-fpm
+
+# timezone: Europe/Berlin
+# This is the timezone used in the containers and by PHP;
+# it can be set to any valid timezone,
+# see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+# For example Europe/Dublin or MST7MDT
+
+# composer_root: <relative_path>
+# Relative path to the composer root directory from the project root. This is
+# the directory which contains the composer.json and where all Composer related
+# commands are executed.
+
+# composer_version: "2"
+# if composer_version:"2" it will use the most recent composer v2
+# It can also be set to "1", to get most recent composer v1
+# or "" for the default v2 created at release time.
+# It can be set to any existing specific composer version.
+# After first project 'ddev start' this will not be updated until it changes
+
+# nodejs_version: "16"
+# change from the default system Node.js version to another supported version, like 12, 14, 17.
+# Note that you can use 'ddev nvm' or nvm inside the web container to provide nearly any
+# Node.js version, including v6, etc.
+
+# additional_hostnames:
+#  - somename
+#  - someothername
+# would provide http and https URLs for "somename.ddev.site"
+# and "someothername.ddev.site".
+
+# additional_fqdns:
+#  - example.com
+#  - sub1.example.com
+# would provide http and https URLs for "example.com" and "sub1.example.com"
+# Please take care with this because it can cause great confusion.
+
+# upload_dir: custom/upload/dir
+# would set the destination path for ddev import-files to <docroot>/custom/upload/dir
+
+# working_dir:
+#   web: /var/www/html
+#   db: /home
+# would set the default working directory for the web and db services.
+# These values specify the destination directory for ddev ssh and the
+# directory in which commands passed into ddev exec are run.
+
+# omit_containers: [db, dba, ddev-ssh-agent]
+# Currently only these containers are supported. Some containers can also be
+# omitted globally in the ~/.ddev/global_config.yaml. Note that if you omit
+# the "db" container, several standard features of ddev that access the
+# database container will be unusable. In the global configuration it is also
+# possible to omit ddev-router, but not here.
+
+# nfs_mount_enabled: false
+# Great performance improvement but requires host configuration first.
+# See https://ddev.readthedocs.io/en/stable/users/performance/#using-nfs-to-mount-the-project-into-the-container
+
+# mutagen_enabled: false
+# Experimental performance improvement using mutagen asynchronous updates.
+# See https://ddev.readthedocs.io/en/latest/users/performance/#using-mutagen
+
+# fail_on_hook_fail: False
+# Decide whether 'ddev start' should be interrupted by a failing hook
+
+# host_https_port: "59002"
+# The host port binding for https can be explicitly specified. It is
+# dynamic unless otherwise specified.
+# This is not used by most people, most people use the *router* instead
+# of the localhost port.
+
+# host_webserver_port: "59001"
+# The host port binding for the ddev-webserver can be explicitly specified. It is
+# dynamic unless otherwise specified.
+# This is not used by most people, most people use the *router* instead
+# of the localhost port.
+
+# host_db_port: "59002"
+# The host port binding for the ddev-dbserver can be explicitly specified. It is dynamic
+# unless explicitly specified.
+
+# phpmyadmin_port: "8036"
+# phpmyadmin_https_port: "8037"
+# The PHPMyAdmin ports can be changed from the default 8036 and 8037
+
+# host_phpmyadmin_port: "8036"
+# The phpmyadmin (dba) port is not normally bound on the host at all, instead being routed
+# through ddev-router, but it can be specified and bound.
+
+# mailhog_port: "8025"
+# mailhog_https_port: "8026"
+# The MailHog ports can be changed from the default 8025 and 8026
+
+# host_mailhog_port: "8025"
+# The mailhog port is not normally bound on the host at all, instead being routed
+# through ddev-router, but it can be bound directly to localhost if specified here.
+
+# webimage_extra_packages: [php7.4-tidy, php-bcmath]
+# Extra Debian packages that are needed in the webimage can be added here
+
+# dbimage_extra_packages: [telnet,netcat]
+# Extra Debian packages that are needed in the dbimage can be added here
+
+# use_dns_when_possible: true
+# If the host has internet access and the domain configured can
+# successfully be looked up, DNS will be used for hostname resolution
+# instead of editing /etc/hosts
+# Defaults to true
+
+# project_tld: ddev.site
+# The top-level domain used for project URLs
+# The default "ddev.site" allows DNS lookup via a wildcard
+# If you prefer you can change this to "ddev.local" to preserve
+# pre-v1.9 behavior.
+
+# ngrok_args: --subdomain mysite --auth username:pass
+# Provide extra flags to the "ngrok http" command, see
+# https://ngrok.com/docs#http or run "ngrok http -h"
+
+# disable_settings_management: false
+# If true, ddev will not create CMS-specific settings files like
+# Drupal's settings.php/settings.ddev.php or TYPO3's AdditionalConfiguration.php
+# In this case the user must provide all such settings.
+
+# You can inject environment variables into the web container with:
+# web_environment:
+# - SOMEENV=somevalue
+# - SOMEOTHERENV=someothervalue
+
+# no_project_mount: false
+# (Experimental) If true, ddev will not mount the project into the web container;
+# the user is responsible for mounting it manually or via a script.
+# This is to enable experimentation with alternate file mounting strategies.
+# For advanced users only!
+
+# bind_all_interfaces: false
+# If true, host ports will be bound on all network interfaces,
+# not just the localhost interface. This means that ports
+# will be available on the local network if the host firewall
+# allows it.
+
+# Many ddev commands can be extended to run tasks before or after the
+# ddev command is executed, for example "post-start", "post-import-db",
+# "pre-composer", "post-composer"
+# See https://ddev.readthedocs.io/en/stable/users/extending-commands/ for more
+# information on the commands that can be extended and the tasks you can define
+# for them. Example:
+#hooks:
+# post-import-db:
+#   - exec: drush cr
+#   - exec: drush updb
diff --git a/.ddev/providers/platform.yaml b/.ddev/providers/platform.yaml
new file mode 100755
index 0000000..19ce750
--- /dev/null
+++ b/.ddev/providers/platform.yaml
@@ -0,0 +1,63 @@
+#ddev-generated
+# Example Platform.sh provider configuration.
+
+# To use this configuration,
+
+# 1. Check out the site from platform.sh and then configure it with `ddev config`. You'll want to use `ddev start` and make sure the basic functionality is working.
+# 2. Obtain and configure an API token.
+#    a. Login to the Platform.sh Dashboard and go to Account->API Tokens to create an API token for ddev to use.
+#    b. Add the API token to the `web_environment` section in your global ddev configuration at ~/.ddev/global_config.yaml:
+#    ```yaml
+#    web_environment:
+#    - PLATFORMSH_CLI_TOKEN=abcdeyourtoken
+#    ```
+# 3. `ddev restart`
+# 4. Obtain your project id with `ddev exec platform`. The platform tool should show you all the information about your account and project.
+# 5. In your project's .ddev/providers directory, copy platform.yaml.example to platform.yaml and edit the `project_id` and `environment_name`.
+# 6. Run `ddev pull platform`. After you agree to the prompt, the current upstream database and files will be downloaded.
+# 7. Optionally use `ddev push platform` to push local files and database to platform.sh. Note that `ddev push` is a command that can potentially damage your production site, so this is not recommended.
+
+# Debugging: Use `ddev exec platform` to see what platform.sh knows about
+# your configuration and whether it's working correctly.
+
+environment_variables:
+  project_id: yourproject
+  environment: main
+  application: drupal
+
+auth_command:
+  command: |
+    set -eu -o pipefail
+    if [ -z "${PLATFORMSH_CLI_TOKEN:-}" ]; then echo "Please make sure you have set PLATFORMSH_CLI_TOKEN in ~/.ddev/global_config.yaml" && exit 1; fi
+
+db_pull_command:
+  command: |
+    set -x   # You can enable bash debugging output by uncommenting
+    set -eu -o pipefail
+    ls /var/www/html/.ddev >/dev/null # This just refreshes stale NFS if possible
+    platform db:dump --yes --gzip --file=/var/www/html/.ddev/.downloads/db.sql.gz --project="${project_id}" --environment="${environment}" --app="${application}"
+
+files_pull_command:
+  command: |
+    set -x   # You can enable bash debugging output by uncommenting
+    set -eu -o pipefail
+    ls /var/www/html/.ddev >/dev/null # This just refreshes stale NFS if possible
+    platform mount:download --yes --quiet --project="${project_id}" --environment="${environment}" --app="${application}" --mount=web/sites/default/files --target=/var/www/html/.ddev/.downloads/files
+
+
+# push is a dangerous command. If not absolutely needed it's better to delete these lines.
+db_push_command:
+  command: |
+    set -x   # You can enable bash debugging output by uncommenting
+    set -eu -o pipefail
+    ls /var/www/html/.ddev >/dev/null # This just refreshes stale NFS if possible
+    pushd /var/www/html/.ddev/.downloads >/dev/null;
+    gzip -dc db.sql.gz | platform db:sql --project="${project_id}" --environment="${environment}"
+
+# push is a dangerous command. If not absolutely needed it's better to delete these lines.
+files_push_command:
+  command: |
+    set -x   # You can enable bash debugging output by uncommenting
+    set -eu -o pipefail
+    ls "${DDEV_FILES_DIR}" >/dev/null # This just refreshes stale NFS if possible
+    platform mount:upload --yes --quiet --project="${project_id}" --environment="${environment}" --source="${DDEV_FILES_DIR}" --mount=web/sites/default/files
diff --git a/.lando.upstream.yml b/.lando.upstream.yml
index 28b3fbe..ff6d2fc 100644
--- a/.lando.upstream.yml
+++ b/.lando.upstream.yml
@@ -7,7 +7,7 @@
 
 # These both allow you to test this template without needing a site on Platform.sh
 # However you will want to replace them in your .lando.yml
-name: platformsh-drupal8-opigno
+name: platformsh-drupal8
 recipe: platformsh
 
 config:
@@ -30,5 +30,3 @@ config:
 tooling:
   drush:
     service: app
-  drupal:
-    service: app
diff --git a/.platform.app.yaml b/.platform.app.yaml
index 5e939d0..079874e 100644
--- a/.platform.app.yaml
+++ b/.platform.app.yaml
@@ -4,7 +4,7 @@
 # See https://docs.platform.sh/configuration/app.html
 
 # The name of this app. Must be unique within a project.
-name: 'app'
+name: 'drupal'
 
 # The runtime the application uses.
 type: 'php:7.4'
diff --git a/.platform/routes.yaml b/.platform/routes.yaml
index 425c962..69ba2fc 100644
--- a/.platform/routes.yaml
+++ b/.platform/routes.yaml
@@ -5,7 +5,7 @@
 
 "https://{default}/":
     type: upstream
-    upstream: "app:http"
+    upstream: "drupal:http"
     cache:
       enabled: true
 
diff --git a/README.md b/README.md
index c225540..f34177f 100644
--- a/README.md
+++ b/README.md
@@ -1,48 +1,834 @@
-# Opigno Drupal Distribution for Platform.sh
+
+<p align="right">
+<a href="https://platform.sh">
+<img src="https://platform.sh/logos/redesign/Platformsh_logo_black.svg" width="150px">
+</a>
+</p>
 
 <p align="center">
-<a href="https://console.platform.sh/projects/create-project?template=https://raw.githubusercontent.com/platformsh/template-builder/master/templates/drupal8-opigno/.platform.template.yaml&utm_content=drupal8-opigno&utm_source=github&utm_medium=button&utm_campaign=deploy_on_platform">
-    <img src="https://platform.sh/images/deploy/lg-blue.svg" alt="Deploy on Platform.sh" width="180px" />
+<a href="https://www.drupal.org/">
+<img src="header.svg">
 </a>
 </p>
 
+<h1 align="center">Deploy Opigno Drupal Distribution on Platform.sh</h1>
+
+<p align="center">
+<strong>Contribute, request a feature, or check out our resources</strong>
+<br />
+<br />
+<a href="https://community.platform.sh"><strong>Join our community</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="https://docs.platform.sh"><strong>Documentation</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="https://platform.sh/blog"><strong>Blog</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="https://github.com/platformsh-templates/drupal8-opigno/issues/new?assignees=&labels=bug&template=bug_report.yml"><strong>Report a bug</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="https://github.com/platformsh-templates/drupal8-opigno/issues/new?assignees=&labels=feature+request&template=improvements.yml"><strong>Request a feature</strong></a>
+<br /><br />
+</p>
+
+<p align="center">
+<a href="https://github.com/platformsh-templates/drupal8-opigno/issues">
+<img src="https://img.shields.io/github/issues/platformsh-templates/drupal8-opigno.svg?style=for-the-badge&labelColor=f4f2f3&color=ffd9d9&label=Issues" alt="Open issues" />
+</a>&nbsp&nbsp
+<a href="https://github.com/platformsh-templates/drupal8-opigno/pulls">
+<img src="https://img.shields.io/github/issues-pr/platformsh-templates/drupal8-opigno.svg?style=for-the-badge&labelColor=f4f2f3&color=ffd9d9&label=Pull%20requests" alt="Open PRs" />
+</a>&nbsp&nbsp
+<a href="https://github.com/platformsh-templates/drupal8-opigno/blob/master/LICENSE">
+<img src="https://img.shields.io/static/v1?label=License&message=MIT&style=for-the-badge&labelColor=f4f2f3&color=ffd9d9" alt="License" />
+</a>&nbsp&nbsp
+<br /><br />
+<a href="https://console.platform.sh/projects/create-project/?template=https://raw.githubusercontent.com/platformsh-templates/drupal8-opigno/updates/.platform.template.yaml&utm_campaign=deploy_on_platform?utm_medium=button&utm_source=affiliate_links&utm_content=https://raw.githubusercontent.com/platformsh-templates/drupal8-opigno/updates/.platform.template.yaml" target="_blank" title="Deploy with Platform.sh"><img src="https://platform.sh/images/deploy/deploy-button-lg-blue.svg" width="175px"></a>
+</p>
+</p>
+
+<hr>
+
+<p align="center">
+<strong>Contents</strong>
+<br /><br />
+<a href="#about"><strong>About</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="#getting-started"><strong>Getting started</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="#migrate"><strong>Migrate</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="#learn"><strong>Learn</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="#contribute"><strong>Contribute</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<br />
+</p>
+<hr>
+
+## About
+
 This template builds the Opigno Drupal 8 distribution using the [Drupal Composer project](https://github.com/drupal-composer/drupal-project) for better flexibility.  It also includes configuration to use Redis for caching, although that must be enabled post-install in `.platform.app.yaml`.
 
 Opigno is a Learning Management system built as a Drupal distribution.
 
-## Features
+### Features
+
+- PHP 7.4
+- MariaDB 10.4
+- Redis 6
+- Drush included
+- Automatic TLS certificates
+- Composer-based build
+
+
+## Getting started
+
+### Deploy
+
+#### Quickstart
+
+
+The quickest way to deploy this template on Platform.sh is by clicking the button below. 
+This will automatically create a new project and initialize the repository for you.
+
+<p align="center">
+    <a href="https://console.platform.sh/projects/create-project?template=https://raw.githubusercontent.com/platformsh/template-builder/master/templates/drupal8-opigno/.platform.template.yaml&utm_content=drupal8-opigno&utm_source=github&utm_medium=button&utm_campaign=deploy_on_platform">
+        <img src="https://platform.sh/images/deploy/lg-blue.svg" alt="Deploy on Platform.sh" width="170px" />
+    </a>
+</p>
+<br/>
+
+
+
+You can also quickly recreate this project locally with the following command:
+
+```bash
+composer create-project platformsh/drupal8-opigno -s dev
+```
+
+
+> **Note:**    
+>
+> Platform.sh templates prioritize upstream release versions over our own. Despite this, we update template dependencies on a scheduled basis independent of those upstreams. Because of this, template repos do not contain releases. This may change in the future, but until then the `-s dev` flag is necessary to use `composer create-project`.
+
+
+
+#### Other deployment options
+
+For all of the other options below, clone this repository first:
+
+```bash
+git clone https://github.com/platformsh-templates/drupal8-opigno
+```
+
+If you're trying to deploy from GitHub, you can generate a copy of this repository first in your own namespace by clicking the [Use this template](https://github.com/platformsh-templates/drupal8-opigno/generate) button at the top of this page. 
+
+Then you can clone a copy of it locally with `git clone git@github.com:YOUR_NAMESPACE/drupal8-opigno.git`.
+
+
+<details>
+<summary>Deploy directly to Platform.sh from the command line</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
+
+1. Install the Platform.sh CLI
+
+   #### Linux/OSX
+
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
+
+   #### Windows
+
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
+
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Set the project remote
+
+   Find your `PROJECT_ID` by running the command `platform project:list` 
+
+   ```bash
+   +---------------+------------------------------------+------------------+---------------------------------+
+   | ID            | Title                              | Region           | Organization                    |
+   +---------------+------------------------------------+------------------+---------------------------------+
+   | PROJECT_ID    | Your Project Name                  | xx-5.platform.sh | your-username                   |
+   +---------------+------------------------------------+------------------+---------------------------------+
+   ```
+
+   Then from within your local copy, run the command `platform project:set-remote PROJECT_ID`.
+
+1. Push
+
+   ```bash
+   git push platform DEFAULT_BRANCH
+   ```
+   
+<!-- <br/>
+</blockquote> -->
+</details>
+
+<details>
+<summary>Integrate with a GitHub repo and deploy pull requests</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to whatever you have set at `https://YOUR_NAMESPACE/nextjs-drupal`.
+
+1. Install the Platform.sh CLI
+
+   #### Linux/OSX
+
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
+
+   #### Windows
+
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
+
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Setup the integration:
+
+   Consult the [GitHub integration documentation](https://docs.platform.sh/integrations/source/github.html#setup) to finish connecting your repository to a project on Platform.sh. You will need to create an Access token on GitHub to do so.
+
+<!-- <br/>
+</blockquote> -->
+</details>
+
+<details>
+<summary>Integrate with a GitLab repo and deploy merge requests</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
+
+1. Install the Platform.sh CLI
+
+   #### Linux/OSX
+
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
+
+   #### Windows
 
-* PHP 7.3
-* MariaDB 10.4
-* Redis 6
-* Drush and Drupal Console included
-* Automatic TLS certificates
-* Composer-based build
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
 
-## Post-install
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Create the repository
+
+   Create a new repository on GitLab, set it as a new remote for your local copy, and push to the default branch. 
+
+1. Setup the integration:
+
+   Consult the [GitLab integration documentation](https://docs.platform.sh/integrations/source/gitlab.html#setup) to finish connecting a repository to a project on Platform.sh. You will need to create an Access token on GitLab to do so.
+
+<!-- <br/>
+</blockquote> -->
+</details>
+
+<details>
+<summary>Integrate with a Bitbucket repo and deploy pull requests</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
+
+1. Install the Platform.sh CLI
+
+   #### Linux/OSX
+
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
+
+   #### Windows
+
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
+
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Create the repository
+
+   Create a new repository on Bitbucket, set it as a new remote for your local copy, and push to the default branch. 
+
+1. Setup the integration:
+
+   Consult the [Bitbucket integration documentation](https://docs.platform.sh/integrations/source/bitbucket.html#setup) to finish connecting a repository to a project on Platform.sh. You will need to create an Access token on Bitbucket to do so.
+
+<!-- <br/>
+</blockquote> -->
+</details>
+
+
+
+### Post-install
 
 Run through the Opigno installer as normal.  You will not be asked for database credentials as those are already provided.
 
+### Local development
+
+This section provides instructions for running the `drupal8-opigno` template locally, connected to a live database instance on an active Platform.sh environment.
+
+In all cases for developing with Platform.sh, it's important to develop on an isolated environment - do not connect to data on your production environment when developing locally. 
+Each of the options below assume that you have already deployed this template to Platform.sh, as well as the following starting commands:
+
+```bash
+$ platform get PROJECT_ID
+$ cd project-name
+$ platform environment:branch updates
+```
+
+<details>
+<summary>Drupal: using ddev</summary><br />
+
+ddev provides an integration with Platform.sh that makes it simple to develop Drupal locally. Check the [providers documentation](https://ddev.readthedocs.io/en/latest/users/providers/platform/) for the most up-to-date information. 
+
+In general, the steps are as follows:
+
+1. [Install ddev](https://ddev.readthedocs.io/en/stable/#installation).
+1. A configuration file has already been provided at `.ddev/providers/platform.yaml`, so you should not need to run `ddev config`.
+1. [Retrieve an API token](https://docs.platform.sh/development/cli/api-tokens.html#get-a-token) for your organization via the management console.
+1. Update your dedev global configuration file to use the token you've just retrieved: 
+    ```yaml
+    web_environment:
+    - PLATFORMSH_CLI_TOKEN=abcdeyourtoken`
+    ```
+1. Run `ddev restart`.
+1. Get your project ID with `platform project:info`. If you have not already connected your local repo with the project (as is the case with a source integration, by default), you can run `platform project:list` to locate the project ID, and `platform project:set-remote PROJECT_ID` to configure Platform.sh locally.
+1. Update the `.ddev/providers/platform.yaml` file for your current setup:
+    ```yaml
+    environment_variables:
+    project_id: PROJECT_ID
+    environment: CURRENT_ENVIRONMENT
+    application: drupal
+    ```
+1. Get the current environment's data with `ddev pull platform`. 
+1. When you have finished with your work, run `ddev stop` and `ddev poweroff`.
+
+</details>
+<details>
+<summary>Drupal: using Lando</summary><br />
+
+Lando supports PHP applications [configured to run on Platform.sh](https://docs.platform.sh/development/local/lando.html), and pulls from the same container registry Platform.sh uses on your remote environments during your local builds through its own [recipe and plugin](https://docs.lando.dev/platformsh/). 
+
+1. [Install Lando](https://docs.lando.dev/getting-started/installation.html).
+1. Make sure Docker is already running - Lando will attempt to start Docker for you, but it's best to have it running in the background before beginning.
+1. Start your apps and services with the command `lando start`.
+1. To get up-to-date data from your Platform.sh environment ([services *and* mounts](https://docs.lando.dev/platformsh/sync.html#pulling)), run the command `lando pull`.
+1. If at any time you have updated your Platform.sh configuration files, run the command `lando rebuild`.
+1. When you have finished with your work, run `lando stop` and `lando poweroff`.
+
+</details>
+
+
+
 > **Note:**
 >
-> After installation is complete, you may see the following error: `The website encountered an unexpected error. Please try again later.`. If so, SSH into the environment and run `drush -y cache-rebuild` twice to clear the cache.
+> For many of the steps above, you may need to include the CLI flags `-p PROJECT_ID` and `-e ENVIRONMENT_ID` if you are not in the project directory or if the environment is associated with an existing pull request.
+
+
+## Migrate
+
+The steps below outline the important steps for migrating your application to Platform.sh - adding the required configuration files and dependencies, for example.
+Not every step will be applicable to each person's migration.
+These steps actually assume the earliest starting point possible - that there is no code at all locally, and that this template repository will be rebuilt completely from scratch.
+
+- [Getting started](#getting-started-1)
+- [Adding and updating files](#adding-and-updating-files)
+- [Dependencies](#dependencies)
+- [Deploying to Platform.sh](#deploying-to-platformsh)
+- [Migrating your data](#migrating-your-data)
+- [Next steps](#next-steps)
+
+If you already have code you'd like to migrate, feel free to focus on the steps most relevant to your application and skip the first section.
+
+### Getting started
+
+Assuming that your starting point is no local code, the steps below will setup a starting repository we can begin to make changes to to rebuild this template and migrate to Platform.sh. 
+If you already have a codebase you are trying to migrate, move onto the next step - [Adding and updating files](#adding-and-updating-files) - and substitute any reference to the default branch `main` with some other branch name.
+
+
+
+```bash
+$ mkdir drupal8-opigno && cd drupal8-opigno
+$ git init
+$ git remote add upstream https://bitbucket.org/opigno/opigno-composer.git
+$ git branch -m main
+$ git fetch --all --depth=2
+$ git fetch --all --tags
+$ git merge --allow-unrelated-histories -X theirs 2.29.0
+
+```
+
+
+
+### Adding and updating files
+
+A small number of files need to be added to or modified in your repository at this point. 
+Some of them explicitly configure how the application is built and deployed on Platform.sh, while others simply modify files you may already have locally, in which case you will need to replicate those changes.
+
+Open the dropdown below to view all of the **Added** and **Updated** files you'll need to reproduce in your migration.
+
+<details>
+<summary><strong>View files</strong></summary><br/>
+
+
+
+|  File | Purpose    |
+|:-----------|:--------|
+| [`config/sync/.gitkeep`](config/sync/.gitkeep) | **Added** |
+| [`web/sites/default/settings.php`](web/sites/default/settings.php) | **Updated:**<br><br> The Drupal settings file has been updated to import and use `web/sites/default/settings.platformsh.php`. |
+| [`web/sites/default/settings.platformsh.php`](web/sites/default/settings.platformsh.php) | **Added:**<br><br> Contains Platform.sh-specific configuration, namely setting up the database connection to the MariaDB service and caching via Redis. |
+| [`.environment`](.environment) | **Added:**<br><br> The `.environment` file is a convenient place to [set environment variables](https://docs.platform.sh/development/variables/set-variables.html#set-variables-via-script) relevant to your applications that may be dependent on the current environment. It is sourced before the start command is run, as the first step in the `deploy` and `post_deploy` hooks, and at the beginning of each session when you SSH into an application container. It is written in dash, so be aware of the differences to bash.<br><br>It can be used to set any environment variable, including ones that depend on Platform.sh-provided variables like `PLATFORM_RELATIONSHIPS` and `PLATFORM_ROUTES`, or to modify `PATH`. This file should not [produce output](https://docs.platform.sh/development/variables/set-variables.html#testing-environment-scripts).<br><br> Here, the Composer config and `PATH` are updated to allow executable app dependencies from Composer to be run from the path (i.e. `drush`). |
+| [`.gitignore`](.gitignore) | **Added:**<br><br> A `.gitignore` file is not included in the upstream, so one has been added. |
+| [`.lando.upstream.yml`](.lando.upstream.yml) | **Added:**<br><br> This file configures [Lando](https://docs.platform.sh/development/local/lando.html) as a local development option for this template. See the [Platform.sh Lando plugin documentation](https://docs.lando.dev/platformsh/) for more information about configuration and the [Local development](#local-development) section of this README for how to get started. |
+| [`.platform.app.yaml`](.platform.app.yaml) | **Added:**<br><br> This file is required to define the build and deploy process for all application containers on Platform.sh. Within this file, the runtime version, relationships to service containers, and writable mounts are configured. It's also in this file that it is defined what dependencies are installed, when they are installed, and that package manager will be used to do so.<br><br>Take a look at the [Application](https://docs.platform.sh/configuration/app.html) documentation for more details about configuration. For more information about the sequence of events that lead from a build to deployment, see the [Build and deploy timeline documentation](https://docs.platform.sh/overview/build-deploy.html).<br><br> This template uses Composer 2 to install dependencies using the default `composer` [build flavor](https://docs.platform.sh/languages/php.html#build-flavor) prior to the `build` hook. Drush tasks are run during the `deploy` hook, and referenced again during the defined `cron` job. |
+| [`drush/platformsh_generate_drush_yml.php`](drush/platformsh_generate_drush_yml.php) | **Added:**<br><br> This file has been included to generate the drush yaml configuration on every deployment. |
+| [`.platform/services.yaml`](.platform/services.yaml) | **Added:**<br><br> Platform.sh provides a number of on-demand managed services that can easily be added to your projects. It's within this file that each service's version, name, resources, and additional configuration are set. See the [Services documentation](https://docs.platform.sh/configuration/services.html) for more details on configuration, version and service availability.<br><br> In this template, MariaDB and Redis have been configured. |
+| [`.platform/routes.yaml`](.platform/routes.yaml) | **Added:**<br><br> This file is require to deploy on Platform.sh, as it defines how requests should be handled on the platform. It's within this file that redirects and basic caching can be configured. See the [Routes documentation](https://docs.platform.sh/configuration/routes.html) for more configuration details.<br><br> |
+| [`php.ini`](php.ini) | **Added:**<br><br> An initial `php.ini` file has also beed added. The settings are a result of performance testing and best practice recommendations coming from [Blackfire.io](https://blackfire.io). They will initialize Drupal with a number of good baseline performance settings for production applications, and complement many of the tests specified in [`.blackfire.yml`](.blackfire.yml). |
+| [`.blackfire.yml`](.blackfire.yml) | **Added:**<br><br> This file has been added to help you get started using [Blackfire.io](https://blackfire.io) on your project. See [the Blackfire section below](#blackfireio-creating-a-continuous-observability-strategy) for more information on how to get started. |
+| [`.lando.upstream.yml`](.lando.upstream.yml) | **Added:**<br><br> This file configures [Lando](https://docs.platform.sh/development/local/lando.html) as a local development option for this template. See the [Platform.sh Lando plugin documentation](https://docs.lando.dev/platformsh/) for more information about configuration and the [Local development](#local-development) section of this README for how to get started. |
+| [`.ddev/providers/platform.yaml`](.ddev/providers/platform.yaml) | **Added:**<br><br> This file configures [ddev](https://ddev.readthedocs.io/en/latest/users/providers/platform/) as a local development option for this template. See the [Platform.sh ddev integration documentation](https://ddev.readthedocs.io/en/latest/users/providers/platform/) for more information about configuration and the [Local development](#local-development) section of this README for how to get started. Be sure to follow the instructions provided through the ddev CLI and in the comments section of that file to correctly configure ddev for your project. |
+
+
+
+</details>
+
+### Dependencies and configuration
+
+Sometimes it is necessary to install additional dependencies to and modify the configuration of an upstream project to deploy on Platform.sh. 
+When it is, we do our best to keep these modifications to the minimum necessary. 
+Run the commands below to reproduce the dependencies in this template. 
+
+
+
+```bash
+$ composer require platformsh/config-reader drush/drush:^9.1 drupal/console drupal/redis psr/cache:^1.0
+$ composer config allow-plugins.composer/installers true --no-plugins
+$ composer config allow-plugins.drupal/core-composer-scaffold true --no-plugins
+$ composer config allow-plugins.drupal/core-project-message true --no-plugins
+$ composer config allow-plugins.cweagans/composer-patches true --no-plugins 
+
+```
+
+
+
+### Deploying to Platform.sh
+
+Your repository now has all of the code it needs in order to deploy to Platform.sh. 
+
+
+<details>
+<summary>Deploy directly to Platform.sh from the command line</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
+
+1. Install the Platform.sh CLI
 
-## Customizations
+   #### Linux/OSX
 
-The following changes have been made relative to Drupal 8 / Opigno as it is downloaded from Drupal.org.  If using this project as a reference for your own existing project, replicate the changes below to your project.
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
 
-* It uses the Drupal Composer project, which allow the site to be managed entirely with Composer. That also causes the `vendor` and `config` directories to be placed outside of the web root for added security.  See the [Drupal documentation](https://www.drupal.org/node/2404989) for tips on how best to leverage Composer with Drupal 8.
-* The `.platform.app.yaml`, `.platform/services.yaml`, and `.platform/routes.yaml` files have been added.  These provide Platform.sh-specific configuration and are present in all projects on Platform.sh.  You may customize them as you see fit.
-* An additional Composer library, [`platformsh/config-reader`](https://github.com/platformsh/config-reader-php), has been added.  It provides convenience wrappers for accessing the Platform.sh environment variables.
-* A `.environment` file has been added, which allows executable app dependencies from Composer to be run from the path.
-* Drush and Drupal Console have been pre-included in `composer.json`.  You are free to remove one or both if you do not wish to use them.  (Note that the default cron and deploy hooks make use of Drush commands, however.)
-* The Drupal Redis module comes pre-installed.  The placeholder module is not pre-installed, but it is enabled via `settings.platformsh.php` out of the box.
-* The `settings.platformsh.php` file contains Platform.sh-specific code to map environment variables into Drupal configuration. You can add to it as needed. See the documentation for more examples of common snippets to include here.  It uses the Config Reader library.
-* The `settings.php` file has been heavily customized to only define those values needed for both Platform.sh and local development.  It calls out to `settings.platformsh.php` if available.  You can add additional values as documented in `default.settings.php` as desired.  It is also setup such that when you install Drupal on Platform.sh the installer will not ask for database credentials as they will already be defined.
+   #### Windows
 
-## References
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
+
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Set the project remote
+
+   Find your `PROJECT_ID` by running the command `platform project:list` 
+
+   ```bash
+   +---------------+------------------------------------+------------------+---------------------------------+
+   | ID            | Title                              | Region           | Organization                    |
+   +---------------+------------------------------------+------------------+---------------------------------+
+   | PROJECT_ID    | Your Project Name                  | xx-5.platform.sh | your-username                   |
+   +---------------+------------------------------------+------------------+---------------------------------+
+   ```
+
+   Then from within your local copy, run the command `platform project:set-remote PROJECT_ID`.
+
+1. Push
+
+   ```bash
+   git push platform DEFAULT_BRANCH
+   ```
+   
+<!-- <br/>
+</blockquote> -->
+</details>
+
+<details>
+<summary>Integrate with a GitHub repo and deploy pull requests</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to whatever you have set at `https://YOUR_NAMESPACE/nextjs-drupal`.
+
+1. Install the Platform.sh CLI
+
+   #### Linux/OSX
+
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
+
+   #### Windows
+
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
+
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Setup the integration:
+
+   Consult the [GitHub integration documentation](https://docs.platform.sh/integrations/source/github.html#setup) to finish connecting your repository to a project on Platform.sh. You will need to create an Access token on GitHub to do so.
+
+<!-- <br/>
+</blockquote> -->
+</details>
+
+<details>
+<summary>Integrate with a GitLab repo and deploy merge requests</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
+
+1. Install the Platform.sh CLI
+
+   #### Linux/OSX
+
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
+
+   #### Windows
+
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
+
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Create the repository
+
+   Create a new repository on GitLab, set it as a new remote for your local copy, and push to the default branch. 
+
+1. Setup the integration:
+
+   Consult the [GitLab integration documentation](https://docs.platform.sh/integrations/source/gitlab.html#setup) to finish connecting a repository to a project on Platform.sh. You will need to create an Access token on GitLab to do so.
+
+<!-- <br/>
+</blockquote> -->
+</details>
+
+<details>
+<summary>Integrate with a Bitbucket repo and deploy pull requests</summary>
+<!-- <blockquote>
+<br/> -->
+
+1. Create a free trial:
+
+   [Register for a 30 day free trial with Platform.sh](https://auth.api.platform.sh/register). When you have completed signup, select the **Create from scratch** project option. Give you project a name, and select a region where you would like it to be deployed. As for the *Production environment* option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
+
+1. Install the Platform.sh CLI
+
+   #### Linux/OSX
+
+   ```bash
+   curl -sS https://platform.sh/cli/installer | php
+   ```
+
+   #### Windows
+
+   ```bash
+   curl -f https://platform.sh/cli/installer -o cli-installer.php
+   php cli-installer.php
+   ```
+
+   You can verify the installation by logging in (`platformsh login`) and listing your projects (`platform project:list`).
+
+1. Create the repository
+
+   Create a new repository on Bitbucket, set it as a new remote for your local copy, and push to the default branch. 
+
+1. Setup the integration:
+
+   Consult the [Bitbucket integration documentation](https://docs.platform.sh/integrations/source/bitbucket.html#setup) to finish connecting a repository to a project on Platform.sh. You will need to create an Access token on Bitbucket to do so.
+
+<!-- <br/>
+</blockquote> -->
+</details>
+
+
+
+### Migrating your data
+
+
+If you are moving an existing site to Platform.sh, then in addition to code you also need to migrate your data. That means your database and your files.
+
+<details>
+<summary>Importing the database</summary><br/>
+
+First, obtain a database dump from your current site and save your dump file as `database.sql`. Then, import the database into your Platform.sh site using the CLI:
+
+```bash
+platform sql -e main < database.sql
+```
+
+</details>
+<details>
+<summary>Importing files</summary><br/>
+
+You first need to download your files from your current hosting environment. 
+The easiest way is likely with rsync, but consult your old host's documentation. 
+
+The `platform mount:upload` command provides a straightforward way to upload an entire directory to your site at once to a `mount` defined in a `.platform.app.yaml` file. 
+Under the hood, it uses an SSH tunnel and rsync, so it is as efficient as possible. 
+(There is also a `platform mount:download` command you can use to download files later.) 
+Run the following from your local Git repository root (modifying the `--source` path if needed and setting `BRANCH_NAME` to the branch you are using).
+
+A few examples are listed below, but repeat for all directories that contain data you would like to migrate.
+
+```bash
+$ platform mount:upload -e main --mount web/sites/default/files --source ./web/sites/default/files
+$ platform mount:upload -e main --mount private --source ./private
+```
+
+Note that `rsync` is picky about its trailing slashes, so be sure to include those.
+
+</details>
+
+
+
+### Next steps
+
+With your application now deployed on Platform.sh, things get more interesting. 
+Run the command `platform environment:branch new-feature` for your project, or open a trivial pull request off of your current branch. 
+
+The resulting environment is an *exact* copy of production.
+It contains identical infrastructure to what's been defined in your configuration files, and even includes data copied from your production environment in its services. 
+On this isolated environment, you're free to make any changes to your application you need to, and really test how they will behave on production. 
+
+After that, here are a collection of additional resources you might find interesting as you continue with your migration to Platform.sh:
+
+- [Local development](#local-development)
+- [Troubleshooting](#troubleshooting)
+- [Adding a domain and going live](https://docs.platform.sh/domains/steps.html)
+- [(CDN) Content Delivery Networks](https://docs.platform.sh/domains/cdn.html)
+- [Performance and observability with Blackfire.io](https://docs.platform.sh/integrations/observability/blackfire.html)
+- [Pricing](https://docs.platform.sh/overview/pricing.html)
+- [Security and compliance](https://docs.platform.sh/security.html)
+
+
+## Learn
+
+### Troubleshooting
+
+
+<details>
+<summary><strong>Accessing logs</strong></summary><br/>
+
+After the environment has finished its deployment, you can investigate issues that occured on startup, `deploy` and `post_deploy` hooks, and generally at runtime using the CLI. Run the command:
+
+```bash
+platform ssh
+```
+
+If you are running the command outside of a local copy of the project, you will need to include the `-p` (project) and/or `-e` (environment) flags as well. 
+Once you have connected to the container, [logs](https://docs.platform.sh/development/logs.html#container-logs) are available within `/var/log/` for you to investigate.
+
+</details>
+
+
+<details>
+<summary><strong>Rebuilding cache</strong></summary><br/>
+
+You may run into a database error after installing Drupal on your production environment initially.
+To fix, SSH into the application container (`platform ssh`) and rebuild the cache using Drush:
+
+```bash
+drush cache-rebuild
+```
+
+</details>
+
+
+<details>
+<summary><strong>Default <code>hash_salt</code> behavior</strong></summary><br/>
+
+Drupal's [default settings set](https://github.com/drupal/drupal/blob/9.3.x/core/assets/scaffold/files/default.settings.php#L252) `hash_salt` to an empty string:
+
+```php
+$settings['hash_salt'] = '';
+```
+
+In the past, Platform.sh templates have overridden this value:
+
+```php
+$settings['hash_salt'] = $settings['hash_salt'] ?? $platformsh->projectEntropy;
+```
+
+This setting was insufficient to cover some user configurations - such as those cases when an application depends on a `Null` value for `hash_salt`. 
+
+Now, the setting looks like this in `settings.platformsh.php`:
+
+```bash
+$settings['hash_salt'] = empty($settings['hash_salt']) ? $platformsh->projectEntropy : $settings['hash_salt'];
+```
+
+This change sets `hash_salt` to the built-in environment variable `PLATFORM_PROJECT_ENTROPY` value if the project contains the default settings OR `Null`. 
+If your application code *depends* on an empty value, feel free to comment out that line, or reset again later in that file.
+
+Feel free to visit [`platformsh-templates/drupal9#73`](https://github.com/platformsh-templates/drupal9/pull/73) for more details on this discussion.
+
+</details>
+
+
+
+
+### Blackfire.io: creating a Continuous Observability Strategy
+
+This template includes a starting [`.blackfire.yml`](.blackfire.yml) file that can be used to enable [Application Performance Monitoring](https://blackfire.io/docs/monitoring-cookbooks/index), [Profiling](https://blackfire.io/docs/profiling-cookbooks/index), [Builds](https://blackfire.io/docs/builds-cookbooks/index) and [Performance Testing](https://blackfire.io/docs/testing-cookbooks/index) on your project. Platform.sh comes with Blackfire pre-installed on application containers, and [setting up requires minimal configuration](https://docs.platform.sh/integrations/observability/blackfire.html). 
+
+* [What is Blackfire?](https://blackfire.io/docs/introduction)
+* [Configuring Blackfire.io on a Platform.sh project](https://docs.platform.sh/integrations/observability/blackfire.html)
+* [Blackfire.io Platform.sh documentation](https://blackfire.io/docs/integrations/paas/platformsh)
+* [Profiling Cookbooks](https://blackfire.io/docs/profiling-cookbooks/index)
+* [Monitoring Cookbooks](https://blackfire.io/docs/monitoring-cookbooks/index)
+* [Testing Cookbooks](https://blackfire.io/docs/testing-cookbooks/index)
+* [Using Builds](https://blackfire.io/docs/builds-cookbooks/index)
+* [Configuring Integrations](https://blackfire.io/docs/integrations/index)
+
+
+### Resources
+
+
+- [Opigno](https://www.opigno.org/)
+- [Drupal](https://www.drupal.org/)
+- [Drupal 8 on Platform.sh](https://docs.platform.sh/guides/drupal9/deploy.html)
+- [Platform.sh PHP documentation](https://docs.platform.sh/languages/php.html)
+
+
+
+### Contact
+
+This template is maintained by the Platform.sh Developer Relations team, and they will be notified of all issues and pull requests you open here.
+
+- **Community:** Share your question with the community, or see if it's already been asked on our [Community site](https://community.platform.sh).
+- **Slack:** If you haven't done so already, you can join Platform.sh's [public Slack](https://chat.platform.sh/) channels and ping the `@devrel_team` with any questions.
+
+
+### About Platform.sh
+
+This template has been specifically designed to deploy on Platform.sh.
+
+<details>
+<summary>What is Platform.sh?</summary><br/>
+
+Platform.sh is a unified, secure, enterprise-grade platform for building, running and scaling web applications. We’re the leader in Fleet Ops: Everything you need to manage your fleet of websites and apps is available from the start. Because infrastructure and workflows are handled from the start, apps just work, so teams can focus on what really matters: making faster changes, collaborating confidently, and scaling responsibly. Whether managing a fleet of ten or ten thousand sites and apps, Platform.sh is the Developer- preferred solution that scales right.
+
+Our key features include:
+
+* **GitOps: Git as the source of truth**
+
+    Every branch becomes a development environment, and nothing can change without a commit. 
+
+* **Batteries included: Managed infrastructure**
+
+    [Simple abstraction in YAML](https://docs.platform.sh/configuration/yaml.html) for [committing and configuring infrastructure](https://docs.platform.sh/overview/structure.html), fully managed patch updates, and 24 [runtimes](https://docs.platform.sh/languages.html) & [services](https://docs.platform.sh/configuration/services.html) that can be added with a single line of code.
+
+* **Instant cloning: Branch, merge, repeat**
+
+    [Reusable builds](https://docs.platform.sh/overview/build-deploy.html) and automatically inherited production data provide true staging environments - experiment in isolation, test, then destroy or merge.  
+
+* **FleetOps: Fleet management platform**
+
+    Leverage our public API along with custom tools like [Source Operations](https://docs.platform.sh/configuration/app/source-operations.html) and [Activity Scripts](https://docs.platform.sh/integrations/activity.html) to [manage thousands of applications](https://youtu.be/MILHG9OqhmE) - their dependency updates, fresh content, and upstream code. 
+
+
+To find out more, check out the demo below and go to our [website](https://platform.sh/product/).
+
+<br/>
+<p align="center">
+<a href="https://platform.sh/demo/"><img src="https://img.youtube.com/vi/ny2YeD6Qt3M/0.jpg" alt="The Platform.sh demo"></a>
+</p>
+
+
+</details>
+
+
+
+## Contribute
+
+<h3 align="center">Help us keep top-notch templates!</h3>
+
+Every one of our templates is open source, and they're important resources for users trying to deploy to Platform.sh for the first time or better understand the platform. They act as getting started guides, but also contain a number of helpful tips and best practices when working with certain languages and frameworks. 
+
+See something that's wrong with this template that needs to be fixed? Something in the documentation unclear or missing? Let us know!
+
+<p align="center">
+<strong>How to contribute</strong>
+<br /><br />
+<a href="https://github.com/platformsh-templates/drupal8-opigno/issues/new?assignees=&labels=bug&template=bug_report.yml"><strong>Report a bug</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="https://github.com/platformsh-templates/drupal8-opigno/issues/new?assignees=&labels=feature+request&template=improvements.yml"><strong>Submit a feature request</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="https://github.com/platformsh-templates/drupal8-opigno/pulls"><strong>Open a pull request</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<br />
+</p>
+<br />
+<p align="center">
+<strong>Need help?</strong>
+<br /><br />
+<a href="https://community.platform.sh"><strong>Ask the Platform.sh Community</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<a href="https://chat.platform.sh"><strong>Join us on Slack</strong></a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp
+<br />
+</p>
+<br />
+<h3 align="center"><strong>Thanks to all of our amazing contributors!</strong></h3>
+<br/>
+<p align="center">
+<a href="https://github.com/platformsh-templates/drupal8-opigno/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=platformsh-templates/drupal8-opigno" />
+</a>
+</p>
+
+<p align="center">
+<em>Made with <a href="https://contrib.rocks">contrib.rocks</a><em>
+</p>
 
-* [Drupal](https://www.drupal.org/)
-* [Opigno](https://www.opigno.org)
-* [Drupal on Platform.sh](https://docs.platform.sh/frameworks/drupal8.html)
-* [PHP on Platform.sh](https://docs.platform.sh/languages/php.html)
+<br />
diff --git a/composer.json b/composer.json
index dd13bd6..a5ad306 100644
--- a/composer.json
+++ b/composer.json
@@ -1,126 +1,144 @@
 {
-    "name": "opigno/opigno-composer",
-    "description": "Opigno LMS",
-    "type": "project",
-    "license": "GPL-2.0-or-later",
-    "authors": [
-        {
-            "name": "",
-            "role": ""
+  "name": "platformsh/drupal8-opigno",
+  "description": "This template builds the Opigno Drupal 8 distribution using the \"Drupal Recommended\" Composer project.",
+  "type": "project",
+  "license": "GPL-2.0-or-later",
+  "authors": [
+    {
+      "name": "",
+      "role": ""
+    }
+  ],
+  "repositories": [
+    {
+      "type": "composer",
+      "url": "https://packages.drupal.org/8"
+    },
+    {
+      "type": "composer",
+      "url": "https://asset-packagist.org"
+    },
+    {
+      "type": "package",
+      "package": {
+        "name": "enyo/dropzone",
+        "version": "v5.5.0",
+        "type": "drupal-library",
+        "source": {
+          "url": "https://github.com/enyo/dropzone.git",
+          "type": "git",
+          "reference": "v5.5.0"
         }
-    ],
-    "repositories": [
-        {
-            "type": "composer",
-            "url": "https://packages.drupal.org/8"
-        },
-        {
-            "type": "composer",
-            "url": "https://asset-packagist.org"
-        },
-        {
-            "type": "package",
-            "package": {
-                "name": "enyo/dropzone",
-                "version": "v5.5.0",
-                "type": "drupal-library",
-                "source": {
-                    "url": "https://github.com/enyo/dropzone.git",
-                    "type": "git",
-                    "reference": "v5.5.0"
-                }
-            }
-        },
-        {
-            "type": "package",
-            "package": {
-                "name": "mozilla/pdf.js",
-                "version": "dev-master",
-                "type": "drupal-library",
-                "dist": {
-                    "url": "https://github.com/mozilla/pdf.js/releases/download/v2.4.456/pdfjs-2.4.456-es5-dist.zip",
-                    "type": "zip"
-                }
-            }
-        },
-        {
-            "type": "package",
-            "package": {
-                "name": "almende/vis",
-                "version": "v4.21.0",
-                "type": "drupal-library",
-                "source": {
-                    "url": "https://github.com/almende/vis.git",
-                    "type": "git",
-                    "reference": "v4.21.0"
-                }
-            }
-        },
-        {
-            "type": "package",
-            "package": {
-                "name": "kenwheeler/slick",
-                "version": "1.8.1",
-                "type": "drupal-library",
-                "dist": {
-                    "url": "https://github.com/kenwheeler/slick/archive/v1.8.1.zip",
-                    "type": "zip"
-                }
-            }
+      }
+    },
+    {
+      "type": "package",
+      "package": {
+        "name": "mozilla/pdf.js",
+        "version": "dev-master",
+        "type": "drupal-library",
+        "dist": {
+          "url": "https://github.com/mozilla/pdf.js/releases/download/v2.4.456/pdfjs-2.4.456-es5-dist.zip",
+          "type": "zip"
         }
-    ],
-    "require": {
-        "php": ">=7.1.0",
-        "composer/installers": "^1.7",
-        "cweagans/composer-patches": "^1.6",
-        "drupal/calendar": "1.x-dev#1824fdc",
-        "drupal/console": "^1.9",
-        "drupal/core-composer-scaffold": "^8.8",
-        "drupal/core-project-message": "^8.8",
-        "drupal/media_entity_browser": "2.x-dev#31fdf95",
-        "drupal/pdf": "1.x-dev#1e33fbf",
-        "drupal/private_message": "2.x-dev#0d76aa9",
-        "drupal/redis": "^1.5",
-        "drush/drush": "^9.1",
-        "opigno/opigno_lms": "2.29",
-        "platformsh/config-reader": "^2.4",
-        "psr/cache": "^1.0",
-        "wikimedia/composer-merge-plugin": "dev-master"
+      }
     },
-    "replace": {
-        "h5p/h5p-core": "*",
-        "h5p/h5p-editor": "*"
+    {
+      "type": "package",
+      "package": {
+        "name": "almende/vis",
+        "version": "v4.21.0",
+        "type": "drupal-library",
+        "source": {
+          "url": "https://github.com/almende/vis.git",
+          "type": "git",
+          "reference": "v4.21.0"
+        }
+      }
     },
-    "config": {
-        "sort-packages": true,
-        "preferred-install": {
-            "drupal/calendar": "source",
-            "*": "dist"
+    {
+      "type": "package",
+      "package": {
+        "name": "kenwheeler/slick",
+        "version": "1.8.1",
+        "type": "drupal-library",
+        "dist": {
+          "url": "https://github.com/kenwheeler/slick/archive/v1.8.1.zip",
+          "type": "zip"
         }
+      }
+    }
+  ],
+  "require": {
+    "php": ">=7.1.0",
+    "composer/installers": "^1.7",
+    "cweagans/composer-patches": "^1.6",
+    "drupal/calendar": "1.x-dev#1824fdc",
+    "drupal/console": "^1.9",
+    "drupal/core-composer-scaffold": "^8.8",
+    "drupal/core-project-message": "^8.8",
+    "drupal/media_entity_browser": "2.x-dev#31fdf95",
+    "drupal/pdf": "1.x-dev#1e33fbf",
+    "drupal/private_message": "2.x-dev#0d76aa9",
+    "drupal/redis": "^1.5",
+    "drush/drush": "^9.1",
+    "opigno/opigno_lms": "2.29",
+    "platformsh/config-reader": "^2.4",
+    "psr/cache": "^1.0",
+    "wikimedia/composer-merge-plugin": "dev-master"
+  },
+  "replace": {
+    "h5p/h5p-core": "*",
+    "h5p/h5p-editor": "*"
+  },
+  "config": {
+    "sort-packages": true,
+    "preferred-install": {
+      "drupal/calendar": "source",
+      "*": "dist"
+    },
+    "allow-plugins": {
+      "composer/installers": true,
+      "drupal/core-composer-scaffold": true,
+      "drupal/core-project-message": true,
+      "cweagans/composer-patches": true
+    }
+  },
+  "conflict": {
+    "drupal/drupal": "*"
+  },
+  "minimum-stability": "dev",
+  "prefer-stable": true,
+  "extra": {
+    "installer-paths": {
+      "web/core": [
+        "type:drupal-core"
+      ],
+      "web/libraries/{$name}": [
+        "type:drupal-library"
+      ],
+      "web/modules/contrib/{$name}": [
+        "type:drupal-module"
+      ],
+      "web/profiles/contrib/{$name}": [
+        "type:drupal-profile"
+      ],
+      "web/themes/contrib/{$name}": [
+        "type:drupal-theme"
+      ],
+      "drush/Commands/{$name}": [
+        "type:drupal-drush"
+      ]
     },
-    "conflict": {
-        "drupal/drupal": "*"
+    "drupal-scaffold": {
+      "locations": {
+        "web-root": "web/"
+      }
     },
-    "minimum-stability": "dev",
-    "prefer-stable": true,
-    "extra": {
-        "installer-paths": {
-            "web/core":                     ["type:drupal-core"],
-            "web/libraries/{$name}":        ["type:drupal-library"],
-            "web/modules/contrib/{$name}":  ["type:drupal-module"],
-            "web/profiles/contrib/{$name}": ["type:drupal-profile"],
-            "web/themes/contrib/{$name}":   ["type:drupal-theme"],
-            "drush/Commands/{$name}":       ["type:drupal-drush"]
-        },
-        "drupal-scaffold": {
-            "locations": {
-                "web-root": "web/"
-            }
-        },
-        "enable-patching": true,
-        "composer-exit-on-patch-failure": false,
-        "patchLevel": {
-            "drupal/core": "-p2"
-        }
+    "enable-patching": true,
+    "composer-exit-on-patch-failure": false,
+    "patchLevel": {
+      "drupal/core": "-p2"
     }
+  }
 }
diff --git a/composer.lock b/composer.lock
index 10eb404..4d26099 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
         "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
         "This file is @generated automatically"
     ],
-    "content-hash": "6e4f9af456ccd99ba75ccb259b387b8b",
+    "content-hash": "0ca1a113eab911f8e33553a593619d10",
     "packages": [
         {
             "name": "alchemy/zippy",
@@ -14170,5 +14170,5 @@
         "php": ">=7.1.0"
     },
     "platform-dev": [],
-    "plugin-api-version": "2.3.0"
+    "plugin-api-version": "2.2.0"
 }
diff --git a/drush/platformsh_generate_drush_yml.php b/drush/platformsh_generate_drush_yml.php
index 19f0955..9dbb98c 100644
--- a/drush/platformsh_generate_drush_yml.php
+++ b/drush/platformsh_generate_drush_yml.php
@@ -31,7 +31,7 @@ function _platformsh_drush_site_url() {
     return
       [!$a['primary'], strpos($a['url'], 'https://') !== 0, strlen($a['url'])]
       <=>
-      [!$a['primary'], strpos($a['url'], 'https://') !== 0, strlen($b['url'])];
+      [!$b['primary'], strpos($b['url'], 'https://') !== 0, strlen($b['url'])];
   });
 
   // Return the url of the first one.
diff --git a/header.svg b/header.svg
new file mode 100644
index 0000000..957dab1
--- /dev/null
+++ b/header.svg
@@ -0,0 +1,5 @@
+
+<svg xmlns="http://www.w3.org/2000/svg" width="1080" height="250">
+<rect x="0" y="0" width="1080" height="250" fill="#f4f2f3"/>
+<image href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='225' height='223.8'%3E%3Cdefs%3E%3Cstyle%3E.cls-1%7Bfill:%230e1226;fill-rule:evenodd%7D%3C/style%3E%3C/defs%3E%3Cg %3E%3Cg %3E%3Cpath class='cls-1' d='M207.15 51.16a112.6 112.6 0 0 0-30.84-31.52 52.78 52.78 0 0 0 30.84 31.52M48.83 113.21a63.81 63.81 0 1 0 126.36-12.53 113.13 113.13 0 0 1-14.25-8.58 52 52 0 0 1 4.46 21.11 52.68 52.68 0 1 1-31.35-47.95 111 111 0 0 1-8.57-14.21 65.09 65.09 0 0 0-12.84-1.28 63.58 63.58 0 0 0-63.8 63.43'/%3E%3Cpath class='cls-1' d='M185.35 64c14.64 10.1 33.7 11.51 33.7 11.51l-4.4-10.85C167.15 53.74 163 11.84 163 11.84c-1.67-1.28-12-5.16-12-5.16-.07 5.41 2.53 14.34 2.53 14.34 7.74 28.77 31.84 42.87 31.84 42.87m27.42 48a98.29 98.29 0 0 1-.53 10.15v.14l-.6 4.7-2.06 9.88-.19.71-1.09 3.8-.57 1.73-.91 2.66-1 2.56-.68 1.71-1.4 3.18-.47 1-1.66 3.33-.43.84-1.85 3.31-.53.89-1.9 3.06-.69 1.06-1.88 2.72-.93 1.29-1.8 2.34-1.28 1.53-1.64 1.95-1.57 1.79-1.45 1.56-1.64 1.7-.4.41-1.14 1.12-1.58 1.49-1 .91-.81.72-1.45 1.24-2.1 1.7-1.25 1-2.18 1.67-.34.26-1 .68-2.72 1.88-.32.22-.61.38-3.13 2-.51.31-3.59 2-.84.44-3.32 1.66-1.32.61-2.89 1.28-2 .83-2.25.87-3 1.05-1.36.45-4.23 1.23-.32.09-9.95 2.1-5.18.68-3 .24-2.38.18h-1.1l-4.2.1q-5 0-10.07-.5l-5.08-.64c-3.34-.51-6.62-1.17-9.81-1.91l-1-.26-3.6-1-1.95-.64-2.46-.83-2.79-1.06-1.52-.61-3.29-1.42-.27-.13-.64-.29-4.24-2.09-3.38-1.9-.83-.48-3.21-1.93-1-.64-2.78-1.92-1.25-.88-2.4-1.79-1.52-1.19-2-1.65-1.79-1.52-1.58-1.46-1.76-1.66-.34-.32-1.16-1.16-1.54-1.6-.72-.86-.72-.82-1.29-1.47-1.32-1.54-.42-.52-1-1.26-1.67-2.16-.23-.32-.64-1-1.9-2.71-.2-.29-.47-.6-1.93-3.16-.27-.44-2.06-3.65-.39-.75-1.72-3.39-.56-1.2-1.28-3-.79-1.92-.92-2.37-1-2.85-.52-1.52-1.17-4-.14-.54a98.08 98.08 0 0 1-2.1-9.84l-.59-4.4-.1-.79-.19-2.64-.2-2.66v-.78l-.11-4.45.32-7.58.83-7.48 2-9.85.14-.52 1.16-4 .5-1.54 1-2.86.9-2.38.77-1.92 1.32-3 .56-1.28 1.57-3.17.45-.9 2.42-4.23 1.82-2.92.78-1.21L31 54.47l1-1.42 1.68-2.2 1.32-1.7 1.51-1.79 1.73-2 1.3-1.36 1.57-1.65.68-.69.92-.89 1.52-1.45 1.27-1.18.54-.49 1.4-1.2 1.9-1.62.25-.19 1.18-.92 2.53-1.94.93-.65 3.1-2.13.51-.32 3.57-2.24.16-.09 4-2.23.39-.21L69.69 22l.83-.38 3.38-1.49 1.54-.62 2.76-1.07 2.46-.85 1.94-.64 3.58-1 1-.27c3.2-.83 6.46-1.53 9.79-2.06l1.46-.19a98.5 98.5 0 0 1 14.36-1.05h1.47a97.81 97.81 0 0 1 12.57 1c3.36 27.9 16.92 44 16.92 44C164.89 88.19 195.2 97 212.07 99.51a97.12 97.12 0 0 1 .81 12.52m11.8-11.51c.19-1.86-2.08-12.83-2.08-12.83-83.34-9-83.76-84.62-83.76-84.62-1.8-.51-5.36-1.12-8.35-1.58a7.36 7.36 0 0 0-.88-.21c-1-.14-1.9-.24-2.86-.36l-.88-.13A113.5 113.5 0 0 0 90 2.24l-1.09.26-4.17 1-1.12.3-.3.08-3.79 1.02-1.25.4-3 1-.87.29-1.28.47c-.64.24-1.28.52-1.93.76l-1.57.62-.22.08-1.27.53c-.9.39-1.76.79-2.57 1.19l-2.21 1c-1.07.52-2.12 1.06-3.18 1.61-.15.09-.31.16-.45.24l-1.1.64c-1.17.64-2.32 1.3-3.47 2l-.17.1-1 .64c-1.16.71-2.3 1.44-3.43 2.18l-.23.16-.86.56q-1.63 1.11-3.24 2.28l-.42.3-.81.45c-1 .74-2 1.5-2.93 2.27l-.68.54-.68.55c-.86.71-1.71 1.43-2.54 2.18l-1 .85-.62.56-2.14 2-1.84 1.88L30.91 35l-1.51 1.6-.59.67-1.3 1.47-1.71 1.89c-.13.17-.26.34-.41.52l-1.13 1.4-1.83 2.34-.23.32-.51.64-.55.77-1.93 2.56-.21.32-.9 1.38-1.8 2.8-.34.6-.36.61a4.89 4.89 0 0 0-.34.64l-1.63 2.85-.63 1.2-.43.82-1.4 2.72c-.21.42-.39.86-.59 1.28L8.94 68c-.19.42-.36.86-.53 1.3L7 73l-.5 1.27-.65 1.92-1 3.19L4.08 82l-.69 2.54c-.3 1.15-.55 2.3-.8 3.46l-.39 1.72c-.3 1.48-.56 3-.79 4.46l-.15.82q-.42 2.7-.7 5.41c-.34 3.33-.51 6.67-.56 10v3.45a111.42 111.42 0 0 0 2.3 20.44c0 .12.07.23.09.36.34 1.63.71 3.26 1.13 4.87l.31 1.12.38 1.35.79 2.68c.13.42.26.82.41 1.23s.19.56.28.83l1 3 .47 1.26.66 1.66.55 1.34c.1.21.17.44.26.66l.53 1.34c.35.81.73 1.6 1.09 2.4l.64 1.25.65 1.18c.48 1 1 2 1.51 2.94l.17.32c.06.13.13.24.19.36l.64 1.08c.6 1.09 1.29 2.15 1.85 3.2l.26.43.64 1c.66 1.06 1.34 2.12 2 3.16l.32.47.65.86c.69 1 1.4 2 2.13 3l.46.64.64.71c.69.91 1.4 1.81 2.12 2.7l.64.89.56.68c.66.78 1.33 1.56 2 2.33l1 1.16.65.62 1.82 1.92 1.41 1.44c.19.21.4.4.61.6l1.57 1.5 1.79 1.69.55.47c.06.07.13.1.19.16l1.29 1.07 2.19 1.87.22.17 1.51 1.2c1.21.95 2.43 1.88 3.68 2.78l.43.32c1.29 1 2.72 1.91 4.11 2.82l.24.15 3 1.93c.06.05.14.08.21.13.36.22.74.42 1.1.64l.24.14 3.1 1.76.82.43 1 .49 3 1.52c.43.2.87.38 1.3.59l.9.41 2.7 1.28c.44.19.89.35 1.32.53s.82.32 1.29.48l1.44.56 1 .41 1.31.45 1.66.56 3.39 1.1c.79.23 1.57.45 2.36.66l2.79.76c1.07.27 2.15.5 3.21.74l2 .45c1.4.28 2.8.51 4.21.75l1.14.19c1.72.25 3.44.47 5.16.65h.32c1.8.19 3.62.32 5.43.41h.48c1.18.06 2.36.06 3.54.08l2 .11h1.44a112 112 0 0 0 20.67-2.22l.68-.14c1.52-.32 3-.66 4.49-1 .41-.1.81-.22 1.28-.33l3.92-1.1c.43-.12.86-.27 1.28-.43l.86-.28 2.85-1 1.4-.52 1.66-.65 1.29-.5.63-.25 1.37-.64a22.27 22.27 0 0 0 2.41-1.08l.83-.37.29-.13 1.29-.61c1-.49 2-1 3-1.51a1.91 1.91 0 0 1 .32-.16l.22-.11 1.19-.64c1.1-.6 2.19-1.23 3.21-1.92l.25-.15 1.08-.64c1.11-.67 2.19-1.37 3.21-2.07l1.28-.79c1.06-.72 2.1-1.45 3.14-2.2l1.24-.9c1-.73 1.92-1.47 2.89-2.23l.62-.5.76-.61c.86-.64 1.7-1.43 2.54-2.16l.9-.78.68-.62c.73-.65 1.45-1.27 2.16-2l1.16-1.11.65-.65 1.77-1.8 1.39-1.47.64-.64 1.38-1.55 1.58-1.82.61-.76 1.07-1.32 1.7-2.14.45-.61 1-1.28 1.72-2.4c.15-.21.28-.43.42-.64l.34-.52.52-.76 1.65-2.57c.19-.3.35-.6.53-.9l.2-.32.45-.77 1.52-2.55q.34-.63.66-1.26l.51-.94 1.29-2.51.63-1.28.59-1.28 1-2.21.64-1.37c.22-.51.42-1 .62-1.53l.52-1.28c.09-.26.2-.51.3-.76l.49-1.27.68-1.92 1-3 .76-2.61.64-2.55c.29-1.13.55-2.26.81-3.39l.41-1.79c.29-1.43.56-2.87.8-4.31l.17-1c.28-1.71.5-3.44.64-5.11a2.4 2.4 0 0 1 0-.24 111.41 111.41 0 0 0 .06-23.67m-36.74 5.67.25 5.79c0 41.37-33.73 74.9-75.34 74.9a75.22 75.22 0 0 1-75.26-75.1C37.31 70.52 71 37 112.64 37c2.34 0 4.69.12 7 .34a111.18 111.18 0 0 1-3.45-12.14c-1.19-.05-2.38-.09-3.58-.09-48.15 0-87.3 38.86-87.3 86.79s39.08 86.79 87.3 86.79 87.24-38.81 87.3-86.79c0-.73 0-1.47-.07-2.2a114.09 114.09 0 0 1-12.14-3.58'/%3E%3C/g%3E%3C/g%3E%3C/svg%3E" x="50%" y="50%" height="150" transform="translate(-75.0, -75.0)"/>
+</svg>
diff --git a/php.ini b/php.ini
new file mode 100644
index 0000000..b731f31
--- /dev/null
+++ b/php.ini
@@ -0,0 +1,14 @@
+assert.active = Off
+display_errors = Off
+display_startup_errors = Off
+max_execution_time = 30
+session.use_strict_mode = On
+zend.detect_unicode = Off
+opcache.memory_consumption = 128
+opcache.interned_strings_buffer = 8
+opcache.max_accelerated_files = 4000
+opcache.revalidate_freq = 60
+opcache.fast_shutdown = 1
+opcache.enable_cli = 1
+realpath_cache_ttl = 3600
+session.gc_probability = 0
diff --git a/web/sites/default/settings.platformsh.php b/web/sites/default/settings.platformsh.php
index f181d83..62c9cbd 100644
--- a/web/sites/default/settings.platformsh.php
+++ b/web/sites/default/settings.platformsh.php
@@ -108,7 +108,7 @@
 
   // Set the project-specific entropy value, used for generating one-time
   // keys and such.
-  $settings['hash_salt'] = $settings['hash_salt'] ?? $platformsh->projectEntropy;
+  $settings['hash_salt'] = empty($settings['hash_salt']) ? $platformsh->projectEntropy : $settings['hash_salt'];
 
   // Set the deployment identifier, which is used by some Drupal cache systems.
   $settings['deployment_identifier'] = $settings['deployment_identifier'] ?? $platformsh->treeId;