# brew-guide

**Repository Path**: zztxd1/brew-guide

## Basic Information

- **Project Name**: brew-guide
- **Description**: 一站式咖啡小工具，支持冲煮记录、豆仓管理与品鉴笔记功能。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: https://coffee.chu3.top/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2025-12-01
- **Last Updated**: 2025-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 咖啡冲煮指南 (Brew Guide)

一站式咖啡小工具，支持辅助冲煮，豆仓管理与品鉴记录功能。

![应用截图](https://pic1.imgdb.cn/item/6913fbc43203f7be00f6dedd.png)

## 网页版访问

- **国内**：[https://coffee.chu3.top/](http://coffee.chu3.top/)
- **海外**：[https://brew-guide.vercel.app/](https://brew-guide.vercel.app/)

## 主要功能

**冲煮管理**

- 支持多种器具（V60、聪明杯、Kalita、Origami 等）
- 丰富的冲煮方案库，预设和自定义方法
- 精确的计时器，按阶段引导冲煮
- 可视化注水过程

**咖啡豆管理**

- 详细库存记录（产地、处理法、品种、烘焙度等）
- 烘焙日期追踪和新鲜度监控
- 消耗跟踪和剩余量管理
- 智能搜索：支持名称、品牌、产区、风味、处理法、品种筛选
- 在线数据库支持，快速导入咖啡豆信息

**冲煮笔记**

- 详细记录评分、口感和笔记
- 关联器具、方法和豆子数据
- 趋势分析和偏好统计

**其他特性**

- PWA 支持，可离线使用
- 深色/浅色模式
- 数据导入导出
- 墨水屏优化
- 多平台支持（Web、iOS、Android）

## 开发

**环境要求**：推荐使用 pnpm

```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建
pnpm build

# 移动端开发
pnpm cap:build
pnpm cap:ios
pnpm cap:android
```

## 技术栈

- [Next.js 15](https://nextjs.org/) - React 框架
- [React 19](https://react.dev/) - 用户界面库
- [Tailwind CSS 4](https://tailwindcss.com/) - 样式解决方案
- [Framer Motion](https://www.framer.com/motion/) - 动画库
- [TypeScript](https://www.typescriptlang.org/) - 类型安全
- [Capacitor](https://capacitorjs.com/) - 跨平台原生运行时
- [Dexie](https://dexie.org/) - IndexedDB 包装器

## 贡献

欢迎提交 Issue 和 PR！

- 项目架构：[架构文档](docs/ARCHITECTURE.md)

## 许可

本项目采用 [MIT](https://choosealicense.com/licenses/mit/) 许可证。