Skip to content

Run time validation engine inspired by Mongoose's schemas.

Notifications You must be signed in to change notification settings

romulobordezani/formoose

Repository files navigation

Formoose



Node.js CI GitHub license npm version PRs Welcome

Formoose is a runtime validation engine, based on Mongoose's 🐻 schemas.

Meant to integrate React Controled Forms with back-end APIs using MongoDB.

It IS NOT intended to do magic and generate automatically HTML forms, fields, nor styles, or React components for you.

It DOES provide an easy way to parse and validate the same Mongoose Schema using React & Hooks, integrating back and front-end validations in the same source of truth.

IMPORTANT Note: 🐻 Mongoose lib isn't required at the front-side at all, you can use any schemas following these guide lines, and validate them using Mongoose built in validators at the back-end side.

Provides:

  • Fast sync/async validations for the whole schema.
  • Validation for single fields
  • Tools to set up errors on specific fields, to clean, deal with changes etc.
  • Friendly and consistent error messages with internationalization support using react-i18next.
  • Real time validation in forms
  • Custom validations using simple Java Script functions, which allows you to validate whatever you want like Regexes, API based validations, custom logic etc.

🚀 Getting started:

Basic example:

import React, { useState } from 'react';
import { useFormoose } from 'formoose';

const schema = () => ({
  name: {
    max: 50,
    required: true,
    type: String
  }
});

function FormooseFormExample({ t }) {
  const {
    formData,
    validateAllFieldsSync,
    setProps
  } = useFormoose(schema(), t);

  const handleSubmit = async e => {
    e.preventDefault();

    let formIsValid;

    try {
      formIsValid = await validateAllFieldsSync();
    } catch (error) {
      console.error(error);
    }

    if (formIsValid) {
      alert('We are good to go!');
    } else {
      alert('oops, something went wrong.');
    }
  };

  return(
    <form onSubmit={handleSubmit}>
      <input type="text" placeholder="Name" {...setProps('name')} />
      <label htmlFor="name">{t(formData.name.message)}</label>
      <button type="submit">Submit</button>
    </form>
  );

}

export default FormooseFormExample;

Demos

Examples available at https://github.com/romulobordezani/formoose-example or at this sand box

Contributing:

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

Running the core project

Install dependencies.

yarn
yarn dev

Type Script will compile to dist folder, use yarn link.

Go to the example repository and run:

yarn link formoose

Run yarn start and the browser should open with some examples using your local Formoose's code. Now you can test and debug your changes.

Looking for something else?

So, you reached the end of this documentation and still think that Formoose is not for you?

No problem! If you aren't interested in using Mogoose schemas to control your forms, or i18n to provide instant translations to control them, or even interested in the Type Script definitions to provide you a great Development Experience - all in a really small package. So...

Probably you are looking for something else like:

And also to use these schema validators with react-hook-form.com or formik

Hope it helps 🍀.