fourkitchens / sous-drupal-project
Starter project for Sous a Drupal distribution featuring a theme based on Emulsify Design System.
Installs: 634
Dependents: 0
Suggesters: 0
Security: 0
Stars: 9
Watchers: 15
Forks: 6
Open Issues: 17
Type:project
Requires
- php: >=8.1
- composer/installers: ^1.2
- cweagans/composer-patches: ^1.6.5
- drupal/admin_toolbar: ^3.1
- drupal/allowed_formats: ^1.3
- drupal/blazy: ^2.1
- drupal/ckeditor_browser_context_menu: ^1.2
- drupal/components: ^3.0@beta
- drupal/config_direct_save: ^1.0
- drupal/content_browser: ^1.0
- drupal/core-composer-scaffold: ^9
- drupal/core-recommended: ^9
- drupal/crop: ^2.1
- drupal/ctools: ^4.0
- drupal/diff: ^1.0
- drupal/dropzonejs: ^2.5
- drupal/easy_breadcrumb: >=1.15 <3.0.0
- drupal/emulsify_twig: ^4.0
- drupal/entity_browser: ^2.2
- drupal/entity_browser_enhanced: ^1.0
- drupal/entity_embed: ^1.1
- drupal/entity_usage: ^2.0@beta
- drupal/field_group: ^3.1
- drupal/focal_point: ^1.5
- drupal/gin: ^3.0@alpha
- drupal/gin_toolbar: ^1.0@beta
- drupal/improve_line_breaks_filter: ^1.3
- drupal/inline_entity_form: ^1.0-rc11
- drupal/libraries: ^3.0
- drupal/linkit: ^6.0-beta3
- drupal/login_history: ^1.1
- drupal/menu_block: 1.x-dev
- drupal/metatag: 1.x-dev
- drupal/paragraphs: ^1.12
- drupal/paragraphs_collapsible: ^1.2
- drupal/paragraphs_ee: ^1.7
- drupal/paragraphs_features: ^1.11
- drupal/pathauto: ^1.8
- drupal/redirect: ^1.6
- drupal/role_delegation: 1.x-dev
- drupal/simple_sitemap: ^4.0@alpha
- drupal/slick_browser: 2.x-dev
- drupal/spamspan: ^1.2
- drupal/taxonomy_manager: ^2.0.4
- drupal/token: ^1.9
- drupal/twig_tweak: ^3.1
- drupal/views_ajax_history: ^1.6
- drush/drush: ^10.0
- npm-asset/blazy: ^1.8
- npm-asset/dropzone: ^5.5.1
- npm-asset/imagesloaded: ^3.2.0
- npm-asset/slick: ^1.12
- oomphinc/composer-installers-extender: ^2.0
- pantheon-systems/drupal-integrations: ^9.0
- vlucas/phpdotenv: ^2.4
- webflo/drupal-finder: ^1.0.0
- webmozart/path-util: ^2.3
- zaporylie/composer-drupal-optimizations: ^1.0
Requires (Dev)
- drupal/devel: ^4.1
- drupal/stage_file_proxy: ^1.1
- drupal/upgrade_rector: ^1.0@alpha
- drupal/upgrade_status: ^3.11
Conflicts
- dev-main
- 5.1.0
- 5.0.0
- 4.4.0
- 4.3.0
- 4.2.2
- 4.2.1
- 4.2.0
- 4.1.3
- 4.1.2
- 4.1.1
- 4.1.0
- 4.1.0-beta.1
- 4.0.1
- 4.0.0
- 3.0.0
- 2.2.2
- 2.2.1
- 2.2.0
- 2.1.0
- 2.0.1
- 2.0.0
- 1.1.0
- 1.0.0
- 0.0.1
- dev-issue-3339711--add-project-ci
- dev-3385967-nodesource-script
- dev-emulsify-base-theme
- dev-3377848-remove-media-entity
- dev-3368059-update-readme-steps
- dev-simplify-script-calls
- dev-3232909-enable-admin-block
- dev-3249228-remove-file-browser
- dev-dependabot/npm_and_yarn/yaml-and-semantic-release--removed
- dev-feat-readme-setup-and-demo
- dev-dependabot/npm_and_yarn/decode-uri-component-0.2.2
- dev-dependabot/npm_and_yarn/minimatch-3.1.2
- dev-remove-profile-legacy-modules
- dev-remove-profile-legacy-modules-timeout
- dev-recipe
- dev-add-theme-module-custom
- dev-fix-default-config-sync-dir
- dev-fix-readme
- dev-3232924-theme-install-broken
- dev-fix-remove-drupal-console
- dev-fix-oomphinc-allow-plugins
- dev-fix-sed-command-for-linux
- dev-beta
- dev-alpha
- dev-next
- dev-next-major
- dev-4.x-beta
- dev-npm-installer
- dev-4.x-beta-package-updates
- dev-docs-update
- dev-admin-gin2
- dev-image-update
- dev-pantheon-systems
- dev-update-php-74
- dev-admin-claro
- dev-fix-emulsify-theme-name
- dev-theme-build-path
- dev-8.x-1.x
This package is auto-updated.
Last update: 2023-09-22 21:37:45 UTC
README
Sous Project
A starter kit for your Drupal project that simplifies your project setup with Emulsify. This starter kit includes a small set of contrib modules, a bundle of basic configuration, and a starter theme generated by EmulsifyCLI.
Features and Configurations
Sous not only generates a custom theme based on Emulsify, it also builds upon Drupal's default configuration to help streamline the project setup process. See the feature set documentation here.
Installation
Requirements
Without these you will have difficulty installing this project.
Use this command below and replace PROJECT_NAME
with your chosen project name.
composer create-project fourkitchens/sous-drupal-project [PROJECT-NAME] --no-interaction
Tweak project
- Modify .gitignore
- Remove the commented block at the EOF
- Review ignored items you may need for your build and remove them
Optional Demo content and theme
Sous can optionally install some demo content and a fully styled and wired theme. Note: This should only be ran immediately after installation. It contains basic content type and media architecture changes and may affect custom configuration unexpectedly.
lando sous-demo-install
Working with Emulsify
The Emulsify theme is installed as part of this project.
Additional Tooling
This package provides some additional tooling to support the build.
Helper scripts
To use the helper script provided you will need to have npm
installed. Then just run npm run <command>
. For example: npm run import-data
. These commands are bash scripts located in the ./scripts/sous
directory and defined in package.json
.
Configuration management scripts
confex
npm run confex
Export active configuration to the config directory.
confim
npm run confim
Import the configuration to the database.
import-data
npm run import-data
Import a copy of the canonical database backup into your local instance. This assumes the database backup is located in ./reference/db.sql.gz
.
local-data-bak
npm run local-data-bak
Create a local database backup. Saves the backup to the ./reference
directory.
rebuild
npm run rebuild
Rebuild a fresh local instance of your site. Imports the canonical database backup and imports configuration into it.
setup
npm run setup
This is run during the installation process of composer create project.
theme-build
npm run theme-build
Builds the emulsify based theme.
theme-watch
npm run theme-watch
Used for theme development.
Semantic Versioning
Setup
- This repo has the following named/maintenance branches:
main
x.x
x.x.x
- These branches are protected on GitHub
- A personal access token was created for CircleCI.
- CircleCI was setup to run on this project and tag the releases
- Commit changes following the Conventional commit guidelines
- Push your change up and verify CircleCI passes and has run on your desired branch.
Troubleshooting
- Your branch must be a named stable release branch in order to get a tag.
- Prereleases are not supported with this package because they contain a dot.
Contributing
The composer command can be adjusted to account for a new branch you're working on.
composer create-project fourkitchens/sous-drupal-project:dev-[branch-name] PROJECT_NAME --no-interaction
Contribute without create-project
- clone repo
gh repo clone fourkitchens/sous-drupal-project [directory]
cd
to your project directory- change the name of your project in .lando.yml
lando start
lando composer install
composer run-script post-create-project-cmd
(Requires composer to be installed locally. i.e. outside lando)lando drush config-set system.theme default theme-name -y
(theme-name is the name of your project)
After running the above steps you should have a fully functioning Drupal site with a custom Emulsify theme named after your project.
Create a custom theme. (Change theme-name to your theme name.)
If you would like to generate another custom theme follow the steps below.
npm ci
npx emulsify init theme-name
lando drush config-set system.theme default theme-name -y