Getting Started
Installation
Get ReactFast Forms up and running in your React project in just a few steps.
Prerequisites
Before installing ReactFast Forms, make sure you have:
- React 18+ - ReactFast Forms requires React 18 or higher
- React DOM 18+ - Required for DOM rendering
- Node.js 16+ - For npm/yarn package management
Installation
Install ReactFast Forms using your preferred package manager:
Using npm
npm install @reactfast/forms
Using yarn
yarn add @reactfast/forms
Using pnpm
pnpm add @reactfast/forms
Peer Dependencies
ReactFast Forms requires React and React DOM as peer dependencies. If you don't already have them installed:
npm install react react-dom
# or
yarn add react react-dom
React Version Requirement
ReactFast Forms requires React 18 or higher. If you're using an older version of React, please upgrade before installing ReactFast Forms.
Verify Installation
To verify that ReactFast Forms is installed correctly, create a simple test component:
import { FastForm, createFormHandler } from "@reactfast/forms";
import { useState } from "react";
const fields = [
{ name: "test", title: "Test Field", type: "string", width: 100 }
];
export default function TestForm() {
const [formData, setFormData] = useState({});
const handleChange = createFormHandler({
fields,
setState: setFormData,
});
return (
<FastForm
fields={fields}
onChange={handleChange}
formData={formData}
/>
);
}
If this renders without errors, ReactFast Forms is installed correctly!
Next Steps
Now that NovaForms is installed, you can:
- Follow the Quick Start guide to create your first form
- Explore Field Types to see what's available
- Learn about createFormHandler for advanced usage
Troubleshooting
Common Issues
Module not found error: Make sure you've installed NovaForms and its peer dependencies:
npm install @reactfast/forms react react-dom
React version error: Ensure you're using React 18 or higher:
npm list react
TypeScript errors: If you're using TypeScript, ReactFast Forms includes type definitions. Make sure your tsconfig.json includes the node_modules types:
{
"compilerOptions": {
"types": ["node"]
}
}
Getting Help
If you're still having issues:
- Check the GitHub Issues
- Join the Discussions
- Review the Examples for common patterns