fantoastic v1.0.4

Fantoastic

A fantastic library for all your toast needs.

Getting started

1. Install the library (React >= 16.8.0 is required)

npm install fantoastic --save

2. Import the ToastProvider at the root of your React application (ex. App.jsx) and wrap your application

import { withToastProvider } from 'fantoastic';

const App = () => {
  ...
  ...
  ...
}

const AppWithToastProvider = withToastProvider(App);
export default AppWithToastProvider;

3. You can now use the toast hook anywhere in the app where a toast is needed.

import { useToast } from 'fantoastic';

const SomeComponent = () => {
  const toast = useToast();

  const handleCreateToast = () => {
    toast.add('The simplest of the toasts.');
  };

return (
  <>
    <button onClick={handleCreateToast}>Click me!</button>
  </>
)

Extra configuration

The toast can be called with a variety of options: toast.add(content, options)

  toast.add('I am a fantastic toast', {
    position: 'topRight',
    variant: 'default',
    duration: '5000',
    persist: false,
    withCloseIcon: false,
  })

The complete list of confirations:

Development

Download the repo and in the root run npm run i-all to install all dependancies.

Installing

After installing dependancies, run npm run dev to start the development environment.

Running the tests

Run the tests and listen for changes with npm run test or npm run test:once to run only once.

Contributing

Contributions are more than welcome!

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

License

This project is licensed under the ISC License.