Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
50 lines (35 loc) · 1.82 KB

CONTRIBUTING.md

File metadata and controls

50 lines (35 loc) · 1.82 KB
Raw

Contributing

Thanks for improving layout-style-css. This repository is a CSS layout library, so changes should keep structure, spacing, responsive behavior, and package contracts separate from visual styling.

Local Setup

npm install
npm run build
npm run lint
npm test

Run the full release gate before opening a release PR:

npm run release:verify

Development Rules

  • Keep authored CSS in styles/.
  • Regenerate dist/ with npm run build; do not hand-edit generated dist files.
  • Keep public layout classes prefixed with ly-.
  • Leave colors, typography, borders, shadows, native controls, focus states, themes, and modes to ui-style-kit-css.
  • Add structural aliases in styles/layout-ui-style-kit-bridge.css only when they map to layout primitives or layout recipes.
  • Update README, docs/wiki, and CHANGELOG.md when a public class, export, recipe, release workflow, or package behavior changes.

Testing Expectations

Every change that affects public behavior should update or preserve:

  • test/layout-css-contract.test.mjs for package, CSS, docs, and tarball contracts.
  • test/demo-smoke.test.mjs for rendered demo behavior.
  • test/pages-artifact.test.mjs for GitHub Pages output.
  • stylelint for authored CSS formatting.

Review Checklist

  • The package remains publishable as a public npm library.
  • The npm tarball contains only intended release files.
  • README examples use exported package entrypoints.
  • Documentation links resolve to versioned files.
  • Demo controls remain compact on mobile and tablet viewports.
  • New CSS does not introduce UI Style Kit-owned visual declarations.

Wiki Updates

The source for the project wiki is docs/wiki/. If GitHub Wiki is enabled for the repository, mirror those files into the wiki remote after the main branch documentation is merged.