Skip to content

The chayns React API provides a variety of helpful features to enhance your site.

License

Notifications You must be signed in to change notification settings

TobitSoftware/chayns-api

Repository files navigation

The chayns-api provides information and useful functions to your page. The information and functions are provided by react hooks and normal functions. A list of all functions and hooks can be found here.

Installation

It is recommended to setup your new chayns page with the create-chayns-app.

Migrate old project

  1. Install chayns-api package
# NPM
$ npm install chayns-api

# Yarn
$ yarn add chayns-api
  1. Wrap your App component with the "ChaynsProvider" component. In all components which are under the ChaynsProvider you can use hooks and chayns functions.
<ChaynsProvider>
   <App/>
</ChaynsProvider>

Example

import { useUser } from 'chayns-api';

const FirstName = () => {
    const user = useUser();

    return (
        <div>{user?.firstName}</div>
    );
}

Migrate v1 to v2

When updating to chayns-api@2 you should also update chayns-toolkit to 3.0.1 or higher (check migration guide here).

Check urls referencing remoteEntry.js. The filename has been changed to v2.remoteEntry.js.

When your application uses ChaynsHost with module-type you might have to add a call of initModuleFederationSharing as early as possible in your application (e.g. index/bootstrap). Unless your application is already embedded as module somewhere else (e.g. in a dialog).

initModuleFederationSharing({ name: 'project_name' });

Getting started

More information to setup chayns-api can be found in the documentation.

Troubleshooting

Can't resolve 'react-dom/client'

A warning like above can be shown when you are still using react 17. This can be ignored because the react 17 api is used as fallback instead.

License

About

The chayns React API provides a variety of helpful features to enhance your site.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published