M. MAHAFUJ RAHMAN 的作品集 — 品牌與建置系統
你正在建置 M. Mahafuj Rahman 的個人作品集,他是一位擁有廣泛已發布專案(涵蓋行動裝置、網頁、後端、物聯網與機器學習)的全端開發者。這個作品集必須傳達深度、廣度與工藝,而不僅僅是列出技術。
身份識別
姓名: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 - 規則:更少的字重,更有意圖的字級。使用比例,而非顏色,來建立層級結構。
動態與互動
理念:動態應該感覺是必然的,而非裝飾性的。每個動畫都回答「這個為什麼會動?」—— 為了引導注意力、指示狀態、或獎勵滾動行為。
第一層 — CSS(永遠使用,無需依賴)
- 頁面轉場:使用 Astro 內建的
<ViewTransitions />— 零 JavaScript 成本 - 懸停狀態:透明度變化、底線揭示、微幅縮放 (1.0 → 1.02)
- 焦點狀態:使用
--color-accent的可見外框 - 進入動畫:使用 CSS
@keyframes fadeUp處理視窗上方內容
第二層 — 滾動驅動動畫(優先使用 CSS)
- 在瀏覽器支援的情況下,使用原生 CSS
animation-timeline: scroll() - 備援方案:一個小型的
.ts工具中的IntersectionObserver— 不需要函式庫 - 專案卡片:在進入視口時,以交錯方式執行
fade + translateY(24px → 0) - 區塊標題:在滾動時從左側滑入
第三層 — 主視覺「驚嘆」元素(僅限一個,且只有一個)
- 主視覺獲得一個標誌性的動態效果。按偏好順序選項如下:
- 交錯字母/單詞揭示 — 主視覺名稱逐字動畫顯示(僅限 CSS)
- 噪點/顆粒覆蓋層 — 在深色背景上使用 CSS 動畫顆粒紋理(僅限 CSS)
- 微妙的 3D 傾斜 — 專案卡片在滑鼠移動時略微傾斜(純 JavaScript,約 15 行)
- Three.js / React Three Fiber — 僅在需要特定 3D 素材時使用(例如旋轉的幾何標誌)。使用
3D-Animation-Creator或3D-Website-Asset-Generator技能分別產生素材,然後將其作為單一隔離元件嵌入。
絕對不要做的事
- 全頁 Three.js 背景(降低效能,干擾內容)
- 除了主視覺區域外,任何地方使用循環動畫
- 彈性彈簧物理效果(不適合編輯式美學的調性)
- 文字上的視差滾動
- 僅僅因為教學示範而加入動態
網站結構
/ → 主視覺 + 精選專案預覽 + 簡短介紹
/about → Shay 是誰、背景、理念、技能概覽
/projects → 所有專案的網格,附帶技術棧標籤和簡短描述
/projects/[slug] → 單一專案深入介紹(問題、解決方案、技術棧、連結、螢幕截圖)
/resume → 內嵌履歷檢視 + 可下載的 PDF 連結
/blog → 部落格文章列表(已存在於 Astro 中)
/blog/[slug] → 單篇文章(已存在)
技術棧
- 框架:Astro(SSG,以 Markdown 為優先,預設零 JavaScript,出色的 SEO)
- 元件語言:Astro 元件 + 用於互動孤島的 React/Preact (
.tsx) - 語言:全面使用 TypeScript —
.ts、.tsx、.astro搭配型別化的 frontmatter。絕不使用.js或.jsx - 樣式:CSS 自訂屬性(除非使用者特別要求,否則不使用 Tailwind)
- 部署:Vercel
- 內容:用於部落格文章和專案的 Astro Content Collections
專案展示優先順序
在建置專案頁面時,請按此順序優先處理這些專案(最令人印象深刻者優先):
- Qifa — 多應用程式生態系統(客戶端、商店、辦公室、Docker、自訂記錄儀表板、ChatWoot)
- Open RTMS — 使用 YOLO v8n 人臉偵測的即時系統(機器學習角度罕見且令人印象深刻)
- XueHanYu — 全端(Vue + Django),中文學習平台
- NoorConnect — 應用程式 + 後端 + 韌體(物聯網/嵌入式對於網頁開發者來說較罕見)
- Jidian Daojia — Flutter + PHP + uniapp,多平台
- LittleLemon — Meta 專業證書畢業專案(經認證的作品)
對於每個專案頁面,請按以下結構組織內容:
- 一句話鉤子(它解決了什麼問題,而非使用了什麼技術)
- 技術棧徽章
- 挑戰 / 有趣之處
- 做出的關鍵決策
- 連結(GitHub、線上展示(如有))
寫作語氣
- 直接。自信。無廢話。
- 在適當情況下使用第一人稱(「我建立了...」、「我選擇了...因為...」)
- 避免使用:「對...充滿熱情」、「自我驅動」、「結果導向」、「運用綜效」
- 技術細節 > 模糊宣稱。說「建立了一個使用 YOLO v8n 的即時人臉偵測管道」,而不是「從事電腦視覺專案」
元件指南
為此作品集產生 Astro 元件時:
- 預設匯出風格:帶有
---frontmatter 的.astro檔案 - 使用上方調色盤中的 CSS 自訂屬性
- 行動裝置優先的響應式設計
- 語意化的 HTML(正確使用
<article>、<section>、<nav>、<main>) - 除了動態值之外,不使用內聯樣式
- 透過 CSS 動畫 — 將關鍵幀放在
global.css或限域的<style>區塊中 - 互動孤島:使用
client:visible指令,以便只在需要時載入 JavaScript
應避免事項
- 像「嗨,我是個熱愛寫程式的開發者」這種一般化的主視覺文字
- 紫色漸層、到處都是圓角、藍色的 CTA 按鈕
- 雜亂的版面 — 擁抱白色(或黑色)空間
- 在沒有上下文的情況下列出你接觸過的每一項技術
- 讀起來像履歷表的文案;這是一篇敘事文,不是清單