๐ React Form Wizard v1.0.0 - Major Update Released!
We're excited to announce the release of React Form Wizard v1.0.0! This major update brings significant improvements in performance, developer experience, and introduces powerful new features including schema-based form wizards.
โ ๏ธ Important: React Version Requirementsโ
BREAKING CHANGE: This version requires React v19+. If you're using React v18 or lower, please continue using version 0.2.7:
npm install react-form-wizard-component@0.2.7
Check your React version with:
npm list react
๐ What's New in v1.0.0โ
๐ฅ Schema-First API (New Feature)โ
The biggest addition is the Schema API - a powerful new way to define form wizards using configuration objects instead of JSX components.
Before (Children API - Still Supported)โ
<FormWizard title="My Wizard">
<FormWizard.TabContent title="Step 1" icon="ti-user">
<MyStep1Component />
</FormWizard.TabContent>
<FormWizard.TabContent title="Step 2" icon="ti-settings">
<MyStep2Component />
</FormWizard.TabContent>
</FormWizard>
After (Schema API - New!)โ
const schema: FormWizardSchema = {
initialData: { plan: "basic", accepted: false },
steps: [
{
id: "plan",
title: "Choose Plan",
content: <PlanSelector />,
},
{
id: "premium",
title: "Premium Features",
condition: ({ data }) => data.plan === "premium",
content: <PremiumFeatures />,
},
],
};
<FormWizard schema={schema} data={data} onDataChange={setData} />
๐ Performance Improvementsโ
- React.memo applied to core components for better re-rendering
- useMemo and useCallback optimizations for expensive computations
- Reduced bundle size through better tree-shaking
โฟ Accessibility Enhancementsโ
- ARIA roles and attributes for better screen reader support
- Keyboard navigation with arrow keys, Home, and End
- Focus management improvements
- Screen reader announcements for step changes
๐จ UI/UX Improvementsโ
- Touch-friendly interactions with swipe gestures
- Responsive design improvements for mobile devices
- High contrast support for accessibility
- Reduced motion support for users with vestibular disorders
๐ ๏ธ Developer Experienceโ
- Enhanced TypeScript support with better type inference
- New imperative API methods (
goToTabById,setData,getData) - Improved error handling with better validation feedback
- Better documentation with comprehensive examples
๐ Testing Infrastructureโ
- Jest + React Testing Library setup
- Comprehensive test coverage for all components
- CI/CD pipeline improvements
๐ Migration Guideโ
The Children API is still fully supported. Your existing code will continue to work without changes. The onComplete callback now optionally receives wizard data, and onTabChange includes stepId.
๐ Getting Startedโ
npm install react-form-wizard-component@latest
โ ๏ธ Remember: React v19+ required!
๐ Resourcesโ
- Quick Start Guide
- v1 Demos (Schema & all features)
- Playground (try it live)
- Legacy Demos (Children API)
Ready to upgrade? Check out our comprehensive examples and playground! ๐
