Setup.md

Starting a new Drupal 8 Project with WunderTools

Preparation

Start by downloading and unarchiving a zipball of the WunderTools as a base for your new project from https://github.com/wunderkraut/WunderTools/archive/master.zip

a) if you already have git repo

• Move the content (with dotfiles) of WunderTools-master into your git repo directory.
  • mv WunderTools-master/{.[!.],}* ~/Projects/my-existing-project/
    (works on OSX, but you should know how to copy if this is not a bulletproof one-liner on your system)

b) if you don't already have git

• Just rename WunderTools-master to whatever project folder you have and init git inside it:

mv WunderTools-master ~/Projects/my-new-project
cd ~/Projects/my-new-project
git init

Configure WunderTools

• Edit conf/vagrant.yml and change domain_name variable to match your local domain.

• Edit conf/vagrant_local.yml and change:

  • name to the name of your project
  • hostname to a good hostname for your local environment (preferably replace www part of your production domain with local)
  • ip to something that no other project in your company uses (increment the value by one and commit the new ip address to WunderTools repository)

• Edit conf/project.yml and change the variables to something that makes sense for your project.

  • Minimally project:name to the name of your project

• Edit conf/develop.yml and change the variables to something that makes sense for your project.

Configure Drupal build

• Edit drupal/conf/site.yml, remove things you don't need and add stuff you want in your project.
• Rename drupal/drush/wundertools.aliases.drushrc.php to drupal/drush/[PROJECT_NAME].aliases.drushrc.php and configure it to fit your setup.
  • this file will be automatically symlinked from ~/.drush when running vagrant up

Create new drupal installation

• Run ./build.sh create from inside the vagrant box from the /vagrant/drupal/ folder
• Add drupal scaffold files and relevant config export files to the repo