---
contentId: 005bb627-29a3-4d3d-a6b6-9284afbbefa7
part: 12
title: "Migration du blog VitePress vers Tailwind CSS Version 4"
description: "Un guide étape par étape pour mettre à jour notre blog VitePress vers Tailwind CSS 4.0 afin de profiter de ses dernières fonctionnalités et améliorations."
github:
  branch: 12.migration-to-tailwind-css-4
date: 2025-05-08
seriesSlug: create-a-blog-with-vitepress-and-vue-js-from-scratch
---

Depuis le premier épisode de cette série, **Tailwind CSS** a publié une nouvelle version majeure, apportant de nombreuses nouvelles fonctionnalités et améliorations. Dans cet épisode, nous allons migrer notre blog **VitePress** vers Tailwind CSS 4.0. Ce processus est plus simple que vous ne le pensez et nous permettra d'utiliser les dernières fonctionnalités de **Tailwind CSS** tout en maintenant notre blog à jour.



> [!NOTE]
> Je ne présenterai pas les dernières fonctionnalités de Tailwind CSS 4.0 dans cet épisode. Je vous recommande de lire l'[annonce officielle](https://tailwindcss.com/blog/tailwindcss-v4) sur le blog de Tailwind CSS.



## Mise à jour des dépendances

Tout d'abord, nous devons mettre à jour nos dépendances. Pour ce faire, j'aime utiliser [taze](https://github.com/antfu-collective/taze), mais comme nous ne mettons à jour que **Tailwind CSS**, nous pouvons le faire manuellement. Ouvrez votre fichier `package.json` et mettez à jour les dépendances suivantes :

```json [package.json]
{
  "devDependencies": {
    "tailwindcss": "^4.1.5", // [!code ++]
    "@tailwindcss/vite": "^4.1.5", // [!code ++]
    "autoprefixer": "^10.4.20", // [!code --]
    "postcss": "^8.5.1" // [!code --]
  }
}
```

Ensuite, exécutez la commande suivante pour installer les nouvelles dépendances :

```bash [terminal]
pnpm install
```

Il y a plusieurs choses à noter avec ce changement. Tout d'abord, il y a une nouvelle dépendance appelée `@tailwindcss/vite`, qui est le nouveau plugin **Vite** pour Tailwind CSS, simplifiant le processus d'installation. De plus, les dépendances `autoprefixer` et `postcss` ne sont désormais plus nécessaires.

Cela signifie que le fichier `postcss.config.cjs` peut être supprimé en toute sécurité, car Tailwind CSS s'appuie désormais sur **Vite** pour le traitement CSS. Ce changement améliore à la fois les performances et l'expérience des développeurs, c'est l'une des meilleures caractéristiques de cette nouvelle version.

## Utiliser le nouveau plugin Vite

Un nouveau plugin Vite signifie que nous devons mettre à jour notre configuration VitePress pour l'utiliser. Ouvrez votre fichier `.vitepress/config.mts` et mettez à jour le code suivant :

```ts [.vitepress/config.mts]
import Tailwind from '@tailwindcss/vite'
import { defineConfig } from 'vitepress'

export default defineConfig({
  vite: {
    plugins: [
      Tailwind() // [!code ++]
    ]
  }
})
```

Et c'est tout !

## Mise à jour de l'utilisation de Tailwind CSS

Maintenant que nous avons mis à jour nos dépendances et la configuration de VitePress, nous devons mettre à jour l'utilisation de **Tailwind CSS** dans notre fichier `app.css`. Dans sa dernière version, Tailwind CSS est passé à une configuration basée sur CSS, simplifiant le processus d'installation. Cela signifie que nous devons mettre à jour notre fichier `app.css`.

De :

```css [.vitepress/theme/common/styles/app.css]
@tailwind base;
@tailwind components;
@tailwind utilities;
```

À :

```css [.vitepress/theme/common/styles/app.css]
@import 'tailwindcss';
```

Au lieu de s'appuyer sur des directives CSS personnalisées, nous pouvons désormais utiliser la directive native `@import` pour incorporer Tailwind CSS.

Ensuite, nous migrons notre configuration vers la nouvelle configuration basée sur CSS.

```css [.vitepress/theme/common/styles/app.css]
@config "../../../../tailwind.config.cjs";

@plugin "@tailwindcss/typography";

@source '../../../../src/**/*.md';
@source '../../**/*.{vue,ts}';
```

En théorie, nous pourrions complètement supprimer le fichier de configuration JavaScript actuel, mais comme nous utilisons le plugin `@tailwindcss/typography`, nous devons le conserver.



> [!NOTE]
> Adam Wathan, le créateur de Tailwind CSS, [a des projets pour le plugin typographie](https://x.com/adamwathan/status/1894776336402583835), mais nous n'avons pas encore de détails.



Cependant, nous pouvons tout de même supprimer les propriétés `content` et `plugins` du fichier de configuration.

```js [tailwind.config.cjs]
/** @type {import('tailwindcss').Config} */
module.exports = {
  content: ['./src/**/*.md', './.vitepress/theme/**/*.{vue,ts}'], // [!code --]
  theme: {
    extend: {
      typography: {
        // ...
      },
    },
  },

  plugins: [require('@tailwindcss/typography')], // [!code --]
}
```

Et c'est tout ! Nous utilisons désormais la dernière version de **Tailwind CSS** dans notre blog **VitePress** !

J'espère que vous avez apprécié cet aperçu de la migration qui garantit que notre blog reste à jour pour nous permettre d'utiliser les dernières fonctionnalités de **Tailwind CSS**.
