Tide Core

Core functionality of Tide distribution for Drupal 10

Tide is a Drupal 10 distribution focused on delivering an API first, headless Drupal content administration site.

What is in this package

• Roles
• Permissions for site administration
• Theme components discovery mechanism (if required)
• Text formats
• WYSIWYG configurations
• Common fields shared across content types
• Topic Taxonomy Vocabulary
• Tags Taxonomy Vocabulary
• Locations Taxonomy Vocabulary
• Departments Taxonomy Vocabulary

Installation

To install this package, add this custom repository to repositories section of your composer.json:

{
  "repositories": {        
      "dpc-sdp/tide_core": {
          "type": "vcs",
          "no-api": true,
          "url": "https://github.com/dpc-sdp/tide_core.git"
      }
  }
}

Require this package as any other Composer package:

composer require dpc/tide_core 

Support

Digital Engagement, Department of Premier and Cabinet, Victoria, Australia is a maintainer of this package.

Contribute

Open an issue on GitHub or submit a pull request with suggested changes.

Development and maintenance

Local development is powered by DDEV with the ddev-drupal-contrib add-on. The module repository is the project root; a disposable Drupal site is built into web/ and the module is made available to it via per-file symlinks — code changes at the repository root take effect immediately, no sync step required.

To build a fresh local development site in one step:

1. Checkout this project.
2. Run ddev build — removes the generated web/ and vendor/ directories, starts the services, installs the dependencies, symlinks the module and installs the site.

Alternatively, run each build step separately:

1. Run ddev start — starts web, db, OpenSearch, selenium-chrome and clamav services.
2. Run ddev poser — installs Drupal core (version pinned by DRUPAL_CORE in .ddev/config.yaml) plus all module dependencies into web/ and vendor/.
3. Run ddev symlink-project — symlinks this module into web/modules/custom/tide_core (re-run after adding/removing root-level files; also runs automatically on ddev start).
4. Run ddev install-site — installs a fresh site (testing profile) and enables tide_core and tide_test.

Day-to-day commands:

• ddev drush <command> — run Drush.
• ddev phpunit --testsuite unit — run PHPUnit unit tests.
• ddev exec vendor/bin/behat --strict --colors [path/to.feature] — run Behat tests (add --profile=suggest for the suggest profile).
• ddev phpcs / ddev phpcbf — lint / auto-fix coding standards.
• ddev ssh — shell into the web container.

Troubleshooting OpenSearch startup

If ddev start reports that the OpenSearch container exited or failed to become healthy, inspect its logs:

ddev logs -s opensearch

If the logs report that vm.max_map_count is too low:

ERROR: [1] bootstrap checks failed
[1]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]

Increase the limit and start DDEV again:

docker run --privileged --rm --pid=host alpine sysctl -w vm.max_map_count=262144
ddev start

The setting may need to be applied again after restarting Docker.

Related projects

• tide
• tide_api
• tide_event
• tide_landing_page
• tide_media
• tide_monsido
• tide_news
• tide_page
• tide_search
• tide_site
• tide_test
• tide_webform

License

This project is licensed under GPL2

Attribution

Single Digital Presence offers government agencies an open and flexible toolkit to build websites quickly and cost-effectively.

The Department of Premier and Cabinet partnered with Salsa Digital to deliver Single Digital Presence. As long-term supporters of open government approaches, they were integral to the establishment of SDP as an open source platform.