Skip to content

Commit

Permalink
fix: update README.md (AmityCo#53)
Browse files Browse the repository at this point in the history
  • Loading branch information
bonanaaaaaa authored Apr 10, 2024
1 parent 5398235 commit c56f69c
Show file tree
Hide file tree
Showing 64 changed files with 80 additions and 1,798 deletions.
94 changes: 78 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,88 @@
# Amity Ui-Kit for Web (open-source)
# Amity UI-Kit for Web (Open-Source)

## Getting started
## Prerequisites

### Installation
Before getting started, ensure that you have the following prerequisites installed on your system:

Here are the steps to install ui-kit together with another project.
- [Node.js](https://nodejs.org/) LTS version (currently version 20)
- [pnpm](https://pnpm.io/) version 8

1. git clone [email protected]:AmityCo/Amity-Social-Cloud-UIKit-Web-OpenSource.git
2. cd ./Amity-Social-Cloud-UIKit-Web-OpenSource
3. npm ci
4. npm link
5. npm link ./`<path-to-your-app>`/node_modules/react ./`<path-to-your-app>`/node_modules/react-dom
6. npm run build
7. cd ./`<path-to-your-app>`
8. npm link @amityco/ui-kit-open-source --save
## (Optional) How to install PNPM

** We need to link react module to react module in destination project so that react is the same instance otherwise we will encounter [issues with react hook](https://medium.com/bbc-product-technology/solving-the-problem-with-npm-link-and-react-hooks-266c832dd019).
```
corepack enable pnpm
```

### Documentation
Ref: https://pnpm.io/installation#using-corepack

Please refer to our online documentation at https://docs.amity.co or contact a Ui-Kit representative at **[email protected]** for support.
## Installation

To install the Amity UI-Kit together with another project, follow these steps:

1. Clone the repository using the following command:

```
git clone https://github.com/AmityCo/Amity-Social-Cloud-UIKit-Web-OpenSource.git
```

2. Navigate to the cloned repository's directory:

```
cd ./Amity-Social-Cloud-UIKit-Web-OpenSource
```

3. Install the dependencies using pnpm:

```
pnpm install
```

4. Build the project:

```
pnpm run build
```

5. Navigate to your application's directory:

```
cd <path-to-your-app>
```

6. Link the Amity UI-Kit repository to your application using one of the following package managers:
- NPM:
```
npm link file:<path-to-amity-ui-kit-repository> --save
```
- Yarn (Classic):
```
yarn add file:<path-to-amity-ui-kit-repository>
```
- PNPM:
```
pnpm i file:<path-to-amity-ui-kit-repository>
```
## Documentation
For detailed information and guidance on using the Amity UI-Kit, please refer to our comprehensive online documentation available at [https://docs.amity.co](https://docs.amity.co).
If you require further assistance or have any questions, please don't hesitate to contact our dedicated UI-Kit support team at **[email protected]**. We are here to help you make the most of the Amity UI-Kit.
## Contributing
See [our contributing guide](https://github.com/EkoCommunications/AmityUiKitWeb/blob/develop/CONTRIBUTING.md)
We welcome contributions from the community to help improve and enhance the Amity UI-Kit. If you are interested in contributing to this project, please review our [contributing guide](https://github.com/AmityCo/Amity-Social-Cloud-UIKit-Web-OpenSource/blob/develop/contributing.md) for guidelines and best practices.
Thank you for choosing the Amity UI-Kit for your web development needs!
### FAQ
Q: I tried to run `pnpm build` and it throws a types error.
A: Try to structure your project to be like this:
```
- your_app
- src
- Amity-Social-Cloud-UIKit-Web-OpenSource
- src
```
4 changes: 2 additions & 2 deletions package.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"name": "@amityco/ui-kit",
"name": "@amityco/ui-kit-open-source",
"version": "4.0.0-beta.1",
"engines": {
"node": ">=16",
Expand Down Expand Up @@ -34,7 +34,7 @@
"tsc": "tsc"
},
"peerDependencies": {
"@amityco/ts-sdk": "~6.20.0",
"@amityco/ts-sdk": "~6.21.0",
"react": ">=17.0.2",
"react-dom": ">=17.0.2"
},
Expand Down
22 changes: 0 additions & 22 deletions src/icons/ArrowLeft.jsx

This file was deleted.

21 changes: 0 additions & 21 deletions src/icons/ArrowRight.jsx

This file was deleted.

35 changes: 0 additions & 35 deletions src/icons/Balloon.jsx

This file was deleted.

24 changes: 0 additions & 24 deletions src/icons/Ban.jsx

This file was deleted.

21 changes: 0 additions & 21 deletions src/icons/Bars.jsx

This file was deleted.

21 changes: 0 additions & 21 deletions src/icons/Camera.jsx

This file was deleted.

22 changes: 0 additions & 22 deletions src/icons/Category.jsx

This file was deleted.

20 changes: 0 additions & 20 deletions src/icons/Check.jsx

This file was deleted.

24 changes: 0 additions & 24 deletions src/icons/CheckCircle.jsx

This file was deleted.

20 changes: 0 additions & 20 deletions src/icons/ChevronDown.jsx

This file was deleted.

21 changes: 0 additions & 21 deletions src/icons/ChevronLeft.jsx

This file was deleted.

Loading

0 comments on commit c56f69c

Please sign in to comment.