Skeletonic Stylus 是一個開源專案;歡迎各種規模的貢獻——從錯字修正到新組件。
快速開始
# 1. Fork 並複製
git clone git@github.com:YOUR-USER/skeletonic-stylus.git
cd skeletonic-stylus
# 2. 安裝(pnpm via corepack)
corepack enable
pnpm install
# 3. 建置
pnpm run build # 完整管線(stylus → prettier → stylelint → autoprefixer → csso)
# 4. Lint 與測試
pnpm run lint
node scripts/a11y-test.mjs
慣例
- 分支命名:
feat/short-thing、fix/short-thing、docs/short-thing。 - 提交: 約定式提交。所有提交均需簽署。
- Stylus: 4 空格縮排,不使用分號,優先使用
$variables而非魔術數字,每個公開類別位於級聯層中。 - 無障礙: 任何新組件必須可驗證地滿足 WCAG 2.2 AA;在開啟 PR 前請對展示頁面執行
node scripts/a11y-test.mjs。 - 大小預算: 核心樣式表必須保持在 8 KB gzip 以下。如果您的變更超出此限制,請在 PR 中說明理由。
拉取請求
- 對於非瑣碎的變更,請先開啟 issue——避免重複工作。
- 保持 PR 聚焦:每個 PR 一個邏輯變更。
- 在「未發行」下方更新
CHANGELOG.md。 - 在請求審查前確保 CI 為綠色。
- 預設使用 squash-merge;提交訊息將在合併時整理。
行為準則
參與本專案即表示您同意遵守貢獻者公約 2.1。請保持友善、耐心,並假設善意。