Bao-Link
Retour aux articles

Bao-Link : Construire un site Astro centré utilisateur

Interface du site Bao-Link avec composants interactifs et documentation enrichie
Partager
LinkedIn X (Twitter) WhatsApp

Comment le site Bao-Link a été repensé sans template : documentation interactive, composants réutilisables, et une UX qui donne à l'utilisateur les moyens de comprendre, pas juste de regarder.

Roadmap — Développement

Carte interactive

Cette roadmap est conçue pour une navigation sur écran d'ordinateur. Pour une expérience optimale, ouvrez cette page sur un écran plus large.


Un site internet ne devrait pas être juste une vitrine. Il devrait être un outil : un espace où l’utilisateur peut interagir, comprendre, et repartir avec quelque chose de concret.

Ce que vous allez apprendre

Cet article détaille la deuxième phase du projet Bao-Link : la construction d’un site Astro 100% sur mesure, sans template, centré sur ce que les utilisateurs veulent voir, manipuler et comprendre.

Le Contexte

Le concept

Après la migration de WordPress vers Astro, il ne s’agissait pas juste de reproduire le même site dans un nouveau framework.

L’objectif était de repenser complètement ce qu’un site peut offrir : documentation interactive, composants visuels pour illustrer des concepts, outils intégrés, et une expérience utilisateur qui donne envie d’explorer.


Problématique

Site vitrine passif

Un site vitrine traditionnel est unidirectionnel : l’utilisateur regarde, lit, puis s’en va. Pas d’interaction, pas de personnalisation, pas de raison de revenir.

Documentation statique

Les documentations techniques sont souvent de longs textes sans visuels, sans exemples interactifs. L’utilisateur doit tout lire avant de comprendre, ce qui augmente le taux d’abandon.

Aucune différenciation

Un site fait avec un template ressemble à des centaines d’autres. Aucune identité visuelle forte, aucune expérience mémorable. L’utilisateur ne se souvient pas de son passage.


La vision : un site-outil

Vision d'un site interactif centré sur l'utilisateur

La vision du projet Bao-Link est simple : un site doit servir à l’utilisateur, pas à son propriétaire.

Au lieu de présenter passivement du contenu, chaque page devrait permettre à l’utilisateur de :

Comprendre par l'exemple

Les composants interactifs (<CodeSnippet>, <ComparisonSlider>, <InteractiveTabs>) permettent de voir le code en action, pas juste de le lire.

Manipuler pour apprendre

Les démonstrations interactives (<RoadmapCanvas>, <Checklist>, <FileTree>) donnent à l’utilisateur le contrôle de son apprentissage.

Retrouver rapidement

Une navigation pensée, des tags, des articles connexes : tout est fait pour que l’utilisateur trouve ce qu’il cherche en quelques clics.

🧠
Analogie

Un site traditionnel, c’est comme un manuel : tu lis, tu tournes les pages, mais tu ne peux pas interagir. Le site Bao-Link, c’est comme un musée interactif.


Ce qu’on a mis en place

Blog enrichi

Engagement actif
×4

Le contenu interactif génère 4× plus d'engagement actif que la lecture passive

  Gitnux : Interactive Content Statistics 2026 

Attention
+38%

Les pages interactives retiennent l'attention 38% plus longtemps que les pages statiques

  Outgrow : User Engagement Benchmarks 2026 

Rétention mémoire
+9 pts

Scores de mémorisation améliorés (77% vs 68%) avec l'apprentissage interactif vs texte statique

  Frontiers in AI : Google Research 2026 

Documentation interactive

Composants de démonstration

Chaque concept technique est illustré par un composant visuel. Par exemple, la <ComparisonSlider> montre l’avant/après d’une optimisation, le <LighthouseScore> affiche les résultats réels, et le <CodeBlock> permet de copier du code prêt à l’emploi.

Pattern documenté

Chaque article suit une structure claire : [Problème → Diagnostic → Solution → Patron réutilisable]. L’utilisateur peut appliquer immédiatement ce qu’il apprend, sans avoir à chercher ailleurs.

Plus que du texte

Les articles ne sont pas de simples blocs de texte. Chaque article peut intégrer des démonstrations interactives, des tableaux de données, des FAQ, des checklists, et des liens vers des articles connexes via <PreviewLink>.

Navigation contextuelle

Le système de related_connections permet de lier les articles entre eux : prérequis, articles connexes, alternatives. L’utilisateur n’est jamais perdu.

Checklists interactives

Les <Checklist> avec <storageKey> sauvegardent l’état localement. L’utilisateur peut suivre sa progression dans un guide, revenir plus tard, et retrouver où il en est.

Composants métier

Des composants comme <DataTable>, <InteractiveTabs>, <Timeline> transforment des informations complexes en visuels clairs et compréhensible.

i
Information

Si vous souhaitez en découvrir plus voici la page des différents elementsL'Article Parfait – Guide SEO Complet Bao-LinkArticleL'Article Parfait – Guide SEO Complet Bao-LinkDécouvrez comment structurer un article optimisé SEO sur Bao-Link : métadonnées, structure, blocs de contenu interactifs et checklist de publication.


Les fondements derrière les choix UX

Chaque composant, chaque choix de layout, chaque interaction repose sur des recherches en psychologie cognitive et des méthodologies marketing éprouvées.

Patterns de lecture F & Z

Les études du Nielsen Norman Group montrent que les utilisateurs scannent les pages en F (contenu textuel) ou en Z (contenu visuel). La navigation, les titres, et les CTA sont positionnés en conséquence : pas par hasard, mais par conscience du comportement réel des visiteurs.

Système 1 & Système 2 (Kahneman)

Le cerveau humain fonctionne en deux modes : Système 1 (rapide, intuitif, automatique) et Système 2 (lent, analytique, effort). Le site est optimisé pour le Système 1 : les utilisateurs scannent, ne réfléchissent pas. Chaque élément doit être compréhensible en un coup d’œil.

Charge cognitive

Le cerveau a une capacité limitée d’information simultanée (Sweller, 1988). Les pages réduisent cette charge : progressive disclosure, composants isolés, documentation par étapes. L’utilisateur comprend sans être submergé.

Loi de Hick

Plus il y a de choix, plus la décision prend du temps. Le site réduit le nombre d’options : navigation minimale, CTA unique, progressive disclosure. L’utilisateur ne choisit pas entre 20 options : il avance.

SONCAS

6 motivations psychologiques d’achat : Sécurité, Orgueil, Nouveauté, Confort, Argent, Sympathie. Le contenu est structuré pour parler la langue de chaque motivation, pas un message unique qui espère toucher tout le monde.

DISC

4 profils comportementaux : Dominant, Influence, Stabilité, Conformité. Chaque profil perçoit l’information différemment. Le ton et la structure s’y adaptent, un principe qui dépasse la simple UX et rejoint le projet Personas.

Réseau de connexions représentant la combinaison des méthodes marketing et psychologique

L'interactivité comme fil conducteur

Ces méthodes ne s’appliquent pas en silo.

Elles se combinent et se renforcent mutuellement : DISC identifie le profil, SONCAS détermine le message, les patterns de lecture placent ce message au bon endroit, et la charge cognitive garantit qu’il est compris.

L’interactivité est le liant qui transforme ces frameworks théoriques en expérience concrète : l’utilisateur ne lit pas un concept, il le vit.

Pour aller plus loin, l’article Article en cours de rédaction : frameworks-copywriting détaille AIDA, PAS, la preuve sociale et d’autres biais cognitifs qui renforcent ces mêmes principes.

📖
L'interactivité comme multiplicateur

Un composant interactif n’est pas qu’une vitrine : c’est un profil DISC qui s’active et une corde SONCAS additionné à la Loi de Hick qui résonne : un message ciblé, sans choix superflux, qui répond à une motivation spécifique.

L’interactivité ne rend pas juste le contenu plus attrayant : elle multiplie l’impact de chaque fondement psychologique en le rendant tangible.

🧠
Analogie

« Dis-moi et j’oublie, montre-moi et je me souviens, implique-moi et je comprends. » Ce proverbe, souvent attribué à Edgar Dale, résume exactement la philosophie du site : chaque composant interactif transforme l’observateur en acteur : il ne regarde pas, il touche, teste, et retient.


Résultats

Un site qui fait la différence

Le site Bao-Link n’est plus un simple site vitrine. C’est un écosystème de connaissances où chaque visiteur peut apprendre, expérimenter et appliquer. Les retours utilisateurs montrent que la durée de session a augmenté et que les pages vues par session sont bien au-dessus de la moyenne d’un site vitrine classique.

98
Performance
97
Accessibilité
95
Best Practices
100
SEO
Performance
98/100

Score Lighthouse Performance

Accessibilité
97/100

Score Lighthouse Accessibility

SEO
100/100

Score Lighthouse SEO

📖
Pourquoi ces scores ?

Le site étant généré statiquement avec Astro, il n’y a aucune base de données, aucun script superflu, et aucune dépendance lourde. Chaque page ne charge que le JavaScript nécessaire à ses composants interactifs. Le résultat : des scores parfaits sur tous les critères.


Défis et enseignements

Défis de la construction d'un site Astro sans template

Les défis relevés

Création de composants de zéro

Sans template, chaque composant a dû être écrit et testé individuellement. Les 49+ composants représentent un investissement en développement significatif. Pas de raccourci possible.

Cohérence du design system

Sans framework CSS imposé, il a fallu définir et maintenir un design system : couleurs, typographie, espacements, modes clair/sombre. Une erreur de cohérence se voit immédiatement quand tout est fait main.

Équilibre interactivité / performance

Chaque composant interactif ajoute du JavaScript. L’architecture islands d’Astro permet de ne charger que le JS nécessaire, mais il faut concevoir chaque composant avec la performance en tête.

Leçons apprises de la construction du site Bao-Link

Les enseignements tirés

Chaque composant a une raison d'être

Aucun composant n’a été créé « au cas où ». Chacun répond à un besoin utilisateur spécifique : comprendre un concept, visualiser une différence, suivre une progression. Cette discipline évite le bloatware.

L'UX prime sur le design

Le site n’est pas « beau » pour être beau. Chaque choix visuel est motivé par l’utilisabilité : lisibilité, navigation, accessibilité. Un site accessible et utilisable est naturellement beau.

Documentation = Produit

La documentation technique n’est pas un sous-produit : c’est le cœur du site. En investissant dans des composants de documentation interactifs, on transforme un guide technique en expérience utilisateur valorisante.


Ce qu’il faut retenir

AVANT

Avant : Site classique

Simple vitrine

Pages statiques, contenu figé. L’utilisateur lit et s’en va. Aucune interaction, aucun engagement.

Documentation passive

Longs textes sans visuels, sans exemples concrets. L’utilisateur doit tout lire avant de comprendre.

Expérience oubliable

Rien ne retient l’utilisateur. Il passe, il oublie. Aucune raison de revenir ou de recommander le site.

APRÈS

Après : Écosystème Bao-Link

Contenu interactif

L’utilisateur manipule le contenu, il ne le lit pas passivement. Les démonstrations interactives transforment la compréhension.

49+ composants pour illustrer, démontrer et interagir

Documentation qui enseigne

L’utilisateur apprend en faisant. Il peut copier du code, tester des concepts, et appliquer immédiatement ce qu’il découvre.

Patrons réutilisables, exemples concrets, code prêt à copier

Expérience mémorable

L’utilisateur se souvient de son passage. Le site est recommandé, partagé, et les visiteurs reviennent.

Site 100% sur mesure, pensé pour l'utilisateur de bout en bout


Conclusion

Conclusion : un site pensé pour l'utilisateur

Construire pour l'utilisateur, pas pour la vitrine

Le site Bao-Link n’est pas le résultat d’un template ou d’un CMS. C’est le résultat d’une réflexion continue sur ce que les utilisateurs attendent d’un site technique :

  • De la clarté : une information bien présentée, avec des exemples concrets.
  • De l’interactivité : la possibilité d’explorer, de tester, de manipuler.
  • De l’efficacité : trouver ce qu’on cherche en quelques clics, repartir avec une solution.
  • De la qualité : un site rapide, accessible, fiable.

Ce projet a posé les bases d’une approche qui s’étendra à d’autres projets liés : Article en cours de rédaction : diag-application pour la veille concurrentielle, Article en cours de rédaction : persona pour parler a vos utilisateurs, et d’autres outils a venir qui suivent la même philosophie :

Ne pas faire un site pour le faire, mais le construire pour ceux qui l’utilisent.


Des zones d'ombre ?

Est-ce que ce niveau de personnalisation est pertinent pour tous les sites ?
Tout dépend de ce que vous souhaitez laisser à vos utilisateurs. Un site vitrine pour un artisan n'a pas besoin de 49 composants interactifs. La personnalisation poussée est pertinente quand le site est un outil de travail (documentation, blog technique, plateforme d'apprentissage) ou quand on veut leur offrir une expérience qui les marque au point de revenir, tel un musée interactif.
Comment sont créés les composants ?
Chaque composant est un fichier .astro dans src/components/blog/. Ils sont écrits en Astro + TypeScript, avec du Tailwind CSS pour le style. Certains utilisent du JavaScript côté client pour l'interactivité (composants islands).
Un client peut-il modifier le contenu sans compétences techniques ?
Le contenu est en fichiers Markdown/MDX. Pour les clients non techniques, je fait le choix de créer des articles avec eux : ils n'ont pas à se prendre la tête sur l'outil, seulement sur leur cœur de métier. Je les accompagne, j'apprends leur métier en même temps, et je m'occupe du contenu technique.
Quels sont les projets futurs liés à cette approche ?
Deux projets sont en développement : Diagnostic Application : un outil de veille concurrentielle et de conseil pour analyser les points faibles d'un site existant : et Personas : une méthode pour concevoir des sites à partir des profils types d'utilisateurs finaux que mes clients veulent toucher. Tous deux suivront la même philosophie : des outils interactifs centrés sur l'utilisateur.

Checklist

0/12

Vos progrès sont sauvegardés localement sur votre appareil. Aucune donnée n'est collectée. La durée de conservation dépend de la durée de rétention des données de votre navigateur.

Orfèvre Digital

Vous voulez un site qui fait plus que montrer ?

On conçoit ensemble un site sur mesure, pensé pour vos utilisateurs, avec des composants interactifs qui transforment l'expérience.

Orfèvre Digital
Disponible
En savoir plus

Projets associés

1

Articles Connexes

3

Inspiration

Découvrez d'autres projets

Voir le portfolio
Développement 16 juillet 2026

ACM : Refonte E-commerce avec Astro, Express & WordPress

Étude de cas complète : migration d'un site e-commerce WordPress/WooCommerce vers une architecture Astro SSR + proxy Express, avec déploiement et optimisation SEO.

Astro Astro Express Express WordPress WordPress
Voir le projet
Développement 16 juillet 2026

Soair : La Transition Numérique Complète

Étude de cas complète : création d'un site WordPress professionnel puis migration vers Hugo pour des performances optimales et un SEO décuplé.

# Soair WordPress WordPress Hugo Hugo
Voir le projet
Prêt pour l'aventure

Besoin d'un
expert ?

Discutons ensemble de vos objectifs et transformons votre vision en une réalité performante et pérenne.

Prêt pour l'aventure

Suivez Bao-Link

Et restez informé des nouveaux articles et projets.

ou

Newsletter

Un récap par mois de ce qui a vraiment compté. Pas de spam, promis.