Communitygithub.com

M. MAHAFUJ RAHMAN — Sistema de Portafolio y Marca

Sistema de portafolio personal y marca para Shay (ShaysFrame). Úsalo al construir o mejorar el sitio web, blog, páginas de proyectos, currículum o cualquier contenido promocional de Shay.

¿Qué es M. MAHAFUJ RAHMAN — Sistema de Portafolio y Marca?

Esta habilidad define la marca y el sistema de construcción para el portafolio personal de M. Mahafuj Rahman (Shay), un desarrollador full-stack con experiencia en Flutter, Vue, Astro, React, Django, PHP, Docker y visión por computadora. El objetivo principal es crear un sitio web de portafolio que comunique profundidad y rango técnico, no solo una lista de tecnologías. La habilidad es compatible con Astro (SSG), React/Preact para componentes interactivos, TypeScript, CSS personalizado y despliegue en Vercel. Proporciona pautas completas de diseño estético (editorial, alto contraste, tipografía-led), una paleta de colores en blanco y negro, filosofía de animación por capas (CSS primero, con opciones para efectos hero como revelado de letras o ruido animado), estructura del sitio (inicio, sobre mí, proyectos, currículum, blog) y pautas de contenido. La instrucción principal es priorizar proyectos complejos como Qifa (ecosistema multi-app), Open RTMS (detección facial en tiempo real con YOLO) y XueHanYu (plataforma de aprendizaje de chino), estructurando cada página de proyecto con un gancho centrado en el problema, insignias técnicas y decisiones clave. La habilidad también establece un tono directo y técnico, evitando clichés, y especifica qué evitar (gradientes, botones genéricos, diseños desordenados).

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Sistema de Portafolio y Marca de M. MAHAFUJ RAHMAN

Estás construyendo el portafolio personal de M. Mahafuj Rahman, un desarrollador full-stack con una amplia gama de proyectos entregados en móvil, web, backend, IoT y ML. El portafolio debe comunicar profundidad, alcance y artesanía, no solo enumerar tecnologías.


Identidad

Nombre: M. MAHAFUJ RAHMAN (conocido como Shay en línea) GitHub: ShaysFrame Sitio: shay.pub Identidad tecnológica: Generalista full-stack — Flutter, Vue, Astro, React, Django, PHP, Docker, YOLO/CV Objetivo profesional: Conseguir un puesto en una empresa tecnológica de primer nivel demostrando trabajo real entregado


Filosofía de Diseño

Estética: Editorial. Alto contraste. Liderada por tipografía. Capta la atención al instante. Ambiente: Limpia y elegante — como la portada de una revista, no una página de aterrizaje de SaaS. Principio rector: Cada elemento o capta la atención o es eliminado.

Paleta de Colores

--color-bg:        #0a0a0a   /* fondo casi negro */
--color-surface:   #111111   /* tarjetas, paneles */
--color-border:    #222222   /* divisores sutiles */
--color-text:      #f5f5f5   /* texto principal — blanco apagado, no blanco puro agresivo */
--color-muted:     #777777   /* texto secundario/metadatos */
--color-accent:    #ffffff   /* blanco puro — usado con moderación para máximo contraste */
--color-highlight: #e8e8e8   /* estados hover, elementos seleccionados */

Sin colores de acento. Sin degradados. El negro, el blanco y el contraste hacen todo el trabajo.

Tipografía

  • Display / Hero: Una única tipografía serif o grotesca de alto contraste. Sugerencias: Playfair Display, Editorial New, PP Neue Montreal, Instrument Serif
  • Cuerpo / UI: Sans-serif geométrica y limpia. Inter, DM Sans o Geist
  • Código: JetBrains Mono o Geist Mono
  • Regla: Menos pesos de fuente, más tamaños intencionales. Usa escala, no color, para crear jerarquía.

Movimiento e Interacción

Filosofía: El movimiento debe sentirse inevitable, no decorativo. Cada animación responde a "¿por qué se mueve esto?" — para dirigir la atención, señalar el estado o recompensar un desplazamiento.

Capa 1 — CSS (siempre, sin dependencias)

  • Transiciones de página: usar <ViewTransitions /> incorporado de Astro — costo JS cero
  • Estados hover: cambios de opacidad, revelaciones de subrayado, escala sutil (1.0 → 1.02)
  • Estados focus: anillo visible usando --color-accent
  • Entrada: @keyframes CSS fadeUp para contenido visible inicialmente

Capa 2 — Animación impulsada por desplazamiento (CSS primero)

  • Usar animation-timeline: scroll() CSS nativo donde el navegador lo permita
  • Respaldo: IntersectionObserver en una pequeña utilidad .ts — sin necesidad de librería
  • Tarjetas de proyecto: fade + translateY(24px → 0) escalonado al entrar en el viewport
  • Encabezados de sección: deslizar desde la izquierda al hacer scroll

Capa 3 — Elemento "wow" del Hero (uno, y solo uno)

  • El hero obtiene UN efecto de movimiento distintivo. Opciones en orden de preferencia:
    1. Revelación escalonada de letras/palabras — el nombre del héroe se anima carácter por carácter (solo CSS)
    2. Superposición de ruido/grano — textura CSS animada sobre el fondo oscuro (solo CSS)
    3. Inclinación 3D sutil — las tarjetas de proyecto se inclinan ligeramente al mover el ratón (Vanilla JS, ~15 líneas)
    4. Three.js / React Three Fiber — solo si se necesita un activo 3D específico (por ejemplo, un logotipo geométrico giratorio). Usa las habilidades 3D-Animation-Creator o 3D-Website-Asset-Generator para generar el activo por separado, luego incorpóralo como un único componente aislado.

Lo que nunca se debe hacer

  • Fondos Three.js de página completa (mata el rendimiento, distrae del contenido)
  • Animaciones en bucle en cualquier lugar excepto el hero
  • Física de resorte con rebote (tono incorrecto para la estética editorial)
  • Desplazamiento con paralaje en texto
  • Movimiento solo porque un tutorial lo usó

Estructura del Sitio

/                  → Hero + avance de proyectos destacados + breve introducción
/about             → Quién es Shay, antecedentes, filosofía, resumen de habilidades
/projects          → Cuadrícula de todos los proyectos con etiquetas tecnológicas y descripciones cortas
/projects/[slug]   → Inmersión profunda en el proyecto (problema, solución, pila, enlaces, capturas de pantalla)
/resume            → Vista de currículum en línea + enlace de PDF descargable
/blog              → Lista de publicaciones de blog (ya existe en Astro)
/blog/[slug]       → Publicación individual (ya existe)

Pila Tecnológica

  • Framework: Astro (SSG, primero en markdown, cero JS por defecto, excelente SEO)
  • Lenguaje de componentes: Componentes Astro + React/Preact (.tsx) para islas interactivas
  • Lenguaje: TypeScript en todas partes — .ts, .tsx, .astro con frontmatter tipado. Nunca .js o .jsx
  • Estilo: Propiedades personalizadas CSS (sin Tailwind a menos que el usuario lo solicite específicamente)
  • Despliegue: Vercel
  • Contenido: Colecciones de Contenido Astro para publicaciones de blog y proyectos

Prioridad de Exhibición de Proyectos

Al construir páginas de proyecto, prioriza estos proyectos en este orden (del más impresionante al menos):

  1. Qifa — ecosistema de múltiples aplicaciones (cliente, tienda, oficina, Docker, panel de registro personalizado, ChatWoot)
  2. Open RTMS — sistema en tiempo real con detección facial YOLO v8n (el ángulo de ML es raro e impresionante)
  3. XueHanYu — full-stack (Vue + Django), plataforma de aprendizaje de idioma chino
  4. NoorConnect — aplicación + backend + firmware (IoT/embebido es raro para desarrolladores web)
  5. Jidian Daojia — Flutter + PHP + uniapp, multiplataforma
  6. LittleLemon — proyecto final del Certificado Profesional de Meta (trabajo acreditado)

Para cada página de proyecto, estructura el contenido como:

  1. Gancho de una línea (qué problema resuelve, no qué tecnología usa)
  2. Insignias de pila tecnológica
  3. El desafío / qué lo hizo interesante
  4. Decisiones clave tomadas
  5. Enlaces (GitHub, demo en vivo si está disponible)

Tono de Escritura

  • Directo. Seguro. Sin relleno.
  • Primera persona cuando sea apropiado ("Construí...", "Elegí... porque...")
  • Evitar: "apasionado por", "automotivado", "impulsado por resultados", "sinergias aprovechadas"
  • Especificaciones técnicas > afirmaciones vagas. Di "construí un pipeline de detección facial en tiempo real usando YOLO v8n", no "trabajé en proyectos de visión por computadora"

Pautas de Componentes

Al generar componentes Astro para este portafolio:

  • Estilo de exportación predeterminado: archivos .astro con frontmatter ---
  • Usar propiedades personalizadas CSS de la paleta anterior
  • Diseño responsivo mobile-first
  • HTML semántico (uso correcto de <article>, <section>, <nav>, <main>)
  • Sin estilos en línea excepto valores dinámicos
  • Animaciones mediante CSS — keyframes en global.css o bloques <style> con ámbito
  • Islas interactivas: usar directiva client:visible para que JS solo se cargue cuando sea necesario

Qué Evitar

  • Texto genérico de héroe como "Hola, soy un desarrollador al que le encanta programar"
  • Degradados morados, todo redondeado, botones CTA azules
  • Diseños desordenados — abraza el espacio en blanco (o negro)
  • Enumerar cada tecnología que has tocado sin contexto
  • Texto que suene a CV; esto es una narrativa, no una lista

Skills relacionados