Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix: update README.md #53

Merged
merged 6 commits into from
Apr 10, 2024
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 60 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,26 +1,70 @@
# 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
## Installation

** 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).
To install the Amity UI-Kit together with another project, follow these steps:

### Documentation
1. Clone the repository using the following command:

Please refer to our online documentation at https://docs.amity.co or contact a Ui-Kit representative at **[email protected]** for support.
```
git clone [email protected]:AmityCo/Amity-Social-Cloud-UIKit-Web-OpenSource.git
```
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.


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>
```

Please note that this installation process is intended for local development environments. If you wish to publish your custom open-source project, you will need to create and publish a new npm package independently.

## 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/EkoCommunications/AmityUiKitWeb/blob/develop/CONTRIBUTING.md) for guidelines and best practices.

Thank you for choosing the Amity UI-Kit for your web development needs!
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.

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

This file was deleted.

Loading
Loading