Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rescriptbr/reform

📋 Reasonably making forms sound good
https://github.com/rescriptbr/reform

forms react react-form reasonml reform rescript rescript-forms rescript-react rescript-react-form typed-form

Last synced: about 2 months ago
JSON representation

📋 Reasonably making forms sound good

Host: GitHub
URL: https://github.com/rescriptbr/reform
Owner: rescriptbr
License: mit
Created: 2017-10-25T15:21:42.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2024-01-22T12:20:03.000Z (8 months ago)
Last Synced: 2024-04-14T10:15:41.013Z (5 months ago)
Topics: forms, react, react-form, reasonml, reform, rescript, rescript-forms, rescript-react, rescript-react-form, typed-form
Language: ReScript
Homepage: https://rescript-reform.netlify.app/
Size: 4.94 MB
Stars: 351
Watchers: 8
Forks: 41
Open Issues: 7
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-list - reform

README

[![All Contributors](https://img.shields.io/badge/all_contributors-13-orange.svg?style=flat-square)](#contributors)
[![npm version](https://badge.fury.io/js/@rescriptbr%2Freform.svg)](https://badge.fury.io/js/@rescriptbr%2Freform)

Documentation •
Installation •
Getting started •
Live demo

## Installation 📦

```
yarn add @rescriptbr/reform @rescriptbr/reschema
```

Then add it to bsconfig.json

```
"bs-dependencies": [
"@rescriptbr/reform",
"@rescriptbr/reschema"
]
```

Then add lenses-ppx

```
yarn add lenses-ppx -D
```

And update your bsconfig.json with `ppx-flags`

```
"ppx-flags": [
"lenses-ppx/ppx"
]
```

## Why? 💡

As you might know, you can use any existing React / JavaScript libraries with ReScript, including form libraries like Formik, react-hook-form, Final Form, since you install or create bindings for these libraries. ReForm is not a set of bindings for an existing form library, it was created from scratch to use with ReScript and React.

Code that deals with strongly typed forms can quickly become walls of repeated text. We created ReForm to be both deadly simple and to make forms sound good leveraging ReScript's powerful typesytem. Even the schemas we use are nothing more than constructors built-in in the language itself with a small size footprint.

## Features ⚡

- Hook API
- Schema API
- Type safe, `handleChange` properly infers the value of the field it is handling
- Context Provider
- Field component
- Validation strategy, OnDemand and OnChange

## Alternatives 🔥

- [Formality](https://github.com/alexfedoseev/re-formality)

## Support 🚀

🌍 We usually hang out at https://forum.rescript-lang.org/ so feel free to ask anything there.

🇧🇷 🇵🇹 Se você é Brasileiro, Português ou fala português, você pode entrar contato através do discord do [ReScriptBR](http://discord.com/invite/SSDMNYQ).

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

_{Thomas Deconinck}
📖 💻

_{Gabriel Rubens}
💻 🐛 🤔 🖋 📖

_{Lucas Besen}
🚧

_{Jefferson Carvalho}
💻

_{Luiz Augusto Moratelli}
💻

_amythos
💻

_{Lalli Nuorteva}
🐛

_Matt
🚧

_{Kyle Davis}
👀

_{Ulugbek Abdullaev}
🐛

_{Khoa Nguyen}
💻

_{Medson Oliveira}
💻 🤔

_{Ana Luiza Portello Bastos}
📖

_{Freddy Harris}
🐛

_arthur
📖 💻

_{Marcos Oliveira}
📖 🎨

_{Celso Bonutti}
💻

_{Jason Smythe}
💻 📖