# cs.forms

> A collection of forms components, helpers and abstractions built in React. These can be used with or without Redux.

Latest version **2.0.7** (published 2017-10-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install cs.forms
pnpm add cs.forms
yarn add cs.forms
bun add cs.forms
```

## Health

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

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: insecure dependencies; abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.7 |
| Published | 2017-10-08 |
| First published | 2017-08-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 10 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Blue Chilli Technology Pty Ltd |
| Maintainers | iamdifferent |
| Keywords | react, redux, form, forms |

## Links

- npm: https://www.npmjs.com/package/cs.forms
- Repository: https://github.com/BlueChilli/ChilliSource.Web.Forms
- Homepage: https://github.com/BlueChilli/ChilliSource.Web.Forms#readme
- Issues: https://github.com/BlueChilli/ChilliSource.Web.Forms/issues
- npm.io page: https://npm.io/package/cs.forms

## Dependencies (10)

- [moment](https://npm.io/package/moment.md) ^2.18.1
- [cs.core](https://npm.io/package/cs.core.md) github:bluechilli/ChilliSource.Web.Core#1.0.6
- [immutable](https://npm.io/package/immutable.md) ^3.8.1
- [classnames](https://npm.io/package/classnames.md) ^2.2.5
- [@types/react](https://npm.io/package/@types/react.md) ^15.0.27
- [react-select](https://npm.io/package/react-select.md) ^1.0.0-rc.3
- [jsx-to-string](https://npm.io/package/jsx-to-string.md) ^1.1.0
- [react-date-range](https://npm.io/package/react-date-range.md) ^0.9.3
- [react-syntax-highlighter](https://npm.io/package/react-syntax-highlighter.md) ^5.7.0
- [react-async-script-loader](https://npm.io/package/react-async-script-loader.md) ^0.3.0

## 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

- 2.0.7 (latest) — 2017-10-08
- 2.0.6 — 2017-10-07
- 2.0.5 — 2017-10-06
- 2.0.4 — 2017-09-29
- 2.0.3 — 2017-09-26
- 2.0.2 — 2017-09-26
- 2.0.1 — 2017-09-26
- 1.0.96 — 2017-09-26
- 1.0.95 — 2017-09-20
- 1.0.94 — 2017-09-13
- 1.0.93 — 2017-09-06
- 1.0.92 — 2017-09-06
- 1.0.91 — 2017-09-06
- 1.0.90 — 2017-09-06
- 1.0.89 — 2017-09-05
- … 26 more at https://npm.io/package/cs.forms/versions

## README

# ChilliSource.Web.Forms        ![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
This project is part of the ChilliSource framework developed by [BlueChilli](https://github.com/BlueChilli).

# Summary
ChilliSource.Web.Forms is a collection of React form components, helpers and abstractions that are shared across all React-based ChilliSource.Web frameworks.

# Main Features

## Reusable Components
Standard components like `input`, `button` and the rest are already available to use directly in React projects. Our components build upon these standard components to provide React-style way of using them. The list:
- `CheckBox`
- `DatePicker`
- `DropZone`
- `Form`
- `Input`
- `Number`
- `Radio`
- `Select`
- `Switch` (base component for CheckBox & Radio)
- `TextArea`

## State Retention
The state of the form is stored within the `Form` itself. Although this framework can be used with Redux, not having it within your stack will not prevent you from using it.

## Validations
All the components can have their own validation(even custom validation is allowed) with custom validation messages as your project requires. The `Validation` component provides the necessary implementation so that you can directly start using them.
```js
<Input name="sample-input" required maxLength="6">
  <Validation isFor="required">This input can not be blank.</Validation>
  <Validation isFor="maxLength">You can only enter a max of 50 characters</Validation>
</Input>
```

# Installation
The library is available via NPM here
```
npm install --save cs.forms
```

# Releases
See the [releases](https://github.com/BlueChilli/ChilliSource.Web.Forms/releases).

# Contribution
Please see the [contribution guide](https://github.com/BlueChilli/ChilliSource.Web/blob/master/CONTRIBUTING.md).

# License
ChilliSource.Web.Forms is licensed under the [MIT license](https://github.com/BlueChilli/ChilliSource.Web/blob/master/LICENSE).

# Feedback and Contact
For questions or feedback, please contact us at [chillisource@bluechilli.com](mailto:chillisource@bluechilli.com)

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