epfl-elements-react

EPFL Elements React Library

The EPFL Elements React library is a collection of React components based on the EPFL Elements Style Guide. There were different attempts to build such a library (elements-react, epfl-sti-react-library), but is now a join task force based on the library developed by the STI faculty.

The code in this repository provides both the EPFL Elements React Storybook, where you can preview each components, and the epfl-elements-react library itself, which is published on the npm registry.

TL;DR (Usage)

1. Bootstrap a new react app using vite:

   ▶ npm create vite
   ✔ Project name: … test-app
   ? Select a framework: › - Use arrow-keys. Return to submit.
       Vanilla
       Vue
   ❯   React
       [...]
       Others
   

2. In the newly create directory, install the library:

   npm install epfl-elements-react
   

3. Import component using the library

   import { Component } from '@epfl/epfl-elements-react'
   

Objectives

The main objective is to provide the EPFL Elements React library simultaneously with EPFL Elements.

In addition, some other objectives are referenced in the user stories.

Explore

The best way to explore the components provided by this library is to browse the Storybook website here: EPFL Elements React Storybook.

Techstack

While it might work otherwise, this library is ment to be used with React > 18.

It uses Storybook > 7, TypeScript > 5.0.2 and Vite > 4.3.

Install

If you are happy with the contents of the library and you would like to use it in your project, you just need to install it as any other NPM dependency, e.g. just use npm i epfl-elements-react. The library is also released under the releases of the GitHub repository.

Extend

Whenever more components that are not in the library are needed, it's possible to extend the library.

See these repositories:

• sti-extra-react

Contribute

We <3 contributions! You can ask us something or report a bug by filling an issue in the repository. If you want to contribute to the code base, feel free to propose a new pull request:

1. Fork the repository
2. Clone your fork
3. Create a new branch for your feature or bug fix
4. Make your changes
5. Commit your changes
6. Push your branch to your fork
7. Open a pull request

Please see CONTRIBUTING.md.

Develop

To run locally and add some feature to this repository, clone the repository and run npm i to install the dependencies. Then

• Use npm run storybook to deploy the Storybook server (https://localhost:6006)
• To prepare the static Storybook content, use npm run build-storybook
• To build the epfl-elements-react library, use npm run build

Please chech that your code follow the coding standards. The npm run lint command will list all the problem.

Please see CONTRIBUTING.md for further details.

Contributors

See contributors.

Thanks

Thanks to Juan C. for building the foundation for this project.