README

Paragon is a Drupal distribution focused on providing a clean starting point for site builds with just the right amount of baked in configuration.This allows developers to focus on building custom functionality, rather than recreating the same standard set of baseline features they’ve built 100 times before.

The intent of this distribution is to create a Drupal install that will be treated as an artifact and maintained independently of this project after the initial installation. As such, rather than making this an official install profile, Paragon is instead managed as a Composer template that heavily leverages drupal/core-composer-scaffold and also includes exported configuration that can be used to install the site.

Prerequisites

Lando: See Lando requirements.
Access to Elevated Third Github organization, Paragon-base repository and SSH key setup.
You must be using Composer 2.
- To install a specific version use this command and pass in the version constraing: composer self-update 2.0.7
- If you have already installed and need to switch to compsoer 2 run composer self-update --2.

Setup instructions

To create a new Paragon installation follow the steps below:

Step #1: Clone repository

Run the following command: composer create-project elevatedthird/paragon-base [install_directory_name] which will clone down the composer template and create all necessary files.

Step #2: Project setup

Set up a local site using this newly created site directory. Paragon comes with Lando out of the box, which can be spun up by running lando start in the site root. Lando configuration is found in .lando.yml , and database settings in settings.lando.php are automatically included in settings.php.

Step #3: Site setup

With a local site running, navigate to http://paragon.lndo.site/ (or whichever URL your local site is running on) and proceed with the Drupal installation. When prompted to select an installation profile be sure to select “Use existing configuration”, which will install from the existing configuration in the /config/default directory.

Step #4: Database setup

If using Lando, when prompted to add Drupal database connection details, use drupal9 for the database name, user, and password.

Step #5: Database setup

Once install completes, be sure to remove the automatically generated database connection details that have most likely been appended to the bottom of settings.php, then you should be all set!

Common commands

Some common commands that may be helpful

lando start/stop
lando rebuild - completely rebuilds the site and project containers. This is most useful if you keep running into lando issues
composer install

Xdebug Commands:

lando xdebug debug: Enables Step Debugging. This can be used to step through your code while it is running, and analyse values of variables.
lando xdebug: Turns off xdebug.
lando xdebug develop: Enables Development Helpers including the overloaded var_dump().
lando xdebug coverage: Enables Code Coverage Analysis to generate code coverage reports, mainly in combination with PHPUnit.
lando xdebug gcstats: Enables Garbage Collection Statistics to collect statistics about PHP's Garbage Collection Mechanism.
lando xdebug profile: EnableEnables Profiling, with which you can analyse performance bottlenecks with tools like KCacheGrind.
lando xdebug trace: Enables the Function Trace feature, which allows you record every function call, including arguments, variable assignment, and return value that is made during a request to a file. The most common xdebug commands are debug and off but these other modes are available as well.

elevatedthird / paragon-base

Maintainers

Details