docs: update README.md with new layout and add provenance documentation for profile covers.

profile/README.md

@@ -1,40 +1,42 @@
-<!-- markdownlint-disable MD041 -->
-<div align="center">
+<!-- markdownlint-disable MD013 MD033 -->
+<h1>
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/php-forge/.github/main/profile/assets/php-forge-cover-dark.png">
+    <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/php-forge/.github/main/profile/assets/php-forge-cover-light.png">
+    <img src="https://raw.githubusercontent.com/php-forge/.github/main/profile/assets/php-forge-cover-light.png" alt="PHP Forge" width="1280">
+  </picture>
+</h1>
+<!-- markdownlint-enable MD013 MD033 -->
 
-# PHP Forge
+PHP tools for frontend assets, project scaffolding, and shared code-quality
+configuration.
 
-<strong>Code Craftsmanship for Reliability</strong>
+Bring these workflows into Composer-based projects, with each tool documented
+in its own repository. Read each repository's installation and compatibility
+notes before choosing a version.
 
-Foundational, framework-agnostic tools that power the next generation of PHP applications.
+## Documentation and contribution
 
-</div>
-<!-- markdownlint-disable MD041 -->
+Start with each repository's README, or explore the
+[independent documentation portal](https://yii2-framework.github.io/docs/).
 
----
+Read the
+[contribution guide](https://github.com/php-forge/.github/blob/main/CONTRIBUTING.md)
+before proposing a change. For security concerns, follow the
+[security policy](https://github.com/php-forge/.github/blob/main/SECURITY.md).
 
-## Philosophy
+## Related projects
 
-- **Zero Dependencies** -- Libraries that stand on their own.
-- **Battle Tested** -- 100% code coverage across all packages.
-- **Strict Standards** -- Strongly typed PHP with strict mode enabled.
+Explore [ui-awesome](https://github.com/ui-awesome),
+[yii2-extensions](https://github.com/yii2-extensions),
+[yii2-framework](https://github.com/yii2-framework), and
+[yii3](https://github.com/yii3).
 
-## Packages
+These are independent project collections. They and the documentation portal
+are not official Yii resources. For upstream Yii, visit
+[yiisoft](https://github.com/yiisoft).
 
-| Package                                                         | Description                                  |
-| --------------------------------------------------------------- | -------------------------------------------- |
-| [coding-standard](https://github.com/php-forge/coding-standard) | Coding standards for PHP projects.           |
-| [foxy](https://github.com/php-forge/foxy)                       | BUN/NPM/Yarn/PNPM bridge for Composer.       |
-| [helper](https://github.com/php-forge/helper)                   | Small, focused helpers for common PHP tasks. |
-| [support](https://github.com/php-forge/support)                 | Support utilities for enhanced testing.      |
+## Support this work
 
-## Part of the Ecosystem
-
-Maintained by the core team of [yii2-framework](https://github.com/yii2-framework) and [yii2-extensions](https://github.com/yii2-extensions).
-
----
-
-<div align="center">
-  <a href="https://github.com/sponsors/terabytesoftw">
-    <img src="https://img.shields.io/badge/Sponsor-Click%20Here-pink?style=for-the-badge&logo=github-sponsors" alt="Sponsor php-forge on GitHub" height="40" />
-  </a>
-</div>
+If this work is useful to you, consider
+[sponsoring @terabytesoftw on GitHub](https://github.com/sponsors/terabytesoftw).

profile/assets/PROVENANCE.md

@@ -0,0 +1,23 @@
+<!-- markdownlint-disable MD013 -->
+
+# PHP Forge cover provenance
+
+Prepared on 2026-11-03. `php-forge-cover-light.png` and `php-forge-cover-dark.png` are opaque PNG profile covers, each 1280 × 360 pixels. They contain the PHP Forge name and an artisan hammer resting on an anvil. The light and dark versions use the same composition with different backgrounds and text colors; neither has an orange rule.
+
+## Artwork and typography
+
+The hammer and anvil are generated supporting artwork, not an official emblem or a photograph of a real workshop. The selected Mjölnir-inspired scene was generated with the built-in image-generation tool. A subsequent image-model edit isolated the hammer and anvil on transparency and completed the cropped anvil. The edit is not an exact pixel cutout; details may differ from the initial scene. The transparent edited artwork used in the covers has SHA-256 `e43e16b0b1deb51ee97bb93855a17364a49ddb21398fda7c904a9c5d7380c086`.
+
+The organization name was added separately in Nimbus Sans Bold. No font binary is included in these assets. The artwork does not establish an affiliation with any fictional franchise or the creator of a particular depiction of Mjölnir.
+
+## Asset hashes
+
+- `php-forge-cover-light.png`: `5c06e086d02702425a7f2bb84d017b802c6cf665c04406414752d2a9d6bf0c6c` (152,676 bytes).
+- `php-forge-cover-dark.png`: `049752e9ce20ff81f1aa7215d04599a5c59d4e6e6c3d15c5115f820372af9b66` (147,370 bytes).
+
+The earlier `php-forge-cover.png` is preserved as a separate draft and is not one of the two theme covers. Its SHA-256 is `30c9028c83e8f3d26c77ef07495b37f836904abbf29ab0927aa7d057d86196fa` (13,498 bytes).
+
+The selected cover is unlinked and serves as the profile H1. Its alternative
+text carries the organization name; native profile text carries the scope and
+links. The covers do not configure an organization avatar or a repository
+social preview.