# Usage

## Preparation

- [Install composer](https://getcomposer.org): `sudo wget https://getcomposer.org/composer.phar --output-document=/usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer`
- Disable XDebug for CLI - optional: `sudo phpdismod -s cli xdebug`
- [Install Prestissimo](https://github.com/hirak/prestissimo) - optional: `sudo composer global require "hirak/prestissimo:^0.3"`

## Create new project for local development

```
composer create-project lakedrops/d8-project [DIRNAME] --stability dev --no-interaction
```

This will build the full structure and create a git repository which you can then use during the full live-cycle of that project.

## Deploy project to upstream stages

For deployment, both initially and for later updates, follow this:

```
mkdir /PATH/TO/ROOT
cd /PATH/TO/ROOT
git clone YOUR-GIT-REPOSITORY .
composer install
```

Optionally you can also create all the scaffolds by using

```
composer drupal-scaffold
```

To manually update the theme components, if you're using the `lakedrops/theme-d8-sass` package and unintentionally changed one of the core file, then you can always run

```
composer drupal-theme-update
```

## Adding new and updating existing components

Edit the composer.json file accoring to your requirements and then run `composer update`.

# Links

[Using Composer to install Drupal packages through Drupal.org](https://www.drupal.org/node/2718229)

# Credit

[Composer template for Drupal projects](https://github.com/drupal-composer/drupal-project)