release: theme-elementary v2

.env.local.example

@@ -0,0 +1,14 @@
+# Local site hostname (without protocol or trailing slash).
+# LocalWP: elementary.local, Lando: yoursite.lndo.site, wp-env: localhost, WP Studio: localhost
+WP_HOST=yoursite.local
+
+# BrowserSync port. Default: 3000. Change if port 3000 is already in use.
+# If you change this, also define ELEMENTARY_THEME_BROWSER_SYNC_URL in wp-config.php
+# so PHP enqueues the client script from the correct port.
+BS_PORT=3000
+
+# SSL cert paths — only needed when your local site runs on HTTPS.
+# LocalWP stores certs at:
+#   macOS:   ~/Library/Application Support/Local/run/router/nginx/certs/<domain>.key / .crt
+WP_SSL_KEY=/path/to/yoursite.local.key
+WP_SSL_CERT=/path/to/yoursite.local.crt

.github/actions/setup-node-with-cache/action.yml

@@ -0,0 +1,29 @@
+name: 'Setup Node with Cache'
+description: 'Sets up Node.js and caches node_modules'
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Setup Node
+      uses: actions/setup-node@v6.2.0
+      with:
+        node-version-file: '.nvmrc'
+
+    - name: Get node version
+      id: node
+      run: echo "version=$(node -v)" >> $GITHUB_OUTPUT
+      shell: bash
+
+    - name: Cache node_modules
+      id: node_modules
+      uses: actions/cache@v5.0.3
+      with:
+        path: '**/node_modules'
+        key: ${{ runner.os }}-node-modules-${{ hashFiles('**/package-lock.json', '**/.npmrc') }}-${{ steps.node.outputs.version }}
+
+    - name: Install Node dependencies
+      if: steps.node_modules.outputs.cache-hit != 'true'
+      run: npm ci --ignore-scripts
+      shell: bash
+      env:
+        CI: true

.github/workflows/test-measure.yml

@@ -22,11 +22,9 @@ jobs:
     name: 'Pre run'
     runs-on: ubuntu-latest
     outputs:
-      changed-file-count: ${{ steps.determine-file-counts.outputs.count }}
       changed-css-count: ${{ steps.determine-file-counts.outputs.css-count }}
       changed-js-count: ${{ steps.determine-file-counts.outputs.js-count }}
       changed-php-count: ${{ steps.determine-file-counts.outputs.php-count }}
-      changed-gha-workflow-count: ${{ steps.determine-file-counts.outputs.gha-workflow-count }}
 
     steps:
       - name: Checkout including last 2 commits
@@ -64,92 +62,84 @@ jobs:
           CSS_FILE_COUNT=$(node .github/bin/determine-modified-files-count.js ".+\.s?css|package\.json|package-lock\.json" "$MODIFIED_FILES")
           JS_FILE_COUNT=$(node .github/bin/determine-modified-files-count.js ".+\.(js|snap)|package\.json|package-lock\.json" "$MODIFIED_FILES")
           PHP_FILE_COUNT=$(node .github/bin/determine-modified-files-count.js ".+\.php|composer\.(json|lock)|phpstan\.neon\.dist" "$MODIFIED_FILES")
-          GHA_WORKFLOW_COUNT=$(node .github/bin/determine-modified-files-count.js "(\.github\/workflows\/.+\.yml)" "$MODIFIED_FILES")
+          GHA_WORKFLOW_COUNT=$(node .github/bin/determine-modified-files-count.js "(\.github\/(workflows|actions)\/.+\.yml)" "$MODIFIED_FILES")
 
           echo "Changed file count: $MODIFIED_FILES_DATA"
-          echo "Changed CK theme CSS file count: $CSS_FILE_COUNT"
-          echo "Changed CK theme JS file count: $JS_FILE_COUNT"
-          echo "Changed CK theme PHP file count: $PHP_FILE_COUNT"
-          echo "Changed GHA workflow count: $GHA_WORKFLOW_COUNT"
-
-          echo "::set-output name=count::$MODIFIED_FILES_DATA"
-          echo "::set-output name=css-count::$CSS_FILE_COUNT"
-          echo "::set-output name=js-count::$JS_FILE_COUNT"
-          echo "::set-output name=php-count::$PHP_FILE_COUNT"
-          echo "::set-output name=gha-workflow-count::$GHA_WORKFLOW_COUNT"
+          echo "Changed ${{ github.event.repository.name }} CSS file count: $CSS_FILE_COUNT"
+          echo "Changed ${{ github.event.repository.name }} JS file count: $JS_FILE_COUNT"
+          echo "Changed ${{ github.event.repository.name }} PHP file count: $PHP_FILE_COUNT"
+          echo "Changed GHA workflow/actions count: $GHA_WORKFLOW_COUNT"
+
+          echo "css-count=$CSS_FILE_COUNT" >> $GITHUB_OUTPUT
+          echo "js-count=$JS_FILE_COUNT" >> $GITHUB_OUTPUT
+          echo "php-count=$PHP_FILE_COUNT" >> $GITHUB_OUTPUT
         env:
           # Ignore Paths:
           # - .github/
           # - !.github/workflows
+          # - !.github/actions
           # - .wordpress-org/
           # - docs/
-          IGNORE_PATH_REGEX: \.github\/(?!workflows)|\.wordpress-org\/|docs\/
+          IGNORE_PATH_REGEX: \.github\/(?!workflows)(?!actions)|\.wordpress-org\/|docs\/
+
+      - name: Summarize skipped jobs
+        run: |
+          SKIPPED=()
+
+          [[ "${{ steps.determine-file-counts.outputs.css-count }}" -le 0 ]] && SKIPPED+=("lint-css")
+          [[ "${{ steps.determine-file-counts.outputs.js-count }}" -le 0 ]] && SKIPPED+=("lint-js" "unit-tests-js" "build-prod")
+          [[ "${{ steps.determine-file-counts.outputs.php-count }}" -le 0 ]] && SKIPPED+=("lint-php")
+
+          if [[ ${#SKIPPED[@]} -gt 0 ]]; then
+            echo "The following jobs will be skipped as no relevant files were changed:"
+            for JOB in "${SKIPPED[@]}"; do
+              echo "  - $JOB"
+            done
+          else
+            echo "All jobs will run."
+          fi
 
   lint-css:
     needs: pre-run
-    if: needs.pre-run.outputs.changed-css-count > 0 || needs.pre-run.outputs.changed-gha-workflow-count > 0
+    if: needs.pre-run.outputs.changed-css-count > 0
     name: 'Lint CSS'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Setup Node
-        uses: actions/setup-node@v6.2.0
-        with:
-          node-version-file: '.nvmrc'
-          cache: npm
-
-      - name: Install Node dependencies
-        run: npm ci --ignore-scripts
-        env:
-          CI: true
+      - name: Setup Node with cache
+        uses: ./.github/actions/setup-node-with-cache
 
       - name: Detect coding standard violations (stylelint)
         run: npm run lint:css
 
   lint-js:
     needs: pre-run
-    if: needs.pre-run.outputs.changed-js-count > 0 || needs.pre-run.outputs.changed-gha-workflow-count > 0
+    if: needs.pre-run.outputs.changed-js-count > 0
     name: 'Lint JS'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Setup Node
-        uses: actions/setup-node@v6.2.0
-        with:
-          node-version-file: '.nvmrc'
-          cache: npm
-
-      - name: Install Node dependencies
-        run: npm ci --ignore-scripts
-        env:
-          CI: true
+      - name: Setup Node with cache
+        uses: ./.github/actions/setup-node-with-cache
 
       - name: Detect coding standard violations (eslint)
         run: npm run lint:js
 
   unit-tests-js:
     needs: pre-run
-    if: needs.pre-run.outputs.changed-js-count > 0 || needs.pre-run.outputs.changed-gha-workflow-count > 0
+    if: needs.pre-run.outputs.changed-js-count > 0
     name: 'Run JS unit tests'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Setup Node
-        uses: actions/setup-node@v6.2.0
-        with:
-          node-version-file: '.nvmrc'
-          cache: npm
-
-      - name: Install Node dependencies
-        run: npm ci --ignore-scripts
-        env:
-          CI: true
+      - name: Setup Node with cache
+        uses: ./.github/actions/setup-node-with-cache
 
       - name: Run unit tests
         run: npm run test:js
@@ -158,7 +148,7 @@ jobs:
 
   lint-php:
     needs: pre-run
-    if: needs.pre-run.outputs.changed-php-count > 0 || needs.pre-run.outputs.changed-gha-workflow-count > 0
+    if: needs.pre-run.outputs.changed-php-count > 0
     name: 'Lint PHP'
     runs-on: ubuntu-latest
     steps:
@@ -171,10 +161,11 @@ jobs:
           php-version: '8.2'
           coverage: none
           tools: cs2pr
+          github-token: ${{ secrets.WP_FRAMEWORK_REPO_TEMP_TOKEN }}
 
       - name: Get Composer Cache Directory
         id: composer-cache
-        run: echo "::set-output name=dir::$(composer config cache-files-dir)"
+        run: echo "dir=$(composer config cache-files-dir)" >> $GITHUB_OUTPUT
 
       - name: Configure Composer cache
         uses: actions/cache@v5.0.3
@@ -183,6 +174,10 @@ jobs:
           key: ${{ runner.os }}-composer-${{ hashFiles('**/composer.lock') }}
           restore-keys: |
             ${{ runner.os }}-composer-
+
+      - name: Ensure git is installed
+        run: which git || (sudo apt-get update && sudo apt-get install -y git)
+
       - name: Install Composer dependencies
         run: composer install --prefer-dist --optimize-autoloader --no-progress --no-interaction --no-scripts
 
@@ -192,66 +187,41 @@ jobs:
       - name: Detect coding standard violations (PHPCS)
         run: vendor/bin/phpcs -q --report=checkstyle --runtime-set ignore_errors_on_exit 1 --runtime-set ignore_warnings_on_exit 1 | cs2pr --graceful-warnings
 
-  unit-test-php:
-    name: "PHP Unit test"
-    runs-on: ubuntu-latest
+  build-prod:
     needs: pre-run
+    if: needs.pre-run.outputs.changed-js-count > 0 || needs.pre-run.outputs.changed-css-count > 0
+    name: 'Build production'
+    runs-on: ubuntu-latest
     steps:
-      # Note: The repeated `needs.pre-run.outputs.changed-php-count > 0` checks would be avoided if a step could short-
-      # circuit per <https://github.com/actions/runner/issues/662>. The reason why the if statement can't be put on the
-      # job as a whole is because the name is variable based on the matrix, and if the condition is not met then the
-      # name won't be interpolated in order to match the required jobs set up in branch protection.
-      - name: Notice
-        if: needs.pre-run.outputs.changed-php-count > 0
-        run: echo "No PHP files were changed in CK theme so no PHP unit tests will run"
-
       - name: Checkout
-        if: needs.pre-run.outputs.changed-php-count > 0
         uses: actions/checkout@v6
 
-      - name: Setup Node
-        if: needs.pre-run.outputs.changed-php-count > 0
-        uses: actions/setup-node@v6.2.0
-        with:
-          node-version-file: '.nvmrc'
-          cache: npm
+      - name: Setup Node with cache
+        uses: ./.github/actions/setup-node-with-cache
 
-      - name: Install Node dependencies
-        if: needs.pre-run.outputs.changed-php-count > 0
-        run: npm ci --ignore-scripts
+      - name: Build production
+        id: build
+        run: npm run build:prod
         env:
           CI: true
 
-      - name: Start WP environment
-        if: needs.pre-run.outputs.changed-php-count > 0
-        run: npm run wp-env start
-
-      - name: Run tests
-        if: ${{ needs.pre-run.outputs.changed-php-count > 0 }}
-        run: npm run test:php
-
-  build-prod:
+  unit-test-php:
     needs: pre-run
-    if: needs.pre-run.outputs.changed-js-count > 0 || needs.pre-run.outputs.changed-gha-workflow-count > 0 || needs.pre-run.outputs.changed-css-count > 0
-    name: 'Build production'
+    if: needs.pre-run.outputs.changed-php-count > 0
+    name: 'PHP Unit test'
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v6
 
-      - name: Setup Node
-        uses: actions/setup-node@v6.2.0
-        with:
-          node-version-file: '.nvmrc'
-          cache: npm
+      - name: Setup Node with cache
+        uses: ./.github/actions/setup-node-with-cache
 
-      - name: Install Node dependencies
-        run: npm ci --ignore-scripts
-        env:
-          CI: true
+      - name: Start WP environment
+        run: npm run wp-env start
 
-      - name: Build production
-        id: build
-        run: npm run build:prod
-        env:
-          CI: true
+      - name: Configure Composer GitHub auth in wp-env
+        run: npx wp-env run cli -- composer config --global github-oauth.github.com "${{ secrets.WP_FRAMEWORK_REPO_TEMP_TOKEN }}"
+
+      - name: Run tests
+        run: npm run test:php

.gitignore

@@ -6,6 +6,7 @@
 # macOS/IDE
 .DS_Store
 .idea
+.vscode
 
 # Log files
 *.log
@@ -17,6 +18,7 @@
 
 # Enviroment
 .env
+.env.local
 .wp-env.override.json
 
 # Build
@@ -27,3 +29,6 @@ phpcs.xml
 
 # Cache
 .phpunit.result.cache
+
+# Tailwind theme
+_tailwind-theme.css

.stylelintignore

@@ -1,3 +1,4 @@
 /assets/build/*.css
 /tests
 /vendor
+**/*.md