Skip to content

Commit 0cadee9

Browse files
committed
Add a README
1 parent 3be39c4 commit 0cadee9

File tree

1 file changed

+64
-0
lines changed

1 file changed

+64
-0
lines changed

README.md

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Drupal contrib starter project
2+
3+
## Prerequisites
4+
5+
* Composer
6+
* Docker / Docker compose
7+
* PhpStorm (optional)
8+
9+
## Getting started
10+
11+
To get started run the following command:
12+
13+
```
14+
composer create-project mstrelan/drupal-contrib:dev-main
15+
```
16+
17+
## Directory structure
18+
19+
* **app/** - this is the web root. The Drupal repo will be checked out here.
20+
* **assets/scaffold/files/** - files that will be copied to their destination with composer.
21+
* **bin/** - vendor binaries go here.
22+
* **src/** - scripts used by composer.
23+
* **vendor/** - composer vendor dir.
24+
25+
## Docker compose
26+
27+
Start the stack by running `docker-compose up` or `make start`.
28+
29+
You can override port numbers and other env vars by copying `.env.dist` to `.env`
30+
31+
The following services are available:
32+
33+
* **nginx** - the webserver
34+
* **php-fpm** - serves the Drupal site
35+
* **php-cli** - a CLI container for interacting with the Drupal site
36+
* **mysql** - an empty database container
37+
* **chrome** - for running webdriver tests
38+
39+
## Makefile targets
40+
41+
Make commands should be executed on the host machine.
42+
43+
* `clean` - runs composer install, installs minimal profile and provides a one-time login link
44+
* `start` - starts the stack
45+
* `stop` - stops the stack
46+
* `stop-php` - stops the php containers
47+
* `minimal` - installs Drupal with the minimal profile
48+
* `standard` - installs Drupal with the standard profile
49+
* `umami` - installs Drupal with the demo_umami profile
50+
* `login` - gets a one-time login link
51+
* `switch` - switches branch, e.g. `make BRANCH=9.3 switch`
52+
* `9.3|9.4|9.5|10.0|10.1` - provides a clean environment with the specified Drupal version
53+
* `php7.4|php8.0|php8.1` - starts with stack with the specified php version
54+
55+
## PhpStorm configuration
56+
57+
Upon first installation you'll be asked if you want to configure PhpStorm. This will configure
58+
a remote PHP interpreter, PHPUnit and path mappings for debugging.
59+
60+
## Running tests
61+
62+
## Debugging
63+
64+
## Contributing

0 commit comments

Comments
 (0)