Prepare v3.5.0 release

Author: Thavarshan

.github/SUPPORT.md

@@ -3,5 +3,5 @@
 GitHub issue trackers are not intended to provide help or support. Instead, use one of the following channels:
 
 - [Twitter](https://twitter.com/tjthavarshan)
-- [Github discussions](https://github.com/Thavarshan/fetch-php/issues)
-- [API reference](https://github.com/Thavarshan/fetch-php/wiki/API-Reference-for-the-Filter-Class)
+- [GitHub discussions](https://github.com/Thavarshan/fetch-php/discussions)
+- [API reference](https://fetch-php.thavarshan.com/api/)

.github/workflows/packages.yml

@@ -4,6 +4,7 @@ on:
   push:
     tags:
       - 'v*'
+      - '[0-9]*.[0-9]*.[0-9]*'
   release:
     types: [published]
 
@@ -14,7 +15,7 @@ permissions:
 jobs:
   validate-tag:
     runs-on: ubuntu-latest
-    if: startsWith(github.ref, 'refs/tags/v')
+    if: startsWith(github.ref, 'refs/tags/')
 
     outputs:
       version: ${{ steps.version.outputs.version }}
@@ -27,7 +28,8 @@ jobs:
       - name: Validate version tag
         id: version
         run: |
-          VERSION=${GITHUB_REF#refs/tags/v}
+          VERSION=${GITHUB_REF#refs/tags/}
+          VERSION=${VERSION#v}
           echo "version=$VERSION" >> $GITHUB_OUTPUT
 
           # Check if it's a pre-release (contains alpha, beta, rc)
@@ -45,16 +47,21 @@ jobs:
 
       - name: Check version matches composer.json
         run: |
-          COMPOSER_VERSION=$(php -r "echo json_decode(file_get_contents('composer.json'))->version;")
-          if [ "${{ steps.version.outputs.version }}" != "$COMPOSER_VERSION" ]; then
+          COMPOSER_VERSION=$(php -r '$composer = json_decode(file_get_contents("composer.json")); echo $composer->version ?? "";')
+
+          # Libraries published through Packagist usually derive the package
+          # version from the Git tag. composer.json intentionally omits
+          # "version" as of v3.4.1, so only enforce this check when a version
+          # field is explicitly present.
+          if [ -n "$COMPOSER_VERSION" ] && [ "${{ steps.version.outputs.version }}" != "$COMPOSER_VERSION" ]; then
             echo "Version mismatch: tag ${{ steps.version.outputs.version }} != composer.json $COMPOSER_VERSION"
             exit 1
           fi
 
   test-before-release:
     runs-on: ubuntu-latest
     needs: validate-tag
-    if: startsWith(github.ref, 'refs/tags/v')
+    if: startsWith(github.ref, 'refs/tags/')
 
     steps:
       - name: Checkout code
@@ -64,7 +71,7 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: '8.3'
-          extensions: curl, mbstring, json, openssl, gd
+          extensions: curl, mbstring, json, openssl, gd, pcntl, xml, dom, simplexml, tokenizer, intl
           coverage: none
           tools: composer:v2
 
@@ -73,11 +80,13 @@ jobs:
 
       - name: Run full test suite
         run: composer check
+        env:
+          NO_NETWORK: 1
 
   create-release:
     runs-on: ubuntu-latest
     needs: [validate-tag, test-before-release]
-    if: startsWith(github.ref, 'refs/tags/v')
+    if: startsWith(github.ref, 'refs/tags/')
 
     steps:
       - name: Checkout code
@@ -89,7 +98,7 @@ jobs:
         uses: shivammathur/setup-php@v2
         with:
           php-version: '8.3'
-          extensions: curl, mbstring, json, openssl, gd
+          extensions: curl, mbstring, json, openssl, gd, pcntl, xml, dom, simplexml, tokenizer, intl
           tools: composer:v2
 
       - name: Install dependencies
@@ -129,11 +138,11 @@ jobs:
   packagist-webhook:
     runs-on: ubuntu-latest
     needs: [validate-tag, create-release]
-    if: startsWith(github.ref, 'refs/tags/v') && needs.validate-tag.outputs.is_prerelease == 'false'
+    if: startsWith(github.ref, 'refs/tags/') && needs.validate-tag.outputs.is_prerelease == 'false'
 
     steps:
       - name: Update Packagist
         run: |
           curl -XPOST -H'content-type:application/json' \
             "https://packagist.org/api/update-package?username=${{ secrets.PACKAGIST_USERNAME }}&apiToken=${{ secrets.PACKAGIST_TOKEN }}" \
-            -d'{"repository":{"url":"https://github.com/${{ github.repository }}"}}'
+            -d'{"repository":{"url":"https://github.com/${{ github.repository }}"}}'

CHANGELOG.md

@@ -1,6 +1,25 @@
 # Release Notes
 
-## [Unreleased](https://github.com/Thavarshan/fetch-php/compare/v3.4.1...HEAD)
+## [Unreleased](https://github.com/Thavarshan/fetch-php/compare/3.5.0...HEAD)
+
+## [v3.5.0](https://github.com/Thavarshan/fetch-php/compare/3.4.1...3.5.0) - 2026-06-06
+
+### Added
+
+- Introduced a custom VitePress home page and shared docs theme components for a clearer first-run documentation experience.
+- Added lucide-powered feature icons and refreshed documentation examples around the JavaScript-style Fetch PHP API.
+
+### Changed
+
+- Updated Matrix helper imports throughout the README and documentation to consistently use the `Matrix\Support` namespace.
+- Refined homepage copy and feature descriptions to better explain Fetch PHP's JavaScript-like request flow, async helpers, caching, retries, debugging, and testing utilities.
+- Hardened the tag release workflow now that package versions are derived from Git tags instead of a `version` field in `composer.json`.
+- Expanded the tag release workflow setup to match package extension requirements and run the release test suite with `NO_NETWORK=1`.
+
+### Fixed
+
+- Corrected stale GitHub/support links in the installation guide and repository support metadata.
+- Removed a stale cache comment that referenced the old `ManagesCache` trait name.
 
 ## [v3.4.1](https://github.com/Thavarshan/fetch-php/compare/v3.4.0...v3.4.1) - 2025-12-14
 

docs/guide/installation.md

@@ -32,7 +32,7 @@ require __DIR__ . '/vendor/autoload.php';
 
 While we strongly recommend using Composer, you can also manually download the package and include it in your project:
 
-1. Download the latest release from [GitHub](https://github.com/jerome/fetch-php/releases)
+1. Download the latest release from [GitHub](https://github.com/Thavarshan/fetch-php/releases)
 2. Extract the files into your project directory
 3. Set up your own autoloading system or include files manually
 

src/Fetch/Cache/CacheControl.php

@@ -100,7 +100,7 @@ public function shouldCache(ResponseInterface $response, bool $isSharedCache = f
         }
 
         // Check response status code - using RFC 7234 recommended cacheable status codes
-        // This list matches the default cache_status_codes in ManagesCache trait
+        // This list matches CacheManager's default cache_status_codes option.
         $status = $response->getStatusCode();
         $cacheableStatuses = [200, 203, 204, 206, 300, 301, 404, 410];