@pushengineering/umg-web-components 2.0.3 → 2.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/readme.md +22 -69
package/package.json
CHANGED
package/readme.md
CHANGED
|
@@ -1,81 +1,34 @@
|
|
|
1
|
-
# Table of Contents
|
|
2
1
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
- [Local Development Environment](#local-development-environment)
|
|
7
|
-
- [Prerequisites](#prerequisites)
|
|
8
|
-
- [Installation](#installation)
|
|
9
|
-
- [Build scripts](#build-scripts)
|
|
10
|
-
- [Lit - Lightning-Fast Components](#lit---lightning-fast-components)
|
|
11
|
-
- [Storybook Integration for Component Previews and Documentation](#storybook-integration-for-component-previews-and-documentation)
|
|
2
|
+
# UMG Web Components Library
|
|
3
|
+
This library provides a collection of native UX web components built with [Lit](https://lit.dev/docs/).
|
|
4
|
+
The components are designed to be fast, reusable, and highly customisable for any project, without relying on proprietary technologies or frameworks. They leverage standard Web APIs and are compatible with all modern browsers.
|
|
12
5
|
|
|
13
|
-
|
|
14
|
-
Welcome to the UMG UX Components Library! This library provides a collection of UX frontend components designed to be fast, reusable, and highly customisable for any project, without relying on proprietary technologies or frameworks. These components leverage standard Web APIs and are compatible with all modern browsers.
|
|
6
|
+
Components are exported as native ES Modules and can be directly used in web applications using raw module imports. If your application does not support native modules, tools like Rollup or Webpack can be used to prepare the components for serving in your production environment as needed.
|
|
15
7
|
|
|
16
|
-
|
|
17
|
-
To deepen your understanding of web components, their key concepts, and the specific web APIs we employ, we recommend reading the [MDN guide on Web Components](https://developer.mozilla.org/en-US/docs/Web/API/Web_components).
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
# Local Development Environment
|
|
21
|
-
|
|
22
|
-
## Prerequisites
|
|
23
|
-
|
|
24
|
-
Before you begin, make sure you have the following prerequisites installed on your system:
|
|
25
|
-
|
|
26
|
-
Node.js v16.14 or higher. You can download it from [here](https://nodejs.org/en/download)
|
|
27
|
-
[PNPM](https://pnpm.io/) v8 or higher. Install it via these links: [Mac](https://github.com/nvm-sh/nvm) | [Windows](https://github.com/coreybutler/nvm-windows)
|
|
8
|
+
To keep code sizes to a minimum Lit is not exported with the library and will need to be installed as a dependency of your project.
|
|
28
9
|
|
|
29
10
|
## Installation
|
|
30
|
-
1. Install Node.js globally using one of the following methods:
|
|
31
|
-
- Mac: [NVM](https://github.com/nvm-sh/nvm)
|
|
32
|
-
- Windows: [NVM for Windows](https://github.com/coreybutler/nvm-windows)
|
|
33
|
-
- Direct download: [Node.js](https://nodejs.org/en/download)
|
|
34
|
-
|
|
35
|
-
2. Install PNPM globally using one of the following methods:
|
|
36
|
-
- Mac: ``brew install pnpm``
|
|
37
|
-
- Windows PowerShell: Run the command ``iwr https://get.pnpm.io/install.ps1 -useb | iex``
|
|
38
|
-
|
|
39
|
-
For more details, check the: [PNPM documentation](https://pnpm.io/)
|
|
40
|
-
|
|
41
|
-
1. Clone the project repository using this command:
|
|
42
|
-
```
|
|
43
|
-
git clone git@github.com:Push-Entertainment/umg-component-library.git
|
|
44
|
-
```
|
|
45
11
|
|
|
46
|
-
|
|
47
|
-
```
|
|
48
|
-
pnpm install
|
|
49
|
-
```
|
|
12
|
+
Install the package as dependency of your application:
|
|
50
13
|
|
|
51
|
-
|
|
14
|
+
`npm i @pushengineering/umg-web-components`
|
|
15
|
+
`yarn add @pushengineering/umg-web-components`
|
|
16
|
+
`pnpm add @pushengineering/umg-web-components`
|
|
52
17
|
|
|
53
|
-
|
|
18
|
+
Install Lit as a dependency:
|
|
54
19
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
- Build components, design tokens and Storybook static site: `pnpm build-all`
|
|
59
|
-
- Build design tokens: `pnpm build-tokens`
|
|
60
|
-
- Build Storybook static site: `pnpm build-storybook`
|
|
61
|
-
|
|
62
|
-
# Lit - Lightning-Fast Components
|
|
63
|
-
|
|
64
|
-
Our library is built using Lit, a framework that simplifies component development without sacrificing performance or relying on non-standard frameworks. Lit builds on web component standards, is lightweight, and reduces boilerplate code. You can find Lit 2's documentation [here](https://lit.dev/docs/).
|
|
65
|
-
|
|
66
|
-
To save time, minimise errors, and future-proof your code, we've written this library in TypeScript and utilise Lit's decorator methods, which TypeScript transpiles into browser-compatible JavaScript.
|
|
67
|
-
|
|
68
|
-
# Storybook Integration for Component Previews and Documentation
|
|
69
|
-
|
|
70
|
-
We've seamlessly integrated Storybook into our component library to provide you with a powerful playground tool with component previews and comprehensive documentation. Storybook serves as a valuable resource for both developers and designers, offering a visual representation of each component's behavior and appearance in different scenarios.
|
|
71
|
-
|
|
72
|
-
- Exploring Components in Storybook
|
|
73
|
-
With Storybook, you can easily navigate and explore our components:
|
|
74
|
-
|
|
75
|
-
- Preview Components: View live, interactive previews of each component to understand how they look and behave in various situations.
|
|
20
|
+
`npm i lit`
|
|
21
|
+
|
|
22
|
+
## Further information
|
|
76
23
|
|
|
77
|
-
|
|
24
|
+
[Push Engineering Git Repository](https://github.com/Push-Entertainment/umg-component-library)
|
|
78
25
|
|
|
79
|
-
|
|
26
|
+
## Release Version 2
|
|
27
|
+
- Supports UMG Grand Royal layouts:
|
|
28
|
+
- Single Slick V1 themes
|
|
29
|
+
- Multipage Slick V1 themes
|
|
80
30
|
|
|
81
|
-
|
|
31
|
+
### Patches in this release
|
|
32
|
+
- Social component
|
|
33
|
+
- Social icon links target property was not being passed to child button icons.
|
|
34
|
+
- Missing social icons previously added to the Icon component had not merged into the main release branch.
|