M. MAHAFUJ RAHMAN의 포트폴리오 — 브랜드 및 빌드 시스템
당신은 풀스택 개발자 M. Mahafuj Rahman의 개인 포트폴리오를 구축하고 있습니다. 그는 모바일, 웹, 백엔드, IoT, ML에 이르기까지 다양한 출시 프로젝트를 보유하고 있습니다. 포트폴리오는 단순히 기술을 나열하는 것이 아니라 깊이, 범위, 기술을 전달해야 합니다.
정체성
이름: M. MAHAFUJ RAHMAN (온라인에서는 Shay로 활동)
GitHub: ShaysFrame
사이트: shay.pub
기술 정체성: 풀스택 제너럴리스트 — Flutter, Vue, Astro, React, Django, PHP, Docker, YOLO/CV
경력 목표: 실제 출시된 작업을 통해 최고의 기술 회사에서 역할을 맡는 것
디자인 철학
미학: 에디토리얼. 고대비. 타이포그래피 중심. 즉시 시선을 사로잡음.
분위기: 깔끔하고 우아함 — SaaS 랜딩 페이지가 아니라 잡지 표지처럼.
지침 원칙: 모든 요소는 주목을 끌거나 제거된다.
색상 팔레트
--color-bg: #0a0a0a /* 거의 검은색 배경 */
--color-surface: #111111 /* 카드, 패널 */
--color-border: #222222 /* 미묘한 구분선 */
--color-text: #f5f5f5 /* 기본 텍스트 — 순수 흰색이 아닌 부드러운 흰색 */
--color-muted: #777777 /* 보조/메타데이터 텍스트 */
--color-accent: #ffffff /* 순수 흰색 — 최대 대비를 위해 아껴서 사용 */
--color-highlight: #e8e8e8 /* 호버 상태, 선택된 항목 */
색상 악센트 없음. 그라디언트 없음. 검은색, 흰색, 대비가 모든 역할을 합니다.
타이포그래피
- 디스플레이 / 히어로: 굵은 세리프 또는 고대비 그로테스크 디스플레이 글꼴 하나.
추천:
Playfair Display,Editorial New,PP Neue Montreal,Instrument Serif - 본문 / UI: 깔끔한 기하학 산세리프.
Inter,DM Sans, 또는Geist - 코드:
JetBrains Mono또는Geist Mono - 규칙: 더 적은 글꼴 두께, 더 의도적인 크기 조절. 계층 구조를 만들기 위해 색상이 아닌 크기를 사용합니다.
모션 및 상호작용
철학: 모션은 불가피하게 느껴져야 하며 장식적이어서는 안 됩니다. 모든 애니메이션은 "왜 이게 움직이는가?"라는 질문에 답합니다. — 주의를 집중시키거나, 상태를 알리거나, 스크롤을 보상하기 위해.
레이어 1 — CSS (항상, 종속성 없음)
- 페이지 전환: Astro의 내장
<ViewTransitions />사용 — JS 비용 제로 - 호버 상태: 불투명도 변화, 밑줄 드러내기, 미묘한 확대(1.0 → 1.02)
- 포커스 상태:
--color-accent를 사용한 눈에 띄는 링 - 진입: 접힌 부분 위 콘텐츠를 위한 CSS
@keyframesfadeUp
레이어 2 — 스크롤 기반 애니메이션 (CSS 우선)
- 브라우저 지원이 가능한 곳에서는 기본 CSS
animation-timeline: scroll()사용 - 대체: 작은
.ts유틸리티의IntersectionObserver— 라이브러리 불필요 - 프로젝트 카드: 뷰포트 진입 시 지연된
fade + translateY(24px → 0) - 섹션 제목: 스크롤 시 왼쪽에서 슬라이드 인
레이어 3 — 히어로 "와우" 요소 (하나, 그리고 오직 하나만)
- 히어로는 하나의 시그니처 모션 효과를 얻습니다. 선호 순서대로 옵션:
- 지연된 글자/단어 드러내기 — 히어로 이름이 문자별로 애니메이션으로 나타남 (CSS만)
- 노이즈/그레인 오버레이 — 어두운 배경 위에 CSS 그레인 텍스처 애니메이션 (CSS만)
- 미묘한 3D 기울임 — 프로젝트 카드가 마우스 움직임에 따라 약간 기울어짐 (Vanilla JS, 약 15줄)
- Three.js / React Three Fiber — 특정 3D 에셋(예: 회전하는 기하학적 로고)이 필요한 경우에만.
3D-Animation-Creator또는3D-Website-Asset-Generator스킬을 사용하여 에셋을 별도로 생성한 다음, 단일 격리된 컴포넌트로 임베드합니다.
절대 하지 말아야 할 것
- 전체 페이지 Three.js 배경 (성능 저하, 콘텐츠에서 주의 분산)
- 히어로를 제외한 모든 곳에서의 반복 애니메이션
- 바운시 스프링 물리 (에디토리얼 미학에 잘못된 톤)
- 텍스트에 시차 스크롤링
- 튜토리얼에서 사용했다는 이유만으로 모션 사용
사이트 구조
/ → 히어로 + 주요 프로젝트 티저 + 간단한 소개
/about → 셰이가 누구인지, 배경, 철학, 기술 개요
/projects → 스택 태그와 짧은 설명이 있는 모든 프로젝트 그리드
/projects/[slug] → 개별 프로젝트 심층 분석 (문제, 해결책, 스택, 링크, 스크린샷)
/resume → 인라인 이력서 보기 + 다운로드 가능한 PDF 링크
/blog → 블로그 게시물 목록 (Astro에 이미 존재)
/blog/[slug] → 개별 게시물 (이미 존재)
기술 스택
- 프레임워크: Astro (SSG, 마크다운 우선, 기본 JS 제로, 우수한 SEO)
- 컴포넌트 언어: Astro 컴포넌트 + 대화형 섬(islands)을 위한 React/Preact (
.tsx) - 언어: 모든 곳에서 TypeScript —
.ts,.tsx,.astro(타입이 지정된 frontmatter 사용). 절대.js또는.jsx사용 금지 - 스타일링: CSS 커스텀 속성 (사용자가 특별히 요청하지 않는 한 Tailwind 사용 금지)
- 배포: Vercel
- 콘텐츠: 블로그 게시물 및 프로젝트를 위한 Astro Content Collections
프로젝트 우선순위
프로젝트 페이지를 구축할 때 다음 프로젝트를 이 순서대로 우선시합니다 (가장 인상적인 것부터):
- Qifa — 다중 앱 생태계 (클라이언트, 샵, 오피스, Docker, 커스텀 로깅 대시보드, ChatWoot)
- Open RTMS — YOLO v8n 얼굴 감지 기능을 갖춘 실시간 시스템 (ML 각도는 드물고 인상적임)
- XueHanYu — 풀스택 (Vue + Django), 중국어 학습 플랫폼
- NoorConnect — 앱 + 백엔드 + 펌웨어 (IoT/임베디드는 웹 개발자에게 드문 분야)
- Jidian Daojia — Flutter + PHP + uniapp, 멀티 플랫폼
- LittleLemon — Meta Professional Certificate 캡스톤 (공인된 작업)
각 프로젝트 페이지의 콘텐츠 구조:
- 한 줄 훅 (어떤 기술을 사용하는지가 아니라 어떤 문제를 해결하는지)
- 스택 배지
- 도전 과제 / 흥미로웠던 점
- 내린 주요 결정
- 링크 (GitHub, 가능하면 라이브 데모)
작성 톤
- 직접적. 자신감. 불필요한 내용 없음.
- 적절한 곳에 1인칭 사용 ("I built...", "I chose... because...")
- 피해야 할 표현: "passionate about", "self-motivated", "results-driven", "leveraged synergies"
- 막연한 주장보다 구체적인 기술 사항. "YOLO v8n을 사용한 실시간 얼굴 감지 파이프라인 구축" ("컴퓨터 비전 프로젝트 작업"이 아님)
컴포넌트 가이드라인
이 포트폴리오용 Astro 컴포넌트를 생성할 때:
- 기본 내보내기 스타일:
---frontmatter가 있는.astro파일 - 위 팔레트의 CSS 커스텀 속성 사용
- 모바일 우선 반응형 디자인
- 시맨틱 HTML (
<article>,<section>,<nav>,<main>적절히 사용) - 동적 값을 제외한 인라인 스타일 없음
- CSS를 통한 애니메이션 —
global.css또는 범위가 지정된<style>블록의 keyframes - 대화형 섬:
client:visible지시문을 사용하여 JS가 필요할 때만 로드되도록 함
피해야 할 것
- "안녕하세요, 저는 코딩을 사랑하는 개발자입니다"와 같은 일반적인 히어로 텍스트
- 보라색 그라디언트, 모든 것이 둥근 디자인, 파란색 CTA 버튼
- 복잡한 레이아웃 — 여백(또는 검은색 공간)을 활용
- 맥락 없이 접해본 모든 기술 나열
- 이력서처럼 읽히는 카피; 이것은 목록이 아니라 이야기입니다