# @justeat/f-registration

> Fozzie Registration Form Component

Latest version **3.14.1** (published 2024-04-30) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @justeat/f-registration
pnpm add @justeat/f-registration
yarn add @justeat/f-registration
bun add @justeat/f-registration
```

## 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 | 3.14.1 |
| Published | 2024-04-30 |
| First published | 2020-04-14 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=14 |
| Dependencies | 2 |
| Unpacked size | 2.4 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 14 |
| Maintainers | ilia.chikmarev, fidel.montesino, anastasiia.horban, raouf.sawehli, mmakwe-onyeka, gregory.palaci, arielfdr, dawidchar, roberto.santana, lizzie.turney, davidpn.11, dandel10n, mwh1989, kevinrodrigues, fozzie-bot, ashleynolan, simonsje, xander-marjoram, sergii.semenkiv, thomaswilliammcclean, benrwhite, robertellison, zlatin.ivanov, joshuang2332, oliversweb, andymayje, jamieomaguire, adammorr, lsphillips |
| Keywords | fozzie |

## Links

- npm: https://www.npmjs.com/package/@justeat/f-registration
- Repository: https://github.com/justeat/fozzie-components
- Homepage: https://github.com/justeat/fozzie-components/tree/master/packages/components/pages/f-registration
- Issues: https://github.com/justeat/fozzie-components/issues
- npm.io page: https://npm.io/package/@justeat/f-registration

## Dependencies (2)

- [vuelidate](https://npm.io/package/vuelidate.md) 0.7.6
- [@justeat/f-services](https://npm.io/package/@justeat/f-services.md) 1.x

## Recent versions

- 3.14.1 (latest) — 2024-04-30
- 1.0.0-beta.2 (beta) — 2021-09-08
- 3.14.0 — 2024-03-14
- 3.13.3 — 2023-07-19
- 3.13.2 — 2023-05-30
- 3.13.1 — 2023-02-13
- 3.13.0 — 2022-11-08
- 3.12.0 — 2022-11-07
- 3.11.0 — 2022-11-07
- 3.10.0 — 2022-11-03
- 3.8.0 — 2022-10-28
- 3.7.2 — 2022-10-24
- 3.7.0 — 2022-08-22
- 3.6.1 — 2022-08-19
- 3.6.0 — 2022-08-18
- … 85 more at https://npm.io/package/@justeat/f-registration/versions

## README

<div align="center">

# f-registration

<img width="125" alt="Fozzie Bear" src="../../../../bear.png" />

Registration Component.

</div>

---

[![npm version](https://badge.fury.io/js/%40justeat%2Ff-registration.svg)](https://badge.fury.io/js/%40justeat%2Ff-registration)
[![CircleCI](https://circleci.com/gh/justeat/fozzie-components.svg?style=svg)](https://circleci.com/gh/justeat/workflows/fozzie-components)
[![Coverage Status](https://coveralls.io/repos/github/justeat/f-registration/badge.svg)](https://coveralls.io/github/justeat/f-registration)
[![Known Vulnerabilities](https://snyk.io/test/github/justeat/f-registration/badge.svg?targetFile=package.json)](https://snyk.io/test/github/justeat/f-registration?targetFile=package.json)

---

## Usage

### Installation

Install the module using npm or Yarn:

```sh
yarn add @justeat/f-registration
```

```sh
npm install @justeat/f-registration
```

### Vue Applications

You can import it in your Vue SFC like this (please note that styles have to be imported separately):

```js
import RegistrationComponent from '@justeat/f-registration';
import '@justeat/f-registration/dist/f-registration.css';

export default {
    components: {
        RegistrationComponent
    }
}
```

If you are using Webpack, you can import the component dynamically to separate the `f-registration` bundle from the main `bundle.client.js`:

```js
import '@justeat/f-registration/dist/f-registration.css';

export default {
    components: {
        // …
        RegistrationComponent: () => import(/* webpackChunkName: "vue-registration" */ '@justeat/f-registration')
    }
}
```

### CSS styles

The component is using utility css styles from [fozzie](https://github.com/justeat/fozzie/) package. You need to make sure to `@include trumps-utilities();` mixin to your application styles if you use beta version of fozzie package (>= v5.0.0-beta.0). If you are using main version (v4.X.X) styles should come out of the box.

## Configuration

### Props

| Prop  | Type  | Default | Description |
| ----- | ----- | ------- | ----------- |
| `local` | `String` | `en-gb` | Sets the translation file to use. |
| `createAccountUrl` | `String` | Required | URL to register a new user account. |
| `createAccountTimeout` | `Number` | `1000` | Timeout when submitting the registration form. |
| `showLoginLink` | `Boolean` | Required | If `true`, 'Already on Just Eat` login link will be displayed. |
| `loginUrl` | `String` | Required | URL to forward the user to on navigation to the login page. |

### Events

| Event | Description |
| ----- | ----------- |
| `registration-create-account-success` | Registration form has been successfully submitted. |
| `registration-create-account-failure` | Registration form submission has failed. |
| `registration-create-account-start` | User has begun interacting with registration form. |
| `registration-create-account-inline-error` | Validation on form fields has failed. |
| `registration-visit-login-page` | User clicked 'Already on Just Eat` login link. |
| `registration-login-blocked` | 'FailedUserAuthentication' error has been returned when submitting the registration form. |

## Development

Start by cloning the repository and installing the required dependencies:

```sh
$ git clone git@github.com:justeat/fozzie-components.git
$ cd fozzie-components
$ yarn
```

Change directory to the `f-registration` package:

```sh
$ cd packages/components/molecules/f-registration
```

## Testing

### Unit, Integration and Contract

To test all components, run from root directory.
To test only `f-registration`, run from the `./fozzie-components/packages/f-registration` directory.

```sh
yarn test
```

### Running storybook

Storybook can be used to develop new and existing components.

To start storybook:

From the **root** directory run:

```sh
$ yarn storybook:serve
```

This will build and serve storybook at [http://localhost:6006](http://localhost:6006).

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