Skip to content

weizwz/weiz-nav

Repository files navigation

前端导航网站 🚀

现代化的个人前端导航网站,为开发者提供高效、美观的资源导航体验

前期使用 Kiro 的 Spec 模式开发,感谢 Claude Sonnet 4.5; 后期使用 Antigravity 进行迭代和 bug 修复,感谢 Gemini 3 pro

Next.js TypeScript Tailwind CSS Ant Design License

在线演示 | 快速开始 | 文档 | 部署指南


✨ 核心特性

特性 描述 备注
响应设计 完美适配桌面、平板、手机 多端适配
实时搜索 支持多维度匹配 默认站内,回车可搜索站外网页
灵活管理 支持添加、编辑、删除, 拖拽排序
持久数据 支持数据的导入导出
主题切换 支持明暗主题切换,平滑过渡
PWA支持 支持安装到桌面,离线可用
性能优化 代码分割、懒加载 Lighthouse 90+
可访问性 遵循无障碍设计标准 WCAG 2.1 AA
Chrome扩展 安装到 Chrome 插件 releases V0.1.4+ 版本里找

🛠️ 技术栈

Next.js 15 · TypeScript 5 · Tailwind CSS 4 · Ant Design 6 · Redux Toolkit · Framer Motion


🚀 快速开始

# 克隆项目
git clone <repository-url>
cd frontend-navigation-site

# 安装依赖
pnpm install

# 配置环境变量(可选)
cp .env.example .env.local
# 编辑 .env.local 设置你的网站 URL
# 静态部署时,cloudflare 上的环境变量无效,需要配置 .env.production/.env.local 且提交代码

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build

# 部署到 Cloudflare Pages (静态部署)
pnpm deploy:cloudflare

切换部署模式

本项目支持静态导出 (Static Export)动态部署 (SSR) 两种模式。

1. 静态部署 (推荐)

适用于纯静态站点,性能最好,成本最低。

  • 修改 next.config.ts: 取消注释 output: 'export'
  • 修改 wrangler.toml: 设置 pages_build_output_dir = "out"
  • 修改 package.json: deploy:cloudflare 命令使用 pnpm buildout 目录

2. 动态部署 (SSR)

适用于需要服务端渲染或 API 路由的场景。

  • 修改 next.config.ts: 注释掉 output: 'export'
  • 修改 wrangler.toml: 设置 pages_build_output_dir = ".vercel/output/static" 并添加 compatibility_flags = ["nodejs_compat"]
  • 修改 package.json: deploy:cloudflare 命令使用 pnpm pages:build.vercel/output/static 目录

详细说明请查看 快速开始指南


🚢 部署

推荐使用 Cloudflare Pages(免费额度大,中国访问速度快)

pnpm build
pnpm deploy

也支持 Vercel、GitHub Pages、Netlify 等平台

详细部署指南:QUICKSTART.md | DEPLOYMENT.md


📚 文档

快速指南

开发文档

技术指南


📄 许可证

MIT License - 查看 LICENSE 了解详情


Made with ❤️ by weizwz

⬆ 回到顶部

About

Static front-end navigation website

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors