Typographie

Échelle de typographie, rôles de texte et hiérarchie utilisés dans l'interface utilisateur de PyColors.

Système de conceptionMise à jour 18 mai 2026
Système de conceptionTypographie

Vue d’ensembleLien vers la section

La typographie est l'un des signaux les plus forts de la qualité du produit. Il donne à chaque interface une structure lisible avant que la couleur, l'espacement, le mouvement ou la décoration ne soient ajoutés.

PyColors traite la typographie comme un systèmePas comme style de page locale. L'objectif est de garder les tableaux de bord, la documentation, les pages de paramètres, les sections marketing, les formulaires et les flux de produits lisibles et cohérents à mesure que le produit se développe.

À la fin de cette page, vous comprendrez comment PyColors gère :

  • rôles de police
  • Hiérarchie des titres
  • densité du corps du texte
  • étiquettes et métadonnées
  • Rôles sémantiques de texte
  • règles d'utilisation de la production

Pourquoi cela compte

Un système de type faible rend un produit inachevé même lorsque les composants de l'interface utilisateur sont corrects. Une typographie stable améliore la numérisation, réduit le bruit visuel et rend l'interface plus délibérée.

Ce que vous allez définirLien vers la section

Rôles de police

Séparez le texte de l'interface utilisateur, les accents de la marque et les valeurs techniques avec des variables de police prévisibles.

Hiérarchie

Utilisez une échelle de titre limitée pour que les pages restent numérisables sans surcharger la table des matières.

Règles d'utilisation

Conservez la sémantique des rôles de texte afin que les composants réutilisables restent cohérents en mode clair et sombre.

ÉtapesLien vers la section

Utiliser les rôles de police au lieu des choix de policeLien vers la section

PyColors expose les polices en tant que variables et utilitaires CSS. Les composants doivent dépendre du rôle de la police et non d'une famille codée en dur.

app/layout.tsx
import { Inter } from "next/font/google";

const inter = Inter({
  subsets: ["latin"],
  variable: "--font-sans", // highlight
});

Les rôles communs sont :

RôleUtilitéObjet
UI et contenufont-sansInterface par défaut et contenu lisible
Accent de marquefont-brandRubriques, sections de héros, identité premium
Valeurs techniquesfont-monoCode, identifiants, tokens, sortie CLI

Note d ' exécution

La famille de polices exacte peut changer avec le temps. La partie importante est que les composants continuent de consommer des rôles de police stables.

Choisir la densité par surfaceLien vers la section

PyColors maintient la densité du texte simple. Les interfaces produits devraient rester efficaces, tandis que la documentation et le contenu marketing devraient être plus faciles à lire.

SurfacePar défautMotif
UI et tableaux de bord SaaStext-smAssez dense pour les workflows de produits
Docs, guides et marketingtext-basePlus confortable pour la lecture
Étiquettes et métadonnéestext-xsContexte compact sans concurrence avec les titres

Cette division maintient les tableaux de bord efficaces tout en rendant la documentation calme et premium.

Construire la hiérarchie avec une échelle limitéeLien vers la section

Les titres doivent rendre la structure évidente sans transformer chaque section en un événement visuel.

Titre de la page

Titre de section

Sous-section Titre

Rubrique mineure

Texte lisible avec suffisamment de rythme pour la documentation et la copie du produit.

Pourquoi c'est importantLien vers la section

La typographie est l’endroit où la qualité du produit devient visible. Les utilisateurs peuvent ne pas remarquer le système de type directement, mais ils remarquent lorsque le produit se sent plus difficile à numériser, moins structuré ou visuellement incohérent.

Sans un système de typographie stable, vous pourrez :

  • inventer des tailles d'en-tête page par page
  • surutiliser le poids de la police pour créer l'emphase
  • rendre les tableaux de bord visuellement bruyants
  • réduire la confiance dans les surfaces de produits et de documentation
  • rendre les composants plus difficiles à réutiliser de manière cohérente

Avec un système stable, chaque page semble plus calme, plus intentionnelle et plus facile à comprendre.

Principe du produit

La typographie devrait réduire la charge cognitive. Il devrait guider le lecteur à travers le produit, pas rivaliser pour l'attention.

Rôles de texteLien vers la section

Le texte principal est utilisé pour le contenu principal qu'un utilisateur doit lire ou sur lequel il doit agir.

Le texte secondaire prend en charge le message principal avec des descriptions, une copie d'aide et des détails contextuels.

Les métadonnées sont réservées aux horodatages, aux étiquettes, aux indications de statut et aux informations secondaires compactes.

RôleUtilitéUtilisation
Texte principaltext-foregroundPrincipaux contenus lisibles
Texte secondairetext-muted-foregroundDescriptions, texte d'aide, copie d'appui
Marque ou texte d'actiontext-primaryLiens et actions mises en avant
Texte destructeurtext-destructiveErreurs, flux de suppression, messages dangereux
Texte techniquefont-monoCode, tokens, identifiants, valeurs CLI

Règles d'utilisationLien vers la section

Utilisez des rôles de typographie pour créer des surfaces de produit cohérentes au lieu de styliser le texte à partir de zéro à chaque fois.

export function ProductSummary() {
  return (
    <section className="space-y-2">
      <p className="text-xs font-medium uppercase tracking-wide text-muted-foreground">
        Starter Pro
      </p>
      <h2 className="text-2xl font-semibold tracking-tight">
        Production-shaped SaaS foundation
      </h2>
      <p className="max-w-prose text-sm leading-6 text-muted-foreground">
        Use semantic text roles to keep product copy, labels, and descriptions
        predictable across reusable surfaces.
      </p>
    </section>
  );
}

Guide de décisionLien vers la section

Utilisez ce système de typographie si :

  • vous créez des tableaux de bord SaaS, des documents, des paramètres ou des pages marketing
  • vous avez besoin d'une hiérarchie cohérente entre plusieurs domaines de produits
  • vous voulez que les composants réutilisables soient cohérents sans surcharges locales
  • vous vous souciez de la lisibilité en mode clair et sombre

Ne pas outrepasser si :

  • le changement ne résout qu'une préférence visuelle locale
  • le même besoin apparaît dans plusieurs endroits et devrait devenir un token
  • la nouvelle taille, le poids ou la couleur affaiblit la cohérence hiérarchique

Prêt à passer du système de conception à la base du produit?

Starter Pro vous donne une base SaaS plus forte avec auth, facturation, structure backend et flux adaptées à la production. /docs/starter-pro

Erreurs courantesLien vers la section

Préférez

  • tailles de cap limitées
  • Couleurs sémantiques du texte
  • helper copy
  • étiquettes pour les métadonnées
  • Longueurs de ligne raisonnables

Éviter

  • trop de tailles de police dans un seul panneau
  • copie majuscule longue forme
  • Valeurs de couleur brutes pour le texte
  • tailles de titre aléatoires entre les pages
  • Le poids au lieu de la structure

Prochaines étapesLien vers la section