# angel-form

> A form state management package for React.

Latest version **1.0.7** (published 2023-03-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install angel-form
pnpm add angel-form
yarn add angel-form
bun add angel-form
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.7 |
| Published | 2023-03-22 |
| First published | 2023-03-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 55 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Benedict Gabriel |
| Maintainers | iambenhexie |
| Keywords | react, form, forms, state, hook, form-validation |

## Links

- npm: https://www.npmjs.com/package/angel-form
- Repository: https://github.com/benhexie/angel-form
- npm.io page: https://npm.io/package/angel-form

## Dependencies (4)

- [prop-types](https://npm.io/package/prop-types.md) ^15.8.1
- [react-redux](https://npm.io/package/react-redux.md) ^8.0.5
- [@reduxjs/toolkit](https://npm.io/package/@reduxjs/toolkit.md) ^1.9.3
- [reactjs-stylesheet](https://npm.io/package/reactjs-stylesheet.md) ^1.0.9

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.0.7 (latest) — 2023-03-22
- 1.0.6 — 2023-03-02
- 1.0.5 — 2023-03-02
- 1.0.4 — 2023-03-02
- 1.0.3 — 2023-03-02
- 1.0.2 — 2023-03-02
- 1.0.1 — 2023-03-02
- 1.0.0 — 2023-03-02

## README

<div align="center">
  
  ## Please do not install this package. We are currently fixing some errors. We're sorry if you had to deal with that.

  <img src="https://github.com/benhexie/angel-form/blob/d2c9af7c85ba1e23c0abe21793449cc1b2e92460/assets/logo/angel-form-cover.png?raw=true" width="100%" />
</div>

# angel-form

A form state management package for React.

### Features

- Familiar syntax with support for native form elements.
- Boosts deeveloper speed with out-of-the-box state management.

### Coming Soon

- User entry validation

### Install

    npm install angel-form

### Quickstart

```jsx
import { useEffect, useState } from 'react'
import {Button, Form, Input, Checkbox, Radio,
  Select, Option, Textarea, Validator } from './packages/angel-form';

const App = () => {

  const [formState, setFormState] = useState({})

  const form = (
    <Form stateHandler={setFormState}>    // Links angel-form to your project
      <Input id='username' placeholder='Username'>Hello World</Input>
      <Input id='Password' type={'password'}></Input>
      <Input id='button' type='button'>Click Me!</Input>
      <Button onClick={(e) => {
        e.preventDefault()
        alert('Hello')
      }}>Submit</Button>
      <Select id='countries' defaultValue='paris'>
        <Option value="nigeria">Nigeria</Option>
        <Option value="paris">Paris</Option>
        <Option value="turkey">Turkey</Option>
      </Select>
      <Checkbox name="subjects" defaultChecked>Mathematics</Checkbox>
      <Checkbox name="subjects">English</Checkbox>
      <Checkbox name="subjects">Chemistry</Checkbox>
      <Radio name="language">English</Radio>
      <Radio name="language" defaultChecked>Spanish</Radio>
      <Radio name="language">French</Radio>
      <Input type='checkbox' name='seasons' value='summer'>Summer</Input>
      <Input type='checkbox' name='seasons'>Winter</Input>  // omitting the value property
      <Textarea id={'message'}>Message:</Textarea>          // would set the value to 'Winter' automatically
    </Form>
  )

  console.log(formState)    // view form state

  return (
    <div className="App">
      {form}
    </div>
  );
```

### Contributors

[FlexiSaf CohortT12023](https://www.linkedin.com/company/flexisafedusoftlimited/mycompany/)

##### Contributions are welcome :)

---
_Source: https://npm.io/package/angel-form · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._