基于 Next.js 15 App Router 与 TypeScript,使用 Tailwind CSS 和 Shadcn UI 构建
sleek-portfolio — Next.js 作品集模板
作者 ramxcodes
基于 Next.js 15 的现代响应式作品集模板,集成博客、项目展示与 Telegram 联系表单。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。 本截图因高度限制未包含整页。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
内置 MDX 博客与项目展示系统,内容以文件形式管理
联系表单集成 Telegram Bot,可接收站内消息
支持明暗主题切换,响应式设计适配不同设备
预留 Umami 分析环境变量,便于接入隐私友好的访问统计
站点内容集中在 src/config 目录,便于快速编辑
模板详细介绍
sleek-portfolio 是一个面向开发者个人品牌展示的现代作品集模板,基于 Next.js 15、TypeScript、Tailwind CSS 和 Shadcn UI 构建。其核心结构围绕首页的 Hero 区、项目展示、工作经历时间线、关于与联系表单展开,并内置了基于 MDX 的博客系统,适合用来沉淀技术文章或项目案例。整体设计强调响应式与明暗主题切换,视觉风格简洁,适合作为个人站点的起点。
模板的定制方式比较直接:站点内容集中在 src/config 目录下的多个配置文件中,例如 Hero、About、Projects、Experience 等,修改文本或链接无需深入组件层。博客和项目详情以 MDX 文件组织,新增内容只需在 src/data 对应目录添加文件并放置缩略图。联系表单通过 Telegram Bot 接收消息,需要配置 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID;此外还预留了 Gemini API 和 Umami 分析的环境变量,但 README 未说明 Gemini 的具体用途,若需使用需自行查看代码确认。
需要注意的是,模板依赖外部服务(Telegram、Umami)才能完整运行,部署前需准备相应凭证。Node.js 版本要求 v18 以上,推荐使用 Bun 作为包管理器。项目采用 MIT 许可证,代码可自由修改,但 README 未提供详细的组件结构说明,深度定制时可能需要自行阅读源码。
适合你的项目吗?
适用场景
- 开发者搭建个人作品集网站,同时需要博客功能
- 希望使用 Next.js 15 与最新前端工具链的快速起步项目
- 需要联系表单但不想接入传统后端,愿意使用 Telegram Bot 接收消息
- 偏好内容以 MDX 文件管理,而非依赖 CMS 的场景
适合人群
- 前端开发者或设计师展示个人项目与技术文章
- 熟悉 React 和 Next.js 的开发者,希望基于模板二次开发
- 需要明暗主题与响应式设计的个人品牌站点
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
需要 Node.js v18+,推荐使用 Bun 或 npm。
- 2
配置环境变量 TELEGRAM_BOT_TOKEN、TELEGRAM_CHAT_ID 以启用联系表单
- 3
Umami 分析需自建或使用云服务并配置 NEXT_PUBLIC_UMAMI_SRC 与 NEXT_PUBLIC_UMAMI_ID。
- 4
GEMINI_API_KEY 在 README 中列出但未说明用途,使用前需自行查看代码。
- 5
本地运行需设置 NEXT_PUBLIC_URL。
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明MIT许可证允许免费使用、复制、修改、合并、发布、分发、再许可和销售,仅需保留版权与许可声明。
使用时需要遵守
- 保留原作者版权声明和 MIT 许可证声明。
- 在所有副本或实质性部分中包含版权声明和许可声明
额外费用与待核对事项
- README未单独说明演示图片等素材的授权范围
查看原文依据
Permission is hereby granted, free of charge, to any person obtaining a copy
许可证原文
The above copyright notice and this permission notice shall be included in all
许可证原文
https://github.com/ramxcodes/sleek-portfolio/blob/main/LICENSEhttps://github.com/ramxcodes/sleek-portfolio/blob/HEAD/README.mdPermission is hereby granted, free of char
许可证原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 90 / 100
- 技术栈
- Next.js · React
- 网站类型
- 作品集 · 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2026-06-01
- 截图检查日期
- 2026-09-03
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
仓库文件核对
检查日期: 2026-09-30 · 仅核对文件,未安装依赖或运行测试。
声明的依赖版本范围
- next
^15.5.18- react
^19.0.0- tailwindcss
^4- typescript
^5.9.3
声明的 npm 脚本名(未执行):dev · build · start · lint · format · format:prettierrc · format:prettierrcjson · format:all · prepare · knip · test-telegram
介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。
这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。
反馈内容错误看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

tailwind-nextjs-starter-blog
tailwind-nextjs-starter-blog 是一个面向个人技术博客的 Next.js 与 Tailwind CSS 启动模板,其 v2 版本基于 App Router 与 React Server Comp…
Next.js · 博客

react-resume-template
A personal resume website template built with React.js, Typescript, Next.js, and styled with Tailwind css
Next.js · 作品集

Nextjs-tailwindcss-blog-template
⭐Build SEO optimized personal blog website with Next.js, Tailwind CSS and Contentlayer. If you want to learn t…
Next.js · 博客

Next-js-Blog-Boilerplate
Next-js-Blog-Boilerplate 是一套面向个人与技术博客的启动代码,基于 Next.js 12 与 Tailwind CSS 3 构建,同时集成了 TypeScript、ESLint、Prettier …
Next.js · 博客

nextjs-blog-theme
nextjs-blog-theme 是 Netlify 团队维护的一个博客启动模板,基于 Next.js 15(Pages Router)和 Tailwind CSS 4.x 构建,设计由 Bejamas 机构完成。
Next.js · 博客

blog
🚀 My personal blog made with Tailwind CSS and NextJS. Template from Timlrx. Feel free to fork, follow and use…
Next.js · 博客
