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 SansoGeist - Código:
JetBrains MonooGeist 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:
@keyframesCSSfadeUppara contenido visible inicialmente
Capa 2 — Animación impulsada por desplazamiento (CSS primero)
- Usar
animation-timeline: scroll()CSS nativo donde el navegador lo permita - Respaldo:
IntersectionObserveren 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:
- Revelación escalonada de letras/palabras — el nombre del héroe se anima carácter por carácter (solo CSS)
- Superposición de ruido/grano — textura CSS animada sobre el fondo oscuro (solo CSS)
- Inclinación 3D sutil — las tarjetas de proyecto se inclinan ligeramente al mover el ratón (Vanilla JS, ~15 líneas)
- 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-Creatoro3D-Website-Asset-Generatorpara 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,.astrocon frontmatter tipado. Nunca.jso.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):
- Qifa — ecosistema de múltiples aplicaciones (cliente, tienda, oficina, Docker, panel de registro personalizado, ChatWoot)
- Open RTMS — sistema en tiempo real con detección facial YOLO v8n (el ángulo de ML es raro e impresionante)
- XueHanYu — full-stack (Vue + Django), plataforma de aprendizaje de idioma chino
- NoorConnect — aplicación + backend + firmware (IoT/embebido es raro para desarrolladores web)
- Jidian Daojia — Flutter + PHP + uniapp, multiplataforma
- LittleLemon — proyecto final del Certificado Profesional de Meta (trabajo acreditado)
Para cada página de proyecto, estructura el contenido como:
- Gancho de una línea (qué problema resuelve, no qué tecnología usa)
- Insignias de pila tecnológica
- El desafío / qué lo hizo interesante
- Decisiones clave tomadas
- 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
.astrocon 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.csso bloques<style>con ámbito - Islas interactivas: usar directiva
client:visiblepara 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