Communitygithub.com

reason-machines/design-skills

Construye y personaliza un portafolio moderno para desarrolladores y diseñadores con Next.js, TypeScript y TailwindCSS, con efectos de escritura animados y diseños responsivos.

¿Qué es design-skills?

Esta habilidad proporciona una plantilla de portafolio personal moderna para desarrolladores y diseñadores, construida con Next.js 16, TypeScript y TailwindCSS. Incluye una interfaz de usuario oscura con acentos degradados púrpura, animaciones de escritura, secciones responsivas para proyectos, experiencia y habilidades, y está diseñada para ser fácilmente personalizable. Es útil para cualquier desarrollador o diseñador que quiera crear un portafolio profesional rápidamente sin empezar desde cero. La habilidad soporta plataformas como Vercel para despliegue y ofrece ejemplos de código detallados para personalizar fuentes, colores, proyectos, formularios de contacto y navegación con desplazamiento suave. El documento SKILL.md guía al usuario a través de la instalación, estructura del proyecto, configuración de componentes clave y solución de problemas comunes.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/reason-machines/design-skills/tree/HEAD/skills/figma-portfolio-nextjs

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

design-skills preview

Documentación

Figma Portfolio - Portafolio de Desarrollador Next.js

Habilidad de ara.so — Colección de habilidades de diseño.

Una plantilla de portafolio personal para desarrolladores y diseñadores, construida con Next.js 16, TypeScript y TailwindCSS. Cuenta con una interfaz oscura con acentos degradados púrpura, efectos de escritura animados, diseños responsivos y secciones para mostrar proyectos, experiencia y habilidades creativas.

Instalación

# Clonar el repositorio
git clone [email protected]:ibrahimmemonn/Figma_Portfolio.git

# Navegar al directorio del proyecto
cd Figma_Portfolio/

# Instalar dependencias
npm install

# Ejecutar servidor de desarrollo
npm run dev

El servidor de desarrollo se inicia en http://localhost:3000.

Estructura del Proyecto

Figma_Portfolio/
├── app/
│   ├── page.tsx           # Página principal
│   ├── layout.tsx         # Layout raíz con configuración de fuentes
│   └── globals.css        # Estilos globales con Tailwind
├── components/
│   ├── Hero.tsx           # Sección Hero con animación de escritura
│   ├── Projects.tsx       # Sección de proyectos
│   ├── Experience.tsx     # Línea de tiempo de experiencia
│   ├── Skills.tsx         # Visualización de habilidades
│   └── Contact.tsx        # Sección de contacto
├── public/
│   ├── projects/          # Imágenes de proyectos
│   └── assets/            # Iconos y medios
└── tailwind.config.ts     # Configuración de Tailwind

Características Clave y Configuración

Configuración de Fuentes

El portafolio usa la fuente Poppins optimizada con next/font:

// app/layout.tsx
import { Poppins } from 'next/font/google';

const poppins = Poppins({
  subsets: ['latin'],
  weight: ['300', '400', '500', '600', '700', '800', '900'],
  variable: '--font-poppins',
});

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en" className={poppins.variable}>
      <body>{children}</body>
    </html>
  );
}

Sección Hero con Animación de Escritura

// components/Hero.tsx
'use client';
import { useState, useEffect } from 'react';

export default function Hero() {
  const [text, setText] = useState('');
  const [isDeleting, setIsDeleting] = useState(false);
  const [loopNum, setLoopNum] = useState(0);
  const [typingSpeed, setTypingSpeed] = useState(150);

  const roles = ['Software Engineer', 'UI/UX Designer', 'Full Stack Developer'];

  useEffect(() => {
    const handleType = () => {
      const i = loopNum % roles.length;
      const fullText = roles[i];

      setText(
        isDeleting
          ? fullText.substring(0, text.length - 1)
          : fullText.substring(0, text.length + 1)
      );

      setTypingSpeed(isDeleting ? 50 : 150);

      if (!isDeleting && text === fullText) {
        setTimeout(() => setIsDeleting(true), 1000);
      } else if (isDeleting && text === '') {
        setIsDeleting(false);
        setLoopNum(loopNum + 1);
      }
    };

    const timer = setTimeout(handleType, typingSpeed);
    return () => clearTimeout(timer);
  }, [text, isDeleting, loopNum, typingSpeed, roles]);

  return (
    <section className="min-h-screen flex items-center justify-center px-4">
      <div className="max-w-4xl mx-auto text-center">
        <h1 className="text-5xl md:text-7xl font-bold mb-6">
          Hola, soy <span className="bg-gradient-to-r from-purple-400 to-pink-600 bg-clip-text text-transparent">Tu Nombre</span>
        </h1>
        <h2 className="text-2xl md:text-4xl mb-8">
          <span className="text-gray-400">{text}</span>
          <span className="animate-pulse">|</span>
        </h2>
        <p className="text-gray-300 text-lg max-w-2xl mx-auto">
          Construyendo experiencias digitales que combinan diseño estético con funcionalidad poderosa.
        </p>
      </div>
    </section>
  );
}

Añadir Proyectos

// components/Projects.tsx
interface Project {
  title: string;
  description: string;
  image: string;
  link: string;
  github?: string;
  tags: string[];
}

const projects: Project[] = [
  {
    title: 'Plataforma de Comercio Electrónico',
    description: 'Solución completa de comercio electrónico con Next.js, Stripe y MongoDB',
    image: '/projects/ecommerce.png',
    link: 'https://example.com',
    github: 'https://github.com/username/project',
    tags: ['Next.js', 'TypeScript', 'Stripe', 'MongoDB'],
  },
  {
    title: 'Panel de Control de Portafolio',
    description: 'Panel de análisis para seguimiento de métricas del portafolio',
    image: '/projects/dashboard.png',
    link: 'https://example.com',
    tags: ['React', 'Chart.js', 'TailwindCSS'],
  },
];

export default function Projects() {
  return (
    <section className="py-20 px-4">
      <h2 className="text-4xl font-bold text-center mb-12">
        Proyectos <span className="bg-gradient-to-r from-purple-400 to-pink-600 bg-clip-text text-transparent">Destacados</span>
      </h2>
      <div className="grid md:grid-cols-2 lg:grid-cols-3 gap-8 max-w-6xl mx-auto">
        {projects.map((project, index) => (
          <div key={index} className="bg-gray-800/50 rounded-lg overflow-hidden hover:transform hover:scale-105 transition-all duration-300">
            <img src={project.image} alt={project.title} className="w-full h-48 object-cover" />
            <div className="p-6">
              <h3 className="text-xl font-semibold mb-2">{project.title}</h3>
              <p className="text-gray-400 mb-4">{project.description}</p>
              <div className="flex flex-wrap gap-2 mb-4">
                {project.tags.map((tag, i) => (
                  <span key={i} className="px-3 py-1 bg-purple-500/20 text-purple-300 rounded-full text-sm">
                    {tag}
                  </span>
                ))}
              </div>
              <div className="flex gap-4">
                <a href={project.link} className="text-purple-400 hover:text-purple-300">
                  Demo en Vivo →
                </a>
                {project.github && (
                  <a href={project.github} className="text-gray-400 hover:text-gray-300">
                    GitHub →
                  </a>
                )}
              </div>
            </div>
          </div>
        ))}
      </div>
    </section>
  );
}

Personalizar Colores del Tema

// tailwind.config.ts
import type { Config } from 'tailwindcss';

const config: Config = {
  content: [
    './pages/**/*.{js,ts,jsx,tsx,mdx}',
    './components/**/*.{js,ts,jsx,tsx,mdx}',
    './app/**/*.{js,ts,jsx,tsx,mdx}',
  ],
  theme: {
    extend: {
      colors: {
        primary: {
          50: '#faf5ff',
          100: '#f3e8ff',
          500: '#a855f7',
          600: '#9333ea',
          700: '#7e22ce',
        },
      },
      backgroundImage: {
        'gradient-radial': 'radial-gradient(var(--tw-gradient-stops))',
        'gradient-conic': 'conic-gradient(from 180deg at 50% 50%, var(--tw-gradient-stops))',
      },
    },
  },
  plugins: [],
};

export default config;

Añadir Analíticas

// app/layout.tsx
import { Analytics } from '@vercel/analytics/react';

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <body>
        {children}
        <Analytics />
      </body>
    </html>
  );
}

Despliegue

Desplegar en Vercel

# Instalar CLI de Vercel
npm i -g vercel

# Desplegar
vercel

# Desplegar a producción
vercel --prod

O conecta tu repositorio de GitHub a Vercel para despliegues automáticos en cada push a main.

Variables de Entorno

# .env.local (no se sube a git)
NEXT_PUBLIC_SITE_URL=https://tu-dominio.com
NEXT_PUBLIC_GA_ID=tu-id-de-google-analytics

Patrones Comunes de Personalización

Añadir un Formulario de Contacto

// components/Contact.tsx
'use client';
import { useState } from 'react';

export default function Contact() {
  const [formData, setFormData] = useState({
    name: '',
    email: '',
    message: '',
  });

  const handleSubmit = async (e: React.FormEvent) => {
    e.preventDefault();
    // Integrar con tu servicio de correo preferido
    const response = await fetch('/api/contact', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(formData),
    });
    
    if (response.ok) {
      alert('¡Mensaje enviado con éxito!');
      setFormData({ name: '', email: '', message: '' });
    }
  };

  return (
    <section className="py-20 px-4">
      <div className="max-w-2xl mx-auto">
        <h2 className="text-4xl font-bold text-center mb-12">Ponte en Contacto</h2>
        <form onSubmit={handleSubmit} className="space-y-6">
          <input
            type="text"
            placeholder="Tu Nombre"
            value={formData.name}
            onChange={(e) => setFormData({ ...formData, name: e.target.value })}
            className="w-full px-4 py-3 bg-gray-800 rounded-lg focus:outline-none focus:ring-2 focus:ring-purple-500"
            required
          />
          <input
            type="email"
            placeholder="Tu Correo Electrónico"
            value={formData.email}
            onChange={(e) => setFormData({ ...formData, email: e.target.value })}
            className="w-full px-4 py-3 bg-gray-800 rounded-lg focus:outline-none focus:ring-2 focus:ring-purple-500"
            required
          />
          <textarea
            placeholder="Tu Mensaje"
            value={formData.message}
            onChange={(e) => setFormData({ ...formData, message: e.target.value })}
            rows={5}
            className="w-full px-4 py-3 bg-gray-800 rounded-lg focus:outline-none focus:ring-2 focus:ring-purple-500"
            required
          />
          <button
            type="submit"
            className="w-full py-3 bg-gradient-to-r from-purple-500 to-pink-600 rounded-lg font-semibold hover:opacity-90 transition-opacity"
          >
            Enviar Mensaje
          </button>
        </form>
      </div>
    </section>
  );
}

Navegación con Desplazamiento Suave

// components/Navigation.tsx
export default function Navigation() {
  const scrollToSection = (id: string) => {
    const element = document.getElementById(id);
    element?.scrollIntoView({ behavior: 'smooth' });
  };

  return (
    <nav className="fixed top-0 w-full bg-gray-900/80 backdrop-blur-sm z-50">
      <div className="max-w-6xl mx-auto px-4 py-4 flex justify-between items-center">
        <div className="text-xl font-bold">Portafolio</div>
        <div className="flex gap-6">
          <button onClick={() => scrollToSection('projects')} className="hover:text-purple-400">
            Proyectos
          </button>
          <button onClick={() => scrollToSection('experience')} className="hover:text-purple-400">
            Experiencia
          </button>
          <button onClick={() => scrollToSection('contact')} className="hover:text-purple-400">
            Contacto
          </button>
        </div>
      </div>
    </nav>
  );
}

Solución de Problemas

Las Imágenes No Cargan

Asegúrate de que las imágenes estén en el directorio public y se referencien con rutas absolutas:

<img src="/projects/miproyecto.png" alt="Proyecto" />

La Animación de Escritura No Funciona

Verifica que el componente esté marcado como 'use client' para la interactividad del lado del cliente:

'use client';
import { useState, useEffect } from 'react';

Los Estilos de Tailwind No se Aplican

Verifica que las rutas de contenido en tailwind.config.ts incluyan todos los directorios de componentes:

content: [
  './app/**/*.{js,ts,jsx,tsx,mdx}',
  './components/**/*.{js,ts,jsx,tsx,mdx}',
],

Errores de Compilación

Limpia la caché de Next.js y recompila:

rm -rf .next
npm run build

Skills relacionados