Compétence Thème de Design
1. Identité de la Compétence
- Nom : design-theme
- Objectif : Définir les normes UI/UX et de conception visuelle pour un portfolio de développeur individuel.
- Cible : Portfolio de développeur IA / Logiciel / Produit
- Objectif Principal : Transmettre l'impression d'un développeur qui découvre de vrais problèmes et crée des produits avec l'IA et les logiciels, plutôt qu'un simple portfolio énumérant des technologies.
2. Philosophie de Conception Fondamentale
Ce portfolio privilégie les impressions suivantes :
- Professionnel
- Moderne
- Minimal
- Technique
- Orienté Produit
- Lisible
- Digne de Confiance
Principes Clés
"Le contenu et les projets doivent être les vedettes, pas la décoration."
L'utilisateur doit pouvoir comprendre rapidement dès le premier écran :
- Qui est-ce ?
- Que crée-t-il ?
- Quels problèmes résout-il ?
- Quels projets a-t-il réalisés ?
- Quelles technologies utilise-t-il ?
- Est-ce une personne capable de développer concrètement ?
3. Direction Visuelle
Orientation de Base
- Mode Clair en priorité
- Fond blanc/gris clair épuré
- Accent Bleu limité
- Bordures fines
- Espaces blancs généreux
- Typographie forte
- Grille ordonnée
- Décoration excessive minimisée
Orientations à Éviter
Les designs suivants sont fondamentalement exclus :
- Dégradé excessif
- Lueur forte
- Glassmorphisme
- Effets 3D excessifs
- Animations sans signification
- Ombres excessives
- Couleurs arc-en-ciel
- Badges trop nombreux
- Illustrations décoratives abusives
- Template générique commun dans les portfolios IA
- Badges technologiques utilisant des couleurs différentes pour chaque technologie
- Layout où le design prime sur le contenu
4. Système de Couleurs
Base
Arrière-plan #FAFAFA
Surface #FFFFFF
Premier plan #18181B
Texte Secondaire #52525B
Texte Faible #71717A
Espace réservé #A1A1AA
Bordure #E4E4E7
Arrière-plan Faible #F4F4F5
Accent
Accent #2563EB
Accent Survol #1D4ED8
Accent Doux #EFF6FF
L'accent est utilisé de manière limitée sur l'ensemble de l'écran.
Emplacements d'Utilisation de l'Accent
- CTA Principal
- Liens importants
- Navigation active
- État Focus
- Informations importantes
- Statuts de projet nécessitant une mise en évidence
L'accent ne doit pas être utilisé de manière excessive comme fond d'écran ou décoration.
Statuts
Succès #16A34A
Avertissement #D97706
Erreur #DC2626
Les couleurs de statut sont utilisées uniquement pour exprimer un état réel.
5. Typographie
Priorité des Polices
La lisibilité du coréen est prioritaire.
Ordre recommandé :
Pretendard
system-ui
sans-serif
Pour le code, les noms de technologies, les chiffres et les métadonnées, on peut utiliser :
Geist Mono
monospace
Échelle Typographique
Hero
Desktop :
56px ~ 72px
font-weight: 700 ~ 800
line-height: 1.05 ~ 1.15
Mobile :
40px ~ 48px
font-weight: 700 ~ 800
line-height: 1.1 ~ 1.2
H2
Desktop :
36px ~ 44px
Mobile :
30px ~ 34px
H3
20px ~ 24px
Corps de Texte
16px ~ 18px
line-height: 1.6 ~ 1.75
Petit / Méta
13px ~ 14px
6. Système de Mise en Page
Conteneur
Largeur maximale par défaut :
1200px
Padding Horizontal
Desktop :
32px ~ 48px
Tablette :
24px
Mobile :
20px
Espacement des Sections
Desktop :
120px ~ 160px
Mobile :
80px ~ 100px
L'espacement n'est pas appliqué de manière uniforme à toute la page.
Ajustez l'espacement en fonction de l'importance du contenu.
7. Système de Grille
La zone Projet utilise par défaut la structure suivante.
Desktop
2 Colonnes
Tablette
2 Colonnes
Mobile
1 Colonne
Les grilles de 3 colonnes ou plus ne sont pas utilisées sans raison particulière.
La lisibilité du contenu des cartes de projet est plus importante que le nombre de colonnes.
8. En-tête
L'en-tête est composé d'une UI minimale pour faciliter la navigation dans le portfolio.
Structure recommandée :
Logo / Nom
Projets
À propos / Approche
Contact
Si souhaité, un lien vers le CV ou GitHub peut être ajouté.
Principes de l'En-tête
- Interdiction d'un en-tête trop grand
- Ne pas étendre excessivement la navigation
- En mobile, réduire au menu si nécessaire
- L'état Actif utilise l'accent de manière limitée
9. Hero
Le Hero est la zone la plus importante du premier écran.
L'objectif n'est pas d'être flashy, mais de transmettre immédiatement l'identité du développeur.
Structure recommandée :
Surtitre
↓
Titre Principal
↓
Brève Description
↓
CTA Principal / CTA Secondaire
Exemple d'orientation :
Quand je découvre un problème,
je le résous moi-même.
Développeur qui résout des problèmes réels avec l'IA et les logiciels
et les transforme en produits, Jeonghyeon Yun
Cependant, le texte final réel est géré dans un fichier de contenu séparé.
Ne pas coder en dur le contenu du composant Hero.
10. Conception du Projet
Les projets sont le contenu central du portfolio.
Une carte de projet ne doit pas être simplement une carte affichant des noms de technologies.
Dans la mesure du possible, transmettez les informations suivantes :
Nom du Projet
Statut
Résumé Court
Problème
Solution
Technologies
Période
Ne forcez pas toutes les informations dans une seule carte.
Si les informations sont nombreuses, redirigez vers une page de détail.
11. Carte de Projet
Style de base :
Arrière-plan : #FFFFFF
Bordure : 1px solid #E4E4E7
Rayon de Bordure : 12px ~ 16px
Padding : 24px ~ 32px
Ombre : none ou très légère
L'effet de survol est minimisé.
Recommandé :
Changement de border-color
Changement de background
transform : très léger
N'utilisez pas d'effets de zoom excessifs ou de lueur.
12. Statut du Projet
Le statut du projet est exprimé clairement.
Exemples :
En ligne
En cours
Archivé
Ne transmettez pas le sens uniquement par la couleur.
Utilisez du texte ou une icône en complément.
13. Étiquettes Technologiques
Les étiquettes technologiques sont des éléments auxiliaires pour une identification rapide.
N'appliquez pas de couleurs arc-en-ciel à chaque technologie.
Utilisez un style Neutre par défaut.
Exemple :
Next.js
TypeScript
Python
FastAPI
Supabase
SQLite
Agent IA
Les étiquettes technologiques ne doivent pas être plus visibles que la description du projet.
14. Page de Détail du Projet
Lors du clic sur une carte de projet, la structure suivante peut être utilisée :
En-tête du Projet
↓
Aperçu
↓
Problème
↓
Approche
↓
Implémentation
↓
Défis
↓
Résultat
↓
Ce que j'ai appris
↓
Technologies
↓
Liens
Tous les projets ne doivent pas nécessairement avoir toutes les sections.
Affichez uniquement les informations existantes dans le projet réel.
15. Projets Mis en Avant
Sur la page d'accueil, n'affichez pas tous les projets avec le même poids.
Sélectionnez les projets principaux en fonction du statut featured.
Exemple :
featured: true
L'UI affiche les projets en fonction de la valeur featured.
Par conséquent, il ne doit pas être nécessaire de modifier le code du composant pour exclure un projet de la section "À la Une".
16. Plus de Projets
Sous les projets mis en avant, une zone peut être prévue pour voir d'autres projets.
Objectif :
Il ne s'agit pas d'éviter que les projets paraissent peu nombreux, mais de montrer la diversité des problèmes que le développeur a résolus.
Maintenez une hiérarchie visuelle entre les projets mis en avant et les projets généraux.
17. Section Approche
Au lieu d'un "À propos de moi" générique, privilégiez une zone montrant l'approche de développement.
Exemple :
01 Problème
02 Découverte
03 Apprentissage
04 Construction
05 Résultat
Le message clé est le suivant :
Découvrir un problème → Enquêter → Apprendre les technologies nécessaires → Construire soi-même → Vérifier le résultat.
Privilégiez la présentation du processus de développement réel et de la mentalité plutôt qu'une simple introduction personnelle.
18. Compétences
Les compétences ne sont pas une simple liste de technologies, mais montrent le contexte d'utilisation réel.
Classification recommandée :
Frontend
Backend
IA / Automatisation
Base de données
Outils
Exemple :
Frontend
Next.js
React
TypeScript
Tailwind CSS
Backend
Python
FastAPI
Flask
IA / Automatisation
Agent IA
RAG
API LLM
Automatisation
Base de données
SQLite
PostgreSQL
Supabase
Outils
Git
GitHub
VS Code
Cependant, n'ajoutez pas de technologies sans expérience réelle d'utilisation.
19. Représentation des Compétences
N'exprimez pas le niveau de compétence technique par des chiffres ou des étoiles arbitraires.
Interdit :
Python ★★★★★
React 90%
IA 95%
À la place, reliez les technologies aux projets réels et à leur objectif.
Exemple :
Python
→ Utilisé pour des projets d'Agent IA / Automatisation / Backend
20. Contact
La zone de contact est conçue de manière simple et claire.
Recommandé :
Message Court
Email
GitHub
LinkedIn ou autres liens réels
Ne créez pas de contacts ou de liens qui n'existent pas réellement.
21. Pied de Page
Le pied de page est minimal.
Exemple :
© 2026 Jeonghyeon Yun
Construit avec Next.js
N'ajoutez pas plus d'informations que nécessaire.
22. Conception Réactive
Tenez impérativement compte des environnements suivants.
Desktop
Tablette
Mobile
N'implémentez pas le responsive en réduisant simplement la taille de l'écran.
En particulier sur Mobile, appliquez :
- Modification de la structure de navigation
- Ajustement de la typographie Hero
- Grille → 1 Colonne
- Ajustement de la taille des boutons
- Réduction du padding
- Vérification du retour à la ligne des textes longs
- Ajustement des priorités d'information sur les cartes de projet
23. Accessibilité
Tenez impérativement compte de l'accessibilité de base.
- Hiérarchie de titres appropriée
- Contraste de couleurs suffisant
- Focus clavier
- Boutons / Liens clairs
- Texte alternatif des images
- Zones tactiles de 44px ou plus recommandées
- Ne pas distinguer les états uniquement par la couleur
- Configurer pour que l'information soit transmise même sans animation
24. Animation
Les animations ne sont utilisées que si elles aident la fonctionnalité.
Recommandé :
150ms ~ 300ms
ease-out
Zones autorisées :
- Survol de bouton
- Survol de lien
- Survol de carte
- Navigation
- Court dévoilement de section
Zones interdites :
- Effet Parallaxe
- Animation de défilement excessive
- Mouvement continu
- Animation décorative sans signification
- Mise en scène excessive à l'entrée de la page
25. Mode Sombre
Actuellement, pour la version 1, le mode clair est prioritaire.
Le mode sombre sera ajouté lorsqu'une exigence distincte apparaîtra.
Évitez que le mode sombre ne complexifie le système de design ou la structure des composants actuels.
26. Règles de Conception Technique
Tailwind CSS est utilisé comme système de style par défaut.
Les variables CSS sont utilisées pour gérer les jetons de design globaux.
Recommandé :
Tailwind
+
Variables CSS
N'utilisez pas de styles en ligne inutiles.
27. Règles des Composants
Utilisez React Server Component comme valeur par défaut.
Utilisez Client Component uniquement dans les cas suivants :
- Saisie utilisateur
- Gestion d'état
- API navigateur
- Interaction basée sur des événements
- Cas nécessitant une exécution côté client (bibliothèque d'animations, etc.)
Ne faites pas de la page entière un Client Component inutilement.
28. Séparation Contenu / UI
Séparez le contenu et l'UI.
Structure recommandée :
content/
├─ profile.ts
├─ projects.ts
├─ skills.ts
└─ types.ts
N'écrivez pas directement les informations du projet dans les composants UI.
Pour ajouter ou modifier un projet, si possible :
content/projects.ts
Concevez-le de manière à ce que la modification de ce seul fichier suffise à mettre à jour l'affichage.
29. Principe des Données de Projet
Les données de projet sont gérées sous une forme structurée.
Exemple :
{
slug,
title,
summary,
problem,
solution,
tech,
status,
featured,
period,
image,
links,
highlights
}
Utilisez uniquement les valeurs nécessaires.
Ne remplissez pas arbitrairement des informations qui n'existent pas réellement.
30. Règles des Images
Si une image de projet n'existe pas réellement, ne générez ni n'importez une image arbitraire.
Si un espace réservé (placeholder) est nécessaire, indiquez clairement qu'il s'agit d'un placeholder.
Créez une structure permettant de remplacer l'image par une capture d'écran réelle du projet dès qu'elle sera disponible.
31. Intégrité des Données
C'est l'un des principes les plus importants du portfolio.
Ne générez jamais arbitrairement les éléments suivants :
- Projets inexistants
- Expériences techniques inexistantes
- Réalisations inexistantes
- Chiffres inexistants
- Clients inexistants
- Expériences en entreprise inexistantes
- Liens inexistants
- Certifications/qualifications inexistantes
- Résultats de projets inexistants
En cas de manque d'informations, privilégiez :
Laisser vide
ou
Vérifier auprès de l'utilisateur
32. Préservation des Projets Existants
Ne modifiez pas arbitrairement le sens des projets existants.
Travaillez en vous basant sur les descriptions de projet ou les exigences fournies par l'utilisateur.
Si la suppression ou la réduction de fonctionnalités existantes est nécessaire, expliquez d'abord la raison et demandez une confirmation.
33. Architecture de l'Information du Portfolio
La structure d'accueil par défaut privilégie l'ordre suivant :
En-tête
↓
Hero
↓
Projets Mis en Avant
↓
Plus de Projets
↓
Approche
↓
Compétences
↓
Contact
↓
Pied de Page
Cependant, elle peut être ajustée en fonction du contenu réel et de l'utilisabilité.
34. Priorité des Décisions de Conception
En cas de conflit de conception, suivez l'ordre de priorité suivant :
1. Lisibilité du contenu
2. Hiérarchie de l'information
3. Accessibilité
4. Utilisabilité réactive (responsive)
5. Cohérence
6. Esthétique visuelle
7. Effets décoratifs
Privilégiez un design facile à lire et à comprendre plutôt qu'un design simplement joli.
35. Flux de Travail d'Implémentation
Pour créer une nouvelle page ou UI, suivez l'ordre suivant :
ÉTAPE 1. Analyser
Vérifiez d'abord la structure actuelle du projet et l'UI existante.
ÉTAPE 2. Planifier
Proposez la structure d'information et la composition d'écran nécessaires.
ÉTAPE 3. Concevoir
Proposez une direction visuelle basée sur les principes de conception de ce SKILL.md.
ÉTAPE 4. Composant
Proposez la structure de composant nécessaire.
ÉTAPE 5. Confirmer
Avant l'implémentation, obtenez la confirmation de l'utilisateur pour les changements de structure majeurs ou les nouvelles fonctionnalités.
ÉTAPE 6. Implémenter
Implémentez uniquement le périmètre confirmé.
ÉTAPE 7. Vérifier
Vérifiez les points suivants :
TypeScript
Build
Responsive
Accessibilité
Cohérence visuelle
Fonctionnalités existantes
36. Gestion du Changement
Pour les petites modifications, conservez autant que possible la structure existante.
Avant un changement important :
- Vérifier la structure actuelle
- Expliquer la raison du changement
- Vérifier le périmètre d'impact
- Proposer des alternatives
- Obtenir l'approbation de l'utilisateur
- Implémenter
Suivez cet ordre.
37. Dépendances
N'ajoutez de nouvelles bibliothèques que si la nécessité est claire.
Si les fonctionnalités existantes de Next.js / React / TypeScript / Tailwind peuvent résoudre le problème, n'ajoutez pas de nouvelle bibliothèque.
Si une bibliothèque doit être ajoutée, examinez d'abord :
Pourquoi est-elle nécessaire
Quel problème résout-elle
Existe-t-il une alternative ?
38. Principe Supabase / Backend
Actuellement, la version 1 du portfolio commence avec un contenu statique.
Utilisez d'abord :
content/*.ts
Un backend comme Supabase ne sera ajouté que lorsque les besoins suivants se présenteront réellement :
- Page d'administration
- CRUD de projets
- Blog
- Journal de développement
- Enregistrement des demandes de contact
- Authentification
- Gestion de données dynamiques
N'introduisez pas de base de données à un stade où un backend n'est pas nécessaire.
39. Flux de Travail Git
Effectuez un commit lorsqu'une unité de travail significative est terminée.
Flux de base :
git add .
git commit -m "Contenu du travail"
git push
Le format Conventional Commit est recommandé pour les messages de commit.
Exemple :
feat: add portfolio homepage
feat: add project section
style: improve project cards
fix: resolve mobile layout
refactor: simplify project components
docs: update portfolio documentation
chore: update dependencies
Ne regroupez pas les unités de travail de manière excessivement large.
40. Norme de Qualité Finale
L'écran terminé doit pouvoir répondre "Oui" aux questions suivantes :
- L'identité du développeur est-elle visible dès le premier écran ?
- Les projets apparaissent-ils comme le contenu central ?
- Comprend-on ce que chaque projet a résolu ?
- Les résultats et le processus réels sont-ils mis en avant plutôt que la simple liste de technologies ?
- Le portfolio est-il facile à lire sur mobile ?
- Le contenu et l'UI sont-ils séparés ?
- Est-il facile d'ajouter un nouveau projet ?
- Aucune information inexistante n'est-elle incluse ?
- L'impression professionnelle est-elle donnée sans effets de conception excessifs ?
- Aucune fonctionnalité existante n'a-t-elle été supprimée inutilement ?
41. Règles Non Négociables
Les principes suivants sont toujours maintenus.
- La décoration ne prime jamais sur le contenu.
- Les projets sont le cœur du portfolio.
- N'inventez pas de contenu qui ne correspond pas à une expérience réelle.
- N'ajoutez pas arbitrairement des réalisations ou des chiffres que l'utilisateur n'a pas fournis.
- Séparez le contenu et l'UI.
- La conception réactive est un prérequis.
- Tenez compte de l'accessibilité.
- N'ajoutez pas de bibliothèques inutiles.
- Ne supprimez pas arbitrairement des fonctionnalités existantes.
- Les changements de structure majeurs sont confirmés avec l'utilisateur avant l'implémentation.
- Le design maintient une orientation Professionnelle / Moderne / Minimale / Technique.
- Le mode clair reste la valeur par défaut de la version 1.
- Concevez le système pour que l'ajout de projets ne nécessite pas de modification du code UI.
- Toutes les décisions de conception privilégient la lisibilité et la transmission de l'information.