Upgrade guide

How to upgrade NibCSS safely, and what to check between versions.

1 min readv1

Upgrading within 1.x#

1.x releases keep the attribute syntax and public APIs compatible.

Terminal
npx npm-check-updates "/@nibcss/" -u && npm install

Keep every @nibcss/* package on the same version — they are released together.

Things to check after upgrading to 1.1#

  • The reset. 1.1 emits a base reset. If your site already has one, set preflight: false.
  • New warnings. Invalid values are now detected at build time; fix or ignore them (they are still emitted unless strict: true).
  • Diagnostic language. The default is uz; set language: "en" if your team prefers English.
  • Config imports. Remove any hand-written declare module "@nibcss/config" — the package is now typed.

Next steps#