Ethlete Frontend SDKs

Monorepo for all the Ethlete frontend SDKs

Packages

Below is a list of all current Ethlete SDKs. An up-to-date list of current todo's can be found here.

@ethlete/core

Core functionalities and utils.

yarn add @ethlete/core

@ethlete/query

Fetch wrapper with caching, request templates, GQL support and Angular helpers

yarn add @ethlete/query

@ethlete/components

Common themeable and WAI-ARIA compliant components.

Storybook docs can be found here:

• main branch: https://ethlete-sdk.web.app/
• next branch: https://next-ethlete-sdk.web.app/

yarn add @ethlete/components

@ethlete/theming

Utilities to make component theming easier.

yarn add @ethlete/theming

@ethlete/contentful

Helpers for usage with Contentful (e.g. rich text rendering).

yarn add @ethlete/theming

@ethlete/types

Up to date typescript definitions for the Ethlete REST API as well as other types shared across SDKs.

yarn add -D @ethlete/types

How to contribute

This mono repository uses:

• Yarn as a package manager.
• Conventional commits for commit messages.
• Changesets for version management and automated releases.

General workflow

Clone the repository:

git clone https://github.com/ethlete-io/ethdk.git

Install dependencies:

yarn install

Create a feat, fix or other branch:

git checkout -B feat/example

Commit your changes via git-cz:

yarn commit

If the changes made should result in a version bump, create a changeset and commit the generated file. All SDKs adhere to the semantic versioning guidelines.

yarn change

# OR if the command above fails for some reason:
npx changeset

Now all that's left is to create a PR and make sure that all workflows pass.

Useful scripts

Script	Description
commit	Run the commit assistant
change	Run the changeset assistant
start	Run the sandbox (test) app in serve mode
storybook	Run the storybook instance
nx:update	Run nx update
nx:migrate	Apply migrations created by nx:update