Wondering what’s next for npm?Check out our public roadmap! »


    1.0.10 • Public • Published


    Node.js CI Node.js CI GitHub license npm version PRs Welcome

    Mongoose's schema based validation engine, made to integrate back and front-end validations easily and using same schemas

    It IS NOT intended to do magic and generate automatically Html forms and fields, styles, and React components.

    It DOES provide tools to validate the same Mongoose Schema using React & Hooks and Node.js integrating back and front end validations in the same source.

    Important Note: 🐻 Mongoose isn't required at all, but the supported schema follows these guide lines, what is different of yup with its own .js Schemas, and also different of what ajv does dealing with json schemas.


    • Easy to use sync/async validations of Mongoose schemas, both in Client Side using React Hooks or on server side using Node.js Promises.
    • Validation for single fields
    • Integration with React Hook useState, tools available to set up errors, clean, deal with changes etc.
    • Friendly and consistent error messages with internationalization support using react-i18next.
    • Configurable Error messages for each type checking
    • Real time validation in forms
    • Custom validations using simple Java Script functions

    🚀 Getting started:


    const schema = () => ({
      myField: {
        max: 50,
        required: true,
        type: String,
    export default schema;
    import React, { useState } from 'react';
    import Formoose from 'formoose';
    import schema from './schema.js';
    function FormooseFormExample() {
      const formoose = new Formoose(schema);
      const { handleFieldChange, validateOneField, validateAllFieldsSync, mountFormData } = formoose.tools;
      const [formData, stateSetter] = useState({});
      mountFormData(formData, stateSetter);
      const handleSubmit = async e => {
        let formIsValid = await validateAllFieldsSync();
        if (formIsValid) {
          console.info('We are good to go!');
        } else {
          console.error('oops, something went wrong.');
        return formIsValid;
        <form onSubmit={handleSubmit}>
            onChange={e => handleFieldChange(e, 'myField')}
            onFocus={e => handleFieldChange(e, 'myField')}
            onBlur={() => validateOneField('myField')}
          {formData.myField.error && (
            <label htmlFor="myField">{formData.myField.message}</label>
          <input type="submit" value="Submit"/>
    export default FormooseFormExample;

    Examples available at https://github.com/romulobordezani/formoose-example


    Fell free to fork and submit changes and improvements, also please let me know if you find any issues.

    Also, I got a road-map, help wanted 😊

    • Flavor to use GraphQl schemas instead of Mongoose Schemas
    • Support casting to transform automatically convertible Types like strings in Dates, Numbers in Strings, etc.
    • Support Schemas parenting and inheritance
    • Support touched, pristine and dirty states natively within the Field Interface

    Running the core project

    npm install
    npm start
    npm run test

    Type Script will compile to dist folder, use npm link within the example repository to run and debug your changes.


    npm i formoose

    DownloadsWeekly Downloads






    Unpacked Size

    66.9 kB

    Total Files


    Last publish


    • avatar