PrivyDrop/frontend/README.zh-CN.md

PrivyDrop - 前端

这是 PrivyDrop 的前端部分，一个使用 Next.js 构建的、基于 WebRTC 的隐私文件分享应用。

🛠️ 技术栈

• 前端框架: Next.js 14 (App Router)
• UI 框架: React 18 + TypeScript
• 样式: Tailwind CSS + shadcn/ui
• P2P 传输: WebRTC
• 信令服务客户端: Socket.IO Client
• 国际化: next-intl

🚀 本地开发

开始前，请确保你已经根据项目根目录 README.md 的指引，安装并启动了后端服务。

1. 进入目录

   # 假设你当前在项目根目录
   cd frontend
   

2. 安装依赖

   pnpm install
   

3. 配置环境变量 首先，从模板文件复制一份开发环境变量配置：

   cp .env_development_example .env.development
   

   然后，打开并编辑 .env.development 文件，确保 NEXT_PUBLIC_API_URL 指向你本地正在运行的后端服务地址。

4. 启动开发服务器

   pnpm dev
   

5. 在浏览器中打开 http://localhost:3002 即可看到应用界面。

📚 详细文档

• 要了解完整的项目架构和组件协作方式，请参阅 项目整体架构。
• 要深入理解前端的代码结构、Hooks 设计和状态管理，请阅读 前端架构详解。
• 有关生产环境部署，请参考 Docker 部署指南。

🤝 参与贡献

我们欢迎任何形式的贡献！请阅读根目录下的 贡献指南 来开始。