Skip to content

SKYangg/Duckfolio

 
 

Repository files navigation

🦆 Duckfolio

Duckfolio 是一个简洁、现代、有趣的个人主页模板。

本项目旨在为开发者、设计师或创作者提供一个清爽、易于维护的在线名片,快速展示你的个人信息、社交链接与博客等内容。
同时也展示了如何使用现代 Web 技术(Next.js、TailwindCSS、Shadcn UI 等)构建轻量级的静态网站。


✨ 项目特色

  • 🚀 使用 Next.js 15 + Turbopack,极速开发体验
  • 🎨 采用 Tailwind CSS 4 实现原子化、响应式布局
  • 🌗 支持 深色/浅色主题自动切换
  • 💫 利用 Framer Motion 增添自然平滑的过渡动画
  • 🧩 使用 Shadcn UI 构建现代交互组件
  • 🧠 通过 Zustand 管理全局状态(如主题)
  • 📱 完全响应式,适配移动端和大屏设备
  • 🧼 结构清晰,易于维护和定制

🖼️ 页面预览

首页 - Profile

Preview

链接页 - Links

Preview


🛠️ 使用技术

技术 用途
Next.js 框架
Turbopack 构建工具
Tailwind CSS 样式框架
Shadcn UI 无障碍组件库
Framer Motion 动画库
Zustand 状态管理
next-themes 主题切换
Lucide Icons 图标

🚀 快速开始

1. 克隆仓库

git clone https://github.com/Yorlg/Duckfolio.git
cd duckfolio

# 安装依赖
pnpm install

# 项目打包
pnpm build

# 启动服务器
pnpm dev

2. 使用 Docker 部署

docker pull yorlg/duckfolio:latest
docker run -p 3000:3000 -v /root/duckfolio/platform-config.json:/app/public/platform-config.json yorlg/duckfolio:latest

访问 http://localhost:3000

3. 使用 Docker Compose 部署

  • 创建 platform-config.json 文件,内容参考 platform-config.json
  • 创建 docker-compose.yml 文件,配置请参考:docker-compose 的示例
  • docker-compose.yml 中,确保将 platform-config.json 挂载到容器的 /app/public/platform-config.json 路径
docker-compose up -d

4. 部署到 Cloudflare Pages

要想部署到 Cloudflare Pages,请参阅该文档:将 Duckfolio 部署到 Cloudflare Pages

5. 部署到 Vercel

要想部署到 Vercel,请参阅该文档:将 Duckfolio 部署到 Vercel

6. 自行构建 Docker 镜像

$ git clone https://github.com/Yorlg/Duckfolio.git
cd duckfolio

# 构建镜像
$ docker build -t duckfolio .

# 启动容器
$ docker run -p 3000:3000 duckfolio

项目的配置文件位于 public/platform-config.json,你可以在这里修改个人信息、社交链接等内容。

About

个人主页

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 92.4%
  • CSS 5.4%
  • JavaScript 1.2%
  • Dockerfile 1.0%