Skip to content

Commit

Permalink
Add and tweak READMEs
Browse files Browse the repository at this point in the history
  • Loading branch information
simonihmig committed Mar 3, 2023
1 parent 30e7a1e commit 8646d1b
Show file tree
Hide file tree
Showing 8 changed files with 72 additions and 15 deletions.
19 changes: 16 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,23 @@
# ember-headless-form

[Short description of the addon.]
[![CI](https://github.com/CrowdStrike/ember-headless-form/actions/workflows/ci.yml/badge.svg?branch=main&event=push)](https://github.com/CrowdStrike/ember-headless-form/actions/workflows/ci.yml)

The Ember.js addon that distills the common behavior and accessibility best practices of forms into reusable components, without any opinions on specific markup or styling. Use it to build your forms directly, or to build your opinionated forms component kit on top of it.

## Key Features

- Semantic form markup with accessibility best practices baked in
- Integrates native HTML5 validation with custom error rendering
- Extension points for custom JavaScript-based validation
- Optional ready-to-use integrations for `ember-changeset` and `yup` based validation
- Support for async state
- TypeScript / Glint support with tight types
- Octane-based v2 addon
- Fully tested

## Compatibility

- Ember.js v4.8 or above
- Ember.js v4.4 or above
- Embroider or ember-auto-import v2

## Installation
Expand All @@ -15,7 +28,7 @@ ember install ember-headless-form

## Usage

[Longer description of how to use the addon in apps.]
Visit our [documentation website](https://ember-headless-form.pages.dev/).

## Contributing

Expand Down
1 change: 0 additions & 1 deletion packages/changeset/.gitignore
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
# The authoritative copies of these live in the monorepo root (because they're
# more useful on github that way), but the build copies them into here so they
# will also appear in published NPM packages.
/README.md
/LICENSE.md
26 changes: 26 additions & 0 deletions packages/changeset/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# ember-headless-form-changeset

Integrates [`ember-changeset`](https://github.com/poteto/ember-changeset) and optionally [`ember-changeset-validations`](https://github.com/poteto/ember-changeset-validations/) seamlessly with the validation support of [ember-headless-form](https://github.com/CrowdStrike/ember-headless-form).

## Compatibility

- Ember.js v4.4 or above
- Embroider or ember-auto-import v2

## Installation

```
ember install ember-headless-form-changeset
```

## Usage

Visit our [documentation website](https://ember-headless-form.pages.dev/).

## Contributing

See the [Contributing](CONTRIBUTING.md) guide for details.

## License

This project is licensed under the [MIT License](LICENSE.md).
5 changes: 1 addition & 4 deletions packages/changeset/rollup.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -50,10 +50,7 @@ export default {

// Copy Readme and License into published package
copy({
targets: [
{ src: '../README.md', dest: '.' },
{ src: '../LICENSE.md', dest: '.' },
],
targets: [{ src: '../../LICENSE.md', dest: '.' }],
}),
],
};
4 changes: 2 additions & 2 deletions packages/ember-headless-form/rollup.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,8 @@ export default {
// Copy Readme and License into published package
copy({
targets: [
{ src: '../README.md', dest: '.' },
{ src: '../LICENSE.md', dest: '.' },
{ src: '../../README.md', dest: '.' },
{ src: '../../LICENSE.md', dest: '.' },
],
}),
],
Expand Down
1 change: 0 additions & 1 deletion packages/yup/.gitignore
Original file line number Diff line number Diff line change
@@ -1,5 +1,4 @@
# The authoritative copies of these live in the monorepo root (because they're
# more useful on github that way), but the build copies them into here so they
# will also appear in published NPM packages.
/README.md
/LICENSE.md
26 changes: 26 additions & 0 deletions packages/yup/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# ember-headless-form-yup

Integrates [`yup`](https://github.com/jquense/yup) based schemas seamlessly with the validation support of [ember-headless-form](https://github.com/CrowdStrike/ember-headless-form).

## Compatibility

- Ember.js v4.4 or above
- Embroider or ember-auto-import v2

## Installation

```
ember install ember-headless-form-yup
```

## Usage

Visit our [documentation website](https://ember-headless-form.pages.dev/).

## Contributing

See the [Contributing](CONTRIBUTING.md) guide for details.

## License

This project is licensed under the [MIT License](LICENSE.md).
5 changes: 1 addition & 4 deletions packages/yup/rollup.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -50,10 +50,7 @@ export default {

// Copy Readme and License into published package
copy({
targets: [
{ src: '../README.md', dest: '.' },
{ src: '../LICENSE.md', dest: '.' },
],
targets: [{ src: '../../LICENSE.md', dest: '.' }],
}),
],
};

0 comments on commit 8646d1b

Please sign in to comment.