Atelier

Installing Atelier before the first release

Atelier has no tagged release yet, so composer require drupal/atelier
will not find it. Until one is cut, install it from the project's Git repository
using the steps below.

Two things are unusual about this, and both are temporary:

• Atelier does not install on Drupal CMS today.
• minimum-stability: dev is required.

So instead of adding Atelier to Drupal CMS, build a plain Drupal site and add
it there. These steps start from an empty directory and use
DDEV, which supplies PHP, MariaDB and Composer.

Requirements

• DDEV and Docker. Nothing else needs to be installed on your machine.

1. Create an empty Drupal project

mkdir atelier-site && cd atelier-site
ddev config --project-name=atelier-site --project-type=drupal11 --docroot=web --php-version=8.3
ddev start
ddev composer create-project drupal/recommended-project:^11

PHP 8.3 is deliberate: Drupal 11.4's SQLite driver throws on PHP 8.5. It makes
no difference under DDEV, which uses MariaDB, but it saves you a puzzling error
if you ever point the site at SQLite.

drupal/recommended-project already maps
type:drupal-recipe to recipes/{$name}, which is what
puts Atelier at recipes/atelier. Nothing to configure for that.

2. Point Composer at Atelier and require it

ddev composer config minimum-stability dev
ddev composer config repositories.atelier vcs https://git.drupalcode.org/project/atelier.git
ddev composer config --no-plugins allow-plugins.drupal/site_template_helper true
ddev composer config --json extra.drupal-recipe-unpack '{"ignore":["drupal/atelier"]}'
ddev composer require drupal/atelier:1.0.x-dev

Composer prints Generated atelier_theme theme for drupal/atelier.
when the shell theme is written. Confirm both halves landed:

test -f recipes/atelier/recipe.yml
test -f web/themes/atelier_theme/atelier_theme.info.yml

3. Install the site from the recipe

ddev drush site:install recipes/atelier -y ddev drush cron

ddev drush cron matters on a fresh site: automated_cron
is installed, so the first anonymous request would otherwise run a full cron.

Alternatively, run ddev launch /core/install.php and choose
Atelier from the list of site templates in the installer.

4. Log in and look around

ddev drush uli

That prints a one-time login link. Open it and you are in as administrator.
To open the site itself at any time, run ddev launch.