Skip to content

Commit 8aae34d

Browse files
committed
docs: update README.md
1 parent aacb0e5 commit 8aae34d

File tree

4 files changed

+463
-58
lines changed

4 files changed

+463
-58
lines changed

README.md

Lines changed: 61 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,30 @@
33
[![Platform React-Native](https://img.shields.io/badge/Platform-React--Native-orange.svg)](https://reactnative.dev/)
44
[![Language TypeScript](https://img.shields.io/badge/Language-TypeScript-orange.svg)](https://www.typescriptlang.org/)
55

6+
> React-Native based UI kit based on sendbird javascript SDK
7+
8+
## Introduction
9+
10+
Sendbird UIKit for React-Native is a development kit with an user interface that enables an easy and fast integration of standard chat features into new or existing client apps.
11+
This mono-repository the UIKit source code is consists as explained below.
12+
13+
- [**packages/uikit-react-native**](/packages/uikit-react-native) is where you can find the open source code. Check out [UIKit Open Source Guidelines](/OPENSOURCE_GUIDELINES.md) for more information regarding our stance on open source.
14+
- [**sample**](/sample) is a chat app with UIKit’s core features in which you can see items such as push notifications, total unread message count and auto sign-in are demonstrated. When you sign in to the sample app, you will only see a list of channels rendered by the [GroupChannelListFragment](https://sendbird.com/docs/uikit/v3/react-native/key-functions/list-channels) on the screen.
15+
- [**packages/uikit-react-native-foundation**](/packages/uikit-react-native-foundation) is a UI package for `uikit-react-native`.
16+
- [**packages/uikit-chat-hooks**](/packages/uikit-chat-hooks) is a react hooks package for `uikit-react-native`.
17+
- [**packages/uikit-utils**](/packages/uikit-utils) is a utility package for `uikit-react-native`.
18+
19+
### More about Sendbird UIKit for React-Native
20+
21+
Find out more about Sendbird UIKit for React-Native at [UIKit for React Native doc](https://sendbird.com/docs/uikit/v3/react-native/overview).
22+
If you need any help in resolving any issues or have questions, visit [our community](https://community.sendbird.com).
23+
24+
<br/>
25+
626
## Requirements
727

828
- Nodejs 14 or newer
29+
- [yarn v1](https://classic.yarnpkg.com/en/docs/install)
930
- Watchman
1031
- JDK 11 or newer
1132
- XCode
@@ -15,20 +36,56 @@ More details, please see https://reactnative.dev/docs/environment-setup
1536

1637
<br/>
1738

18-
## Development
39+
## Try the sample app
40+
41+
We are using sample app for development, you can check the sample app [here](/sample) and also check the UI components via storybook in the sample app.
1942

20-
We tried development on macOS / Linux systems. You might encounter problems in running sample or scripts like `yarn build` in Windows machines. We are using sample app for development, you can check the sample app [here](/sample) and also check the UI components via storybook in the sample app.
43+
### Installation
2144

22-
### Run sample app
45+
> Every script should be run on the root of the project.
46+
47+
**Install node modules**
2348

2449
```shell
2550
yarn install
26-
npx pod-install
51+
```
52+
53+
**Linking native modules of sample app**
54+
55+
```shell
56+
yarn sample:pod-install
57+
```
2758

59+
**Running sample app**
60+
61+
- Android
62+
63+
```shell
2864
yarn sample:android
65+
```
66+
67+
- iOS
68+
69+
```shell
2970
yarn sample:ios
3071
```
3172

73+
### Sample app using your data
74+
75+
Create a file to `sample/src/env.ts` and write the code below to the file you created.
76+
77+
```ts
78+
export const APP_ID = '2D7B4CDB-932F-4082-9B09-A1153792DC8D';
79+
```
80+
81+
If you would like to try the sample app specifically fit to your usage, you can do so by replacing the default sample app ID with yours, which you can obtain by creating your [Sendbird application from the dashboard](https://dashboard.sendbird.com/).
82+
83+
<br />
84+
85+
## Development
86+
87+
We tried development on macOS / Linux systems. You might encounter problems in running sample or scripts like `yarn build` in Windows machines.
88+
3289
### Creating a new key function files
3390

3491
Run the script and enter the key function name as a lower camel case like `groupChannel`, and then you can see the auto generated files in the `/packages/uikit-react-native/src/domain`

package.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@
3131
"lint:prettier": "prettier --check \"sample/src/**/*.{ts,tsx}\" \"packages/*/src/**/*.{ts,tsx}\"",
3232
"fix:eslint": "eslint --fix packages/*/src --ext ts,tsx -c ./.eslintrc.js",
3333
"fix:prettier": "prettier --write \"sample/src/**/*.{ts,tsx}\" \"packages/*/src/**/*.{ts,tsx}\"",
34+
"sample:pod-install": "cd sample/ios && pod install",
3435
"sample:ios": "cd sample && yarn ios",
3536
"sample:android": "cd sample && yarn android",
3637
"deploy:ios": "cd sample/ios && bundle exec fastlane deploy",

0 commit comments

Comments
 (0)