From 1a973557edaed212568cba2b8fc3c5d8f156c5ba Mon Sep 17 00:00:00 2001
From: Robin Malfait <malfait.robin@gmail.com>
Date: Fri, 20 Feb 2026 12:04:41 +0100
Subject: [PATCH] update webpack readme to be a bit more consistent with other
 readmes

---
 packages/@tailwindcss-webpack/README.md | 49 ++++++++++++++++++++++---
 1 file changed, 44 insertions(+), 5 deletions(-)

diff --git a/packages/@tailwindcss-webpack/README.md b/packages/@tailwindcss-webpack/README.md
index 183e42ee3..56484ed7f 100644
--- a/packages/@tailwindcss-webpack/README.md
+++ b/packages/@tailwindcss-webpack/README.md
@@ -1,4 +1,43 @@
-# @tailwindcss/webpack
+<p align="center">
+  <a href="https://tailwindcss.com" target="_blank">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tailwindlabs/tailwindcss/HEAD/.github/logo-dark.svg">
+      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/tailwindlabs/tailwindcss/HEAD/.github/logo-light.svg">
+      <img alt="Tailwind CSS" src="https://raw.githubusercontent.com/tailwindlabs/tailwindcss/HEAD/.github/logo-light.svg" width="350" height="70" style="max-width: 100%;">
+    </picture>
+  </a>
+</p>
+
+<p align="center">
+  A utility-first CSS framework for rapidly building custom user interfaces.
+</p>
+
+<p align="center">
+    <a href="https://github.com/tailwindlabs/tailwindcss/actions"><img src="https://img.shields.io/github/actions/workflow/status/tailwindlabs/tailwindcss/ci.yml?branch=main" alt="Build Status"></a>
+    <a href="https://www.npmjs.com/package/tailwindcss"><img src="https://img.shields.io/npm/dt/tailwindcss.svg" alt="Total Downloads"></a>
+    <a href="https://github.com/tailwindlabs/tailwindcss/releases"><img src="https://img.shields.io/npm/v/tailwindcss.svg" alt="Latest Release"></a>
+    <a href="https://github.com/tailwindlabs/tailwindcss/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/tailwindcss.svg" alt="License"></a>
+</p>
+
+---
+
+## Documentation
+
+For full documentation, visit [tailwindcss.com](https://tailwindcss.com).
+
+## Community
+
+For help, discussion about best practices, or feature ideas:
+
+[Discuss Tailwind CSS on GitHub](https://github.com/tailwindlabs/tailwindcss/discussions)
+
+## Contributing
+
+If you're interested in contributing to Tailwind CSS, please read our [contributing docs](https://github.com/tailwindlabs/tailwindcss/blob/main/.github/CONTRIBUTING.md) **before submitting a pull request**.
+
+---
+
+## @tailwindcss/webpack
 
 A webpack loader for Tailwind CSS v4.
 
@@ -8,7 +47,7 @@ A webpack loader for Tailwind CSS v4.
 npm install @tailwindcss/webpack
 ```
 
-## Usage
+### Usage
 
 ```javascript
 // webpack.config.js
@@ -34,9 +73,9 @@ Then create a CSS file that imports Tailwind:
 @import 'tailwindcss';
 ```
 
-## Options
+### Options
 
-### `base`
+#### `base`
 
 The base directory to scan for class candidates. Defaults to the current working directory.
 
@@ -49,7 +88,7 @@ The base directory to scan for class candidates. Defaults to the current working
 }
 ```
 
-### `optimize`
+#### `optimize`
 
 Whether to optimize and minify the output CSS. Defaults to `true` in production mode.