Communitygithub.com

ShaysFrame/moi

Système de marque et portfolio personnel pour Shay (ShaysFrame). Utilisez cette compétence pour créer, concevoir ou améliorer toute partie du site web personnel de Shay, y compris le portfolio, le blog, les pages de projets, le CV et le contenu d'auto-promotion.

Qu'est-ce que moi ?

Cette compétence définit la stratégie de marque et de design du portfolio personnel de M. MAHAFUJ RAHMAN (Shay), un développeur full-stack basé sur Astro. Elle fournit des directives détaillées pour créer un site éditorial, à fort contraste et orienté typographie, sans couleurs d'accentuation, où le noir, le blanc et les contrastes suffisent. La compétence couvre l'identité, la philosophie de design (palette de couleurs, typographie, animation), la structure du site, la pile technique (Astro, TypeScript, CSS personnalisé), l'ordre de priorité des projets, le ton rédactionnel et les règles de création de composants Astro. Idéale pour générer ou affiner des pages de portfolio, des héros, des pages de projets ou des CV, elle garantit une cohérence visuelle et technique avec la plateforme shay.pub. Elle prend en charge Astro, React/Preact pour les îles interactives, et le déploiement sur Vercel. L'approche d'animation privilégie le CSS pour les transitions de page et les effets au défilement, avec un seul élément « wow » dans le héros (révélation de lettres, grain, ou léger effet 3D). Les sujets à éviter incluent les dégradés, les boutons CTA bleus, les textes génériques et les animations superflues.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ShaysFrame/my/tree/HEAD/tools/portfolio-skill

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Portfolio de M. MAHAFUJ RAHMAN — Système de Marque & Construction

Vous construisez le portfolio personnel de M. Mahafuj Rahman, un développeur full-stack avec une large gamme de projets livrés dans les domaines mobile, web, backend, IoT et ML. Le portfolio doit communiquer profondeur, polyvalence et savoir-faire — pas seulement lister des technologies.


Identité

Nom : M. MAHAFUJ RAHMAN (connu sous le pseudo Shay en ligne) GitHub : ShaysFrame Site : shay.pub Identité technique : Généraliste full-stack — Flutter, Vue, Astro, React, Django, PHP, Docker, YOLO/CV Objectif de carrière : Décrocher un poste dans une entreprise technologique de premier plan en démontrant un travail réel et livré


Philosophie de Design

Esthétique : Éditoriale. Haut contraste. Menée par la typographie. Accrocheuse immédiatement. Ambiance : Propre et élégante — comme la couverture d'un magazine, pas une page d'atterrissage SaaS. Principe directeur : Chaque élément attire l'attention ou est supprimé.

Palette de Couleurs

--color-bg:        #0a0a0a   /* fond presque noir */
--color-surface:   #111111   /* cartes, panneaux */
--color-border:    #222222   /* séparateurs subtils */
--color-text:      #f5f5f5   /* texte principal — blanc cassé, pas un blanc pur agressif */
--color-muted:     #777777   /* texte secondaire/métadonnées */
--color-accent:    #ffffff   /* blanc pur — utilisé avec parcimonie pour un contraste maximal */
--color-highlight: #e8e8e8   /* états de survol, éléments sélectionnés */

Pas de couleurs d'accentuation. Pas de dégradés. Le noir, le blanc et le contraste font tout le travail.

Typographie

  • Affichage / Hero : Une seule police serif en gras ou grotesque à fort contraste. Suggestions : Playfair Display, Editorial New, PP Neue Montreal, Instrument Serif
  • Corps / Interface : Sans-serif géométrique propre. Inter, DM Sans, ou Geist
  • Code : JetBrains Mono ou Geist Mono
  • Règle : Moins de graisses, plus de tailles intentionnelles. Utilisez l'échelle, pas la couleur, pour créer une hiérarchie.

Mouvement & Interaction

Philosophie : Le mouvement doit sembler inévitable, pas décoratif. Chaque animation répond à la question « pourquoi cela bouge-t-il ? » — pour diriger l'attention, signaler un état, ou récompenser un défilement.

Couche 1 — CSS (toujours, sans dépendances)

  • Transitions de page : utilisez <ViewTransitions /> intégré d'Astro — zéro coût JS
  • États de survol : changements d'opacité, révélations de soulignement, échelle subtile (1.0 → 1.02)
  • États de focus : anneau visible utilisant --color-accent
  • Entrée : @keyframes CSS fadeUp pour le contenu au-dessus de la ligne de flottaison

Couche 2 — Animation pilotée par le défilement (CSS d'abord)

  • Utilisez l'animation-timeline: scroll() CSS native lorsque la prise en charge du navigateur le permet
  • Solution de repli : IntersectionObserver dans un petit utilitaire .ts — pas de bibliothèque nécessaire
  • Cartes de projet : fade + translateY(24px → 0) décalé à mesure qu'elles entrent dans le viewport
  • Titres de section : glissement depuis la gauche au défilement

Couche 3 — Élément « wow » du hero (un, et un seul)

  • Le hero obtient UN effet de mouvement signature. Options par ordre de préférence :
    1. Révélation décalée de lettres/mots — le nom du hero s'anime caractère par caractère (CSS uniquement)
    2. Superposition de bruit/grain — texture de grain CSS animée sur le fond sombre (CSS uniquement)
    3. Inclinaison 3D subtile — les cartes de projet s'inclinent légèrement au mouvement de la souris (Vanilla JS, ~15 lignes)
    4. Three.js / React Three Fiber — uniquement si un actif 3D spécifique est nécessaire (par exemple un logo géométrique tournant). Utilisez les compétences 3D-Animation-Creator ou 3D-Website-Asset-Generator pour générer l'actif séparément, puis intégrez-le comme un composant isolé unique.

Ce qu'il ne faut jamais faire

  • Arrière-plans Three.js en pleine page (tue les performances, distrait du contenu)
  • Animations en boucle ailleurs que dans le hero
  • Physique à ressort rebondissante (mauvais ton pour une esthétique éditoriale)
  • Défilement parallaxe sur le texte
  • Mouvement juste parce qu'un tutoriel l'a utilisé

Structure du Site

/                  → Hero + teaser des projets vedettes + brève introduction
/about             → Qui est Shay, parcours, philosophie, aperçu des compétences
/projects          → Grille de tous les projets avec balises de pile et descriptions courtes
/projects/[slug]   → Plongée approfondie dans un projet (problème, solution, pile, liens, captures d'écran)
/resume            → Vue du CV en ligne + lien PDF téléchargeable
/blog              → Liste des articles de blog (existe déjà dans Astro)
/blog/[slug]       → Article individuel (existe déjà)

Pile Technique

  • Framework : Astro (SSG, markdown d'abord, zéro JS par défaut, excellent SEO)
  • Langage des composants : Composants Astro + React/Preact (.tsx) pour les îles interactives
  • Langage : TypeScript partout — .ts, .tsx, .astro avec frontmatter typé. Jamais .js ou .jsx
  • Style : Propriétés personnalisées CSS (pas de Tailwind sauf demande spécifique de l'utilisateur)
  • Déploiement : Vercel
  • Contenu : Collections de contenu Astro pour les articles de blog et les projets

Priorité de Présentation des Projets

Lors de la construction des pages de projet, priorisez ces projets dans cet ordre (le plus impressionnant en premier) :

  1. Qifa — écosystème multi-applications (client, boutique, bureau, Docker, tableau de bord de logs personnalisé, ChatWoot)
  2. Open RTMS — système temps réel avec détection faciale YOLO v8n (l'angle ML est rare et impressionnant)
  3. XueHanYu — full-stack (Vue + Django), plateforme d'apprentissage du chinois
  4. NoorConnect — application + backend + firmware (IoT/embarqué est rare pour les développeurs web)
  5. Jidian Daojia — Flutter + PHP + uniapp, multi-plateforme
  6. LittleLemon — Projet de fin de certificat professionnel Meta (travail certifié)

Pour chaque page de projet, structurez le contenu comme suit :

  1. Accroche en une ligne (quel problème cela résout, pas quelle technologie cela utilise)
  2. Badges de la pile
  3. Le défi / ce qui l'a rendu intéressant
  4. Décisions clés prises
  5. Liens (GitHub, démo en direct si disponible)

Ton Rédactionnel

  • Direct. Confiant. Pas de remplissage.
  • Première personne si approprié (« J'ai construit... », « J'ai choisi... parce que... »)
  • Évitez : « passionné par », « automotivé », « axé sur les résultats », « synergies exploitées »
  • Des spécificités techniques plutôt que des affirmations vagues. Dites « construit un pipeline de détection faciale en temps réel avec YOLO v8n » pas « travaillé sur des projets de vision par ordinateur »

Directives pour les Composants

Lors de la génération de composants Astro pour ce portfolio :

  • Style d'exportation par défaut : fichiers .astro avec frontmatter ---
  • Utilisez les propriétés personnalisées CSS de la palette ci-dessus
  • Design responsive mobile-first
  • HTML sémantique (utilisation appropriée de <article>, <section>, <nav>, <main>)
  • Pas de styles en ligne sauf pour les valeurs dynamiques
  • Animations via CSS — keyframes dans global.css ou blocs <style> délimités
  • Îles interactives : utilisez la directive client:visible pour que le JS ne se charge que lorsque nécessaire

Ce qu'il faut Éviter

  • Texte de hero générique comme « Salut, je suis un développeur qui aime coder »
  • Dégradés violets, tout arrondi, boutons CTA bleus
  • Mises en page encombrées — embrassez l'espace blanc (ou noir)
  • Lister chaque technologie que vous avez touchée sans contexte
  • Un texte qui ressemble à un CV ; c'est un récit, pas une liste

Skills associés