{"id":28837329,"url":"https://github.com/027xiguapi/next-cloudflare-template","last_synced_at":"2025-10-03T13:53:12.407Z","repository":{"id":295565734,"uuid":"990453302","full_name":"027xiguapi/next-cloudflare-template","owner":"027xiguapi","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-26T06:48:10.000Z","size":528,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-05-26T08:44:55.567Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/027xiguapi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-26T06:23:50.000Z","updated_at":"2025-05-26T06:48:14.000Z","dependencies_parsed_at":"2025-05-26T08:49:46.157Z","dependency_job_id":"366d060a-89ba-4775-a259-3472b0f9a40d","html_url":"https://github.com/027xiguapi/next-cloudflare-template","commit_stats":null,"previous_names":["027xiguapi/next-cloudflare-template"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/027xiguapi/next-cloudflare-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/027xiguapi%2Fnext-cloudflare-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/027xiguapi%2Fnext-cloudflare-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/027xiguapi%2Fnext-cloudflare-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/027xiguapi%2Fnext-cloudflare-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/027xiguapi","download_url":"https://codeload.github.com/027xiguapi/next-cloudflare-template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/027xiguapi%2Fnext-cloudflare-template/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260748148,"owners_count":23056519,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-19T12:06:04.752Z","updated_at":"2025-10-03T13:53:12.399Z","avatar_url":"https://github.com/027xiguapi.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eNext Cloudflare Template\u003c/h1\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  一个基于 Next.js、Cloudflare Pages 和 Cloudflare D1 数据库构建的模版教学类项目。\n\u003c/p\u003e\n\n## ✨ 特性\n\n- ⚡️ 基于 Next.js，性能优秀、部署便捷。\n- 🎯 支持渲染自定义 React 组件，类似 MDX 体验，内容更灵活。\n- 🔍 支持服务器端渲染 (SSR)，增强 SEO 效果。\n- 💾 通过 Cloudflare D1 和 Drizzle ORM 实现数据库存储，高效可靠。\n- 🎨 UI 采用 Tailwind CSS 和 Shadcn/ui，风格现代、易于定制。\n- 🚀 使用 Cloudflare Pages 部署，全球访问快速稳定。\n\n## 📦 技术栈\n\n- 框架：Next.js、Hono.js\n- 数据库：Cloudflare D1、Drizzle ORM\n- Markdown 编辑器：Vditor\n- Markdown 解析器：markdown-to-jsx\n- UI 框架：Tailwind CSS、Shadcn/ui\n- 部署平台：Cloudflare Pages\n\n## 🔑 环境变量\n\n### 基础配置\n\n- NEXT_PUBLIC_BASE_URL: 项目 URL 地址\n\n### 认证相关\n\n- AUTH_SECRET: NextAuth Secret，用来加密 session，请设置一个随机字符串\n\n### Cloudflare 配置\n\n- CLOUDFLARE_API_TOKEN: Cloudflare API Token\n- CLOUDFLARE_ACCOUNT_ID: Cloudflare Account ID\n- PROJECT_NAME: Pages 项目名\n- DATABASE_NAME: D1 数据库名称\n- DATABASE_ID: D1 数据库 ID\n- KV_NAMESPACE_NAME: Cloudflare KV namespace 名称，用于存储网站配置（可选，如果不填，则为 next-blog-kv）\n- KV_NAMESPACE_ID: Cloudflare KV namespace ID，用于存储网站配置 （可选， 如果不填, 则会自动通过 Cloudflare API 获取）\n\n## 🚧 开发\n\n1. 克隆仓库：\n\n```bash\ngit clone https://github.com/Shiinama/next-cloudflare-template\ncd next-cloudflare-template\n```\n\n2. 安装依赖：\n\n```bash\npnpm install\n```\n\n3. 修改配置文件\n   在 `wrangler.jsonc` 设置 Cloudflare D1 数据库名以及数据库 ID\n\n4. 设置环境变量：\n\n```bash\ncp .env.example .env.local\n```\n\n设置 NEXT_PUBLIC_BASE_URL, AUTH_SECRET\n\n5. 创建本地数据库表结构：\n\n```bash\npnpm db:migrate-local\n```\n\n6. 本地运行：\n\n```bash\npnpm run dev\n```\n\n## 🌍 部署到 Cloudflare Pages\n\n1. 执行《🚧 开发》中的步骤 1~4\n\n2. 创建远程数据库表结构：\n\n```bash\npnpm db:migrate-remote\n```\n\n3. 部署：\n\n```bash\npnpm run deploy\n```\n\n## ❓ 常见问题\n\n- 如何获取 `CLOUDFLARE_ACCOUNT_ID` 和 `CLOUDFLARE_API_TOKEN`？\n\n1. 登录 [Cloudflare 控制台](https://dash.cloudflare.com)\n\n2. 复制如图所示的值，这就是 `CLOUDFLARE_ACCOUNT_ID`\n\n3. 点击右上角小人图标，选择配置文件\n\n4. 在左边的菜单选择 API 令牌\n\n5. 创建一个自定义令牌，这就是 `CLOUDFLARE_API_TOKEN`\n\n6. 该 token 只会显示一次，请妥善保存\n\n## 💡 贡献\n\n欢迎提交 Pull Request 或者 Issue 来帮助改进这个项目\n\n## 📄 License\n\n本项目采用 [MIT](LICENSE) 许可证\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F027xiguapi%2Fnext-cloudflare-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F027xiguapi%2Fnext-cloudflare-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F027xiguapi%2Fnext-cloudflare-template/lists"}