README.md

DrupalPod

👉 Start here 1. Download the DrupalPod browser extension Chrome or Firefox. 2. Go to any issue page on Drupal.org (core, module, or theme). 3. Click on the DrupalPod extension. 4. (Optional) Choose a patch / issue fork / branch. 🎉 A full Drupal development environment is being generated for you 🎉 Please submit feedback, bug reports and feature requests

About the project

This project allows you to work on Drupal contributions with a familiar setup of a "normal" Drupal website.
No computer is needed because it is all running in the cloud.

• Install additional packages - ddev composer
• Run Drush commands - ddev drush <command>
• Run tests
  • Nightwatch - ddev nightwatch <arguments>
  • PHPUnit - ddev phpunit <arguments>
• IDE in a browser
  • VScode (default)
  • PHPStorm - run phpstorm

Project structure

• Every project is cloned into /repos/<project_name>
• Required by composer
• Symlinked into a normal Drupal website structure:
  • Core directory /web/core
  • Module directory /web/modules/contrib/module_name
  • Theme directory /web/themes/contrib/theme_name

The secret sauce

• Gitpod - development environment in the cloud
• Ddev - easy setup for PHP projects using Docker
• DrupalPod Browser Extension
• Drupal Core Development Project

Pushing code

* In order to push code, a one time SSH keys setup is required.

From within a Gitpod workspace run:

1. .gitpod/drupal/ssh/02-setup-private-ssh.sh
   Follow the instructions on the screen.

2. .gitpod/drupal/ssh/04-confirm-ssh-setup.sh
   If SSH keys are valid, it stores your private SSH key as an environment variable in Gitpod.

Notes

• Manual SSH setup is a temporary requirement until the Drupal's self-hosted Gitlab gets integrated with Gitpod.

  WIP - making a friendlier interactive dialog.

• If you prefer working locally - you can clone this repo to your computer.
  The only 2 requirements are Docker and Ddev.

Thank you

• Randy Fay
• Joe Still
• Joachim

---