Versioning

FrontAlign follows Semantic Versioning (SemVer): every release is tagged MAJOR.MINOR.PATCH, and each segment tells you exactly what kind of change to expect before you touch your package.json.

1 . 1 . 0
│   │   │
│   │   └─ PATCH — bug fixes, no API or behavior changes
│   └───── MINOR — new features, fully backward-compatible
└───────── MAJOR — breaking changes to the public API

You can always upgrade across PATCH and MINOR releases without changing any of your code. MAJOR releases are the only ones that may require you to update your configuration, markup, or class names.

Version Scale

Checking Your Installed Version

npx frontalign --version

The version is also always available in your project's package.json:

{
  "dependencies": {
    "frontalign": "^1.1.0"
  }
}

The ^ range lets npm install pull any future MINOR or PATCH release automatically, while never crossing into a MAJOR version on its own.

What Counts as a Breaking Change

Not every visible change in the changelog triggers a MAJOR bump — only changes to the documented, public API do. Internal implementation details, even ones you could technically detect by inspecting the DOM or CSS, don't count.

For example, 1.1.0 standardized the internal "open" state class from .opened to .is-open across Dropdown, Collapse, Drawer, Accordion, Tooltip, Popover, and Modal. This shipped as a MINOR release, not a MAJOR one, because:

• The class is toggled internally by FrontAlign's JS, not something you're expected to set yourself.
• The documented configuration API (data-* attributes) didn't change.
• No HTML, attribute, or JS API changes were required on your end.

The only people affected are those who wrote custom CSS selecting .opened directly — the changelog calls this out explicitly so it isn't missed.

Reading the Changelog

Every release groups its entries under the same set of headings, so you can scan for what matters to you without reading line by line:

The full history lives in CHANGELOG.MD at the root of the repository.

Current Release

1.1.0 is the current MINOR release on the 1.x line — every 1.0.x project can upgrade to it without any code changes.