跳到主要内容
文档

贡献 — 加入实验室

构建它 与我们一起。

面向 Web Standards Lab 的精确、Node 优先的贡献者工作流。

01 — 环境设置

git clone https://github.com/open-element/openelement.git
cd openelement
pnpm install
pnpm test

openElement 核心 CLI、SSG、serverless API、测试、发布与文档站任务都运行在 Node 24.2+ 上,以 pnpm 作为包管理器。任务通过 pnpm run <task> 或 vp 任务器驱动——主工作流不需要 npm 或 npx 的全局安装。

发布线

  1. 运行 pnpm --dir tools/repo run version-bump
  2. 更新 changelog
  3. 运行 pnpm test
  4. 通过 pnpm --dir tools/release run pack:dry-run、pnpm run release:check、pnpm --dir tools/release run publish:npm 发布
  5. 创建 GitHub Release

02 — 提交 PR 之前

  • pnpm run fmt + pnpm run lint 保持干净
  • Conventional Commits(feat / fix / docs / refactor / test / chore)
  • 本地门禁全绿——推送前先跑 pnpm run check 和 pnpm test
  • 涉及架构变更?先写 ADR

分层纪律:新增功能之前,先检查能否在更低层解决——L0 HTML、L1 CSS、L2 浏览器 API、L3 Hono/Vite/Lit,最后才是 L4 自定义代码。

03 — 可以从哪里入手

第三方 WC 语料库

让 Lit / FAST / Stencil 组件跑通我们的 DSD 冒烟管线,并留下证据。

真实 dogfood

在稳定线上构建一个真实应用,把遇到的问题记录下来。这就是当前的试点。

文档真值

运行文档门禁,修掉过期论断,让公开面始终有证据支撑。

ChangelogRoadmap