开发 · 官方文档

开发指南

官方网站是一个独立于区块链基础设施的 Next.js 应用。本指南描述其组织结构和未来演进时应遵循的规则。

技术栈与组织

网站使用 Next.js、App Router、React、TypeScript 和 Bootstrap 5,并辅以 BI3LYX 专属样式表。编辑页面由仓库中带类型的数据生成。

app/
路由、布局、元数据、站点地图、RSS 源和状态路由。
components/
可复用的界面组件,包括导航、卡片和浏览器。
lib/
带类型的编辑数据、网站配置和未来 API 模型。
tests/
内容、导航、组件和页面渲染测试。

本地命令

  • npm install — 安装依赖。
  • npm run dev — 启动开发服务器。
  • npm run typecheck — 检查 TypeScript 而不生成文件。
  • npm run lint — 使用 ESLint 分析代码。
  • npm test — 运行测试套件。
  • npm run build — 生成生产构建。
  • npm start — 启动 Next.js 构建。

发布内容

文档页面和新闻由带类型的区块描述。每次新发布都必须提供唯一的 slug、标题、描述、日期以及不含未确认数据撰写的正文。

  • 检查内部链接和元数据。
  • 清楚标明准备中的信息。
  • 绝不要发布虚构的统计数据或模拟截图。
  • 发布前请人复核技术陈述。

API 集成规则

  • 保持与显示组件分离的服务器访问层。
  • 仅通过环境变量配置 API URL。
  • 设置超时和明确的错误状态。
  • 显示前验证响应模式。
  • 绝不要暴露 RPC URL、密钥或钱包数据。

贡献与验证

  • 不得从网站仓库直接修改生产基础设施。
  • 任何变更都必须通过类型检查、lint、测试和构建。
  • 提交和部署需要项目负责人的授权。
  • 未经验证和签名,绝不从网站发布二进制文件。