A framework for demoing enterprise-ready Drupal solutions.

Maintainers

Details

github.com/acquia/df

Source

Issues

Installs: 17 925

Dependents: 1

Suggesters: 0

Security: 0

Stars: 15

Watchers: 11

Forks: 22

Open Issues: 28

Language:CSS

Type:drupal-profile

4.0.7 2020-06-24 18:30 UTC

README

Travis build status Scrutinizer Code Quality

Demo Framework is a distribution consisting of modules, themes and libraries. It highlights powerful features created by the Drupal community. It is intended to be used as a starterkit for promoting enterprise-ready solutions.

Demo Framework is powered by Lightning.

Installing Demo Framework

The preferred way to install Demo Framework is using our Composer-based project template. It's easy!

Once you have a docroot built, you can use DDev, Acquia Developer Studio or any other similar project to get started.

ddev config --project-name df --project-type drupal8 && ddev start

or

ads new webpsite

Now use the site-install command to install Drupal with the DF installation profile.

drush si

You may now login to your site.

drush uli

By default, you will be asked to select a demo scenario to install.

Install Demo

Installation may take a few minutes depending on your environment. ☕️

Deploying Demo Framework using version control

If you are using version control to deploy the Demo Framework to a server (such as Acquia Cloud), note that you must edit the file /profiles/df/.gitignore and remove the following lines:

# Contrib
modules/contrib/*
themes/contrib/*

# Libraries
libraries/*

If you do not do so, you will see an error in the installation referring to missing modules.

Using the Radix Sub Theme

To modify the CSS/JS you must use the scss files. You will find various different SCSS files in src/sass. You can override variables in src/sass/base/_variables.scss.

To compile scss you will need NPM (How To Install NPM) installed on your machine.

When you have NPM installed on your machine, you will need to run npm install to install the NPM packages. Once they are installed, you can run npm run dev to compile the scss files or run npm run production to compile and minify the scss files.

Running Tests

These instructions assume you have used Composer to install Lightning. Once you have it up and running, follow these steps to execute all of Lightning's Behat tests:

Behat

$ cd MYPROJECT
$ ./bin/drupal behat:init http://YOUR.DF.SITE --merge=../docroot/profiles/df/tests/behat.yml
$ ./bin/drupal behat:include ../docroot/profiles/df/tests/features --with-subcontexts=../docroot/profiles/df/tests/features/bootstrap --with-subcontexts=../docroot/profiles/df/src/DFExtension/Context --with-subcontexts=../docroot/profiles/lightning/src/LightningExtension/Context
$ ./bin/behat --config ./docroot/sites/default/files/behat.yml

If necessary, you can edit docroot/sites/default/files/behat.yml to match your environment, but generally you will not need to do this.

Resources

Please file issues in our drupal.org issue queue.