One Calendar

One Calendar

一款精美简约的开源日历应用，助您规划一周和生活。

什么是 One Calendar？

One Calendar 是一款注重隐私、专注于每周的开源日历应用，旨在帮助个人和团队规划、集中精力并保持同步。

如果没有 One Calendar，您的日程安排就会变得杂乱无章。有了它，您的一周就会感觉井井有条。

为什么选择 One Calendar？

大多数日历工具都功能杂乱、设计过度，或者需要付费才能使用。 One Calendar 的目标是：

• 🧠 AI 赋能 – AI 优先的应用，简化您的日程安排。
• 🕹 交互流畅 – 轻松拖放、右键点击和编辑。
• 🔐 私密本地 – 您的数据由您掌控。导出、备份和控制。
• ☁️ 云同步 – 可选通过 PostgreSQL 同步。
• 🌐 Clerk-Account – 轻松使用第三方账户登录。
• 🌍 国际化 – 自动适应您的语言（英语/中文）。
• 🧱 可自定义 – 定制主题、默认视图和集成。

技术栈

• 前端：Next.js 14、Tailwind CSS、shadcn/ui、TypeScript
• 授权：Clerk
• 存储：PostgreSQL
• 天气：OpenWeather API
• 人工智能：Groq API
• 分析：Vercel Analytics
• 部署：Vercel

##预览

入门指南

先决条件

所需版本：

• NodeJS (v18 或更高版本)
• Bun (v1.2 或更高版本)

快速入门

# 克隆代码库
git clone https://github.com/EvanTechDev/One-Calendar.git
cd One-Calendar

# 安装依赖项
bun install

# 启动应用
bun dev

然后访问 http://localhost:3000

环境变量

将 .env.example 复制到 .env 并填写：

# 必填
NEXT_PUBLIC_BASE_URL=http://localhost:3000
SALT=Backup-Salt

# 授权（必填）
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your-clerk-publishable-key
CLERK_SECRET_KEY=your-clerk-secret

# 可选
GROQ_API_KEY=your-groq-api
OPENWEATHER_API_KEY=your-open-weather-api-key

# 可选数据库
POSTGRES_URL=postgres://postgres:postgres@localhost:5432/onecalendar

# 可选，Cloudflare Turnstile 验证码
NEXT_PUBLIC_TURNSTILE_SITE_KEY=SiteKey
TURNSTILE_SECRET_KEY=SecretKey

环境设置

1. SALT

安装 OpenSSL 并使用此命令生成 SALT 文件

openssl rand -hex 16

然后将其复制到.env

2. PostgreSQL

如果您安装了 docker，请运行以下命令：

bun run db

环境变量：

POSTGRES_URL=postgres://postgres:postgres@localhost:5432/onecalendar

3. Cloudflare Turnstile

[!NOTE]
正在更新

4. Groq

前往 Groq 控制台 并登录

点击“创建 API 密钥”

复制您的 API密钥

填写 env 文件：

GROQ_API_KEY=你的 API 密钥

路线图

您可以在我们的反馈网站上报告错误或请求新功能。

路线图和反馈

Star 历史

团队

由一支热爱简洁工具和开源的小型团队为您倾情打造。

查看我们的贡献者 ❤️

赞助

BTC：bc1qdhn6c7tlcaflzu3u5fva825l20k9eqnqag5xzj

致谢

如果没有这些优秀的服务，这个项目就不可能实现：

许可证

本项目采用 GNU 通用公共许可证 v3.0 (GPL-3.0) 授权。 详情请参阅 LICENSE 文件。