React Validation Framework

A production-grade, framework-agnostic validation runtime for React, designed for extreme determinism, SSR safety, and absolute logic-UI decoupling.

Why this is different?

• Deterministic Validation: Zero hidden dependencies or global side effects.
• Metadata-Driven Rules: Validation rules return pure metadata, not UI strings.
• SSR-Safe Architecture: Uses AsyncLocalStorage for request isolation in Node.js.
• Decoupled Pipeline: Strict 4-stage pipeline (Validator → Bind → Resolver → Commit).

Installation

npm install @muradyanvano/react-validation-framework

Minimal Example

import { useForm } from '@muradyanvano/react-validation-framework';

export function RegistrationForm() {
  const { data, errors, setData, post } = useForm({
    defaultValues: { email: '' },
    validation: {
      email: 'required|email',
    },
  });

  return (
    <form onSubmit={() => post('/api/register')}>
      <input 
        value={data.email} 
        onChange={e => setData('email', e.target.value)} 
      />
      {errors.email && <span>{errors.email}</span>}
      <button>Submit</button>
    </form>
  );
}

Documentation

For full documentation on the pipeline, rules, and configuration, see the /docs folder in this repository.

• Getting Started
• Architecture Overview
• Validation Rules
• API Reference

License

MIT