Communitygithub.com

reason-machines/design-skills - 피그마 포트폴리오

Next.js, TypeScript, TailwindCSS를 사용하여 현대적인 개발자/디자이너 포트폴리오를 구축하고 커스터마이징합니다. 애니메이션 타이핑 효과와 반응형 레이아웃을 제공합니다.

design-skills - 피그마 포트폴리오란 무엇인가요?

이 스킬은 Next.js 16, TypeScript, TailwindCSS를 기반으로 구축된 개인 포트폴리오 템플릿입니다. 개발자와 디자이너가 자신의 프로젝트, 경력, 기술을 세련된 다크 테마 UI와 보라색 그라데이션 악센트, 애니메이션 타이핑 효과로 선보일 수 있도록 설계되었습니다. 주요 기능으로는 영웅 섹션의 타이핑 애니메이션, 프로젝트 쇼케이스, 경력 타임라인, 기술 목록, 연락처 양식이 포함되어 있습니다. Vercel에 쉽게 배포할 수 있으며, 테마 색상, 폰트, 콘텐츠를 완전히 커스터마이징할 수 있습니다. Smooth Scroll 내비게이션과 Vercel Analytics 통합을 지원하여 모던한 웹 경험을 제공합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

미리보기

스킬 README에서

design-skills - 피그마 포트폴리오 preview

문서

Figma 포트폴리오 - Next.js 개발자 포트폴리오

ara.so의 스킬 — 디자인 스킬 컬렉션

Next.js 16, TypeScript, TailwindCSS로 구축된 개발자 및 디자이너를 위한 개인 포트폴리오 템플릿입니다. 깔끔한 다크 테마 UI, 보라색 그라데이션 악센트, 애니메이션 타이핑 효과, 반응형 레이아웃, 그리고 프로젝트, 경력, 창의적인 기술을 선보일 수 있는 섹션을 제공합니다.

설치

# 저장소 클론
git clone [email protected]:ibrahimmemonn/Figma_Portfolio.git

# 프로젝트 디렉토리로 이동
cd Figma_Portfolio/

# 의존성 설치
npm install

# 개발 서버 실행
npm run dev

개발 서버는 http://localhost:3000에서 실행됩니다.

프로젝트 구조

Figma_Portfolio/
├── app/
│   ├── page.tsx           # 메인 랜딩 페이지
│   ├── layout.tsx         # 폰트 설정이 포함된 루트 레이아웃
│   └── globals.css        # Tailwind가 포함된 글로벌 스타일
├── components/
│   ├── Hero.tsx           # 타이핑 애니메이션이 포함된 히어로 섹션
│   ├── Projects.tsx       # 프로젝트 쇼케이스 섹션
│   ├── Experience.tsx     # 경력 타임라인
│   ├── Skills.tsx         # 기술 표시
│   └── Contact.tsx        # 연락처 섹션
├── public/
│   ├── projects/          # 프로젝트 이미지
│   └── assets/            # 아이콘 및 미디어
└── tailwind.config.ts     # Tailwind 설정

주요 기능 및 설정

폰트 설정

포트폴리오는 next/font로 최적화된 Poppins 폰트를 사용합니다:

// 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>
  );
}

타이핑 애니메이션이 포함된 히어로 섹션

// 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 = ['소프트웨어 엔지니어', 'UI/UX 디자이너', '풀스택 개발자'];

  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">
          안녕하세요, 저는 <span className="bg-gradient-to-r from-purple-400 to-pink-600 bg-clip-text text-transparent">[당신의 이름]</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">
          심미적인 디자인과 강력한 기능을 결합한 디지털 경험을 구축합니다.
        </p>
      </div>
    </section>
  );
}

프로젝트 추가하기

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

const projects: Project[] = [
  {
    title: '이커머스 플랫폼',
    description: 'Next.js, Stripe, MongoDB로 구축된 풀스택 이커머스 솔루션',
    image: '/projects/ecommerce.png',
    link: 'https://example.com',
    github: 'https://github.com/username/project',
    tags: ['Next.js', 'TypeScript', 'Stripe', 'MongoDB'],
  },
  {
    title: '포트폴리오 대시보드',
    description: '포트폴리오 메트릭 추적을 위한 분석 대시보드',
    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">
        주요 <span className="bg-gradient-to-r from-purple-400 to-pink-600 bg-clip-text text-transparent">프로젝트</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">
                  라이브 데모 →
                </a>
                {project.github && (
                  <a href={project.github} className="text-gray-400 hover:text-gray-300">
                    GitHub →
                  </a>
                )}
              </div>
            </div>
          </div>
        ))}
      </div>
    </section>
  );
}

테마 색상 커스터마이징

// 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;

분석 도구 추가

// 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>
  );
}

배포

Vercel에 배포

# Vercel CLI 설치
npm i -g vercel

# 배포
vercel

# 프로덕션 배포
vercel --prod

또는 GitHub 저장소를 Vercel에 연결하여 main 브랜치에 푸시할 때마다 자동 배포되도록 설정할 수 있습니다.

환경 변수

# .env.local (git에 커밋되지 않음)
NEXT_PUBLIC_SITE_URL=https://your-domain.com
NEXT_PUBLIC_GA_ID=your-google-analytics-id

일반적인 커스터마이징 패턴

연락처 양식 추가

// 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();
    // 선호하는 이메일 서비스와 통합
    const response = await fetch('/api/contact', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(formData),
    });
    
    if (response.ok) {
      alert('메시지가 성공적으로 전송되었습니다!');
      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">연락하기</h2>
        <form onSubmit={handleSubmit} className="space-y-6">
          <input
            type="text"
            placeholder="이름"
            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="이메일"
            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="메시지"
            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"
          >
            메시지 보내기
          </button>
        </form>
      </div>
    </section>
  );
}

부드러운 스크롤 내비게이션

// 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">포트폴리오</div>
        <div className="flex gap-6">
          <button onClick={() => scrollToSection('projects')} className="hover:text-purple-400">
            프로젝트
          </button>
          <button onClick={() => scrollToSection('experience')} className="hover:text-purple-400">
            경력
          </button>
          <button onClick={() => scrollToSection('contact')} className="hover:text-purple-400">
            연락처
          </button>
        </div>
      </div>
    </nav>
  );
}

문제 해결

이미지가 로드되지 않는 경우

이미지가 public 디렉토리에 있는지 확인하고 절대 경로로 참조하세요:

<img src="/projects/myproject.png" alt="프로젝트" />

타이핑 애니메이션이 작동하지 않는 경우

컴포넌트가 클라이언트 측 상호작용을 위해 'use client'로 표시되었는지 확인하세요:

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

Tailwind 스타일이 적용되지 않는 경우

tailwind.config.ts의 콘텐츠 경로에 모든 컴포넌트 디렉토리가 포함되었는지 확인하세요:

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

빌드 오류

Next.js 캐시를 지우고 다시 빌드하세요:

rm -rf .next
npm run build

관련 스킬