Upgrade Guide

Formstone 1.x to 2.x

Formstone started as a bridge for browser limitations. Version 2.x is a ground-up rewrite focused on modern ES6 standards, accessibility, and common UI patterns. Many legacy components have been retired in favor of native features.

Key Changes

Lean and clean. Zero core dependencies, with jQuery adaptors still available.
Module-Based. Import only the specific components your project needs.
Native-First. Focus on widely supported browser features.
Accessibility Overhaul. Conforms to WCAG specifications and best practices.

Implementation

Formstone is now module-based, with multiple installation methods supported.

Import only what you need from formstone
Initialize via component methods (for example Background.construct(...))
Use Utils.ready(...) for script timing

import { Background, Utils } from 'formstone';

Utils.ready(() =&gt; {
  Background.construct('.js-background', {
    source: '...'
  });
});

Retired Components

Legacy components has been removed in favor of natively supported browser features.

Grid
Analytics
ASAP
Carousel
Checkbox
Dropdown
Equalize
Number
Pagination
Range
Scrollbar
Sticky
Tooltip
Touch
Transition
Upload