Update README.md (#318)
* delete readme * rm readme * update readme * update readme * update * Update README.md * Update README.md * update readme Co-authored-by: Pavel <14926950+prichodko@users.noreply.github.com>
This commit is contained in:
parent
35980656e3
commit
dc70bc8cff
88
README.md
88
README.md
|
@ -1,3 +1,89 @@
|
||||||
# Status Communities for the Web
|
# Status Web 🌐
|
||||||
|
|
||||||
[![CI](https://github.com/status-im/status-web/actions/workflows/ci.yml/badge.svg)](https://github.com/status-im/status-web/actions/workflows/ci.yml)
|
[![CI](https://github.com/status-im/status-web/actions/workflows/ci.yml/badge.svg)](https://github.com/status-im/status-web/actions/workflows/ci.yml)
|
||||||
|
|
||||||
|
## About
|
||||||
|
|
||||||
|
Embeddable, customizable and themable component for your Status Community.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### For Community owners 👥
|
||||||
|
|
||||||
|
**Get public key to your pre-existing Community:**
|
||||||
|
|
||||||
|
1. Open Status Desktop
|
||||||
|
2. Select Community
|
||||||
|
3. Click on its overview in upper left corner
|
||||||
|
4. Invite new people
|
||||||
|
5. Share community
|
||||||
|
6. Get only the public key from the URL (e.g. `0x033c88c950480493e2e759923bd38f9aad88e1b36295757a598679a569e6a96801`)
|
||||||
|
|
||||||
|
**Or create new one first:**
|
||||||
|
|
||||||
|
1. Get Status Desktop at <https://status.im/get>
|
||||||
|
2. Go to Chat
|
||||||
|
3. Click on plus icon
|
||||||
|
4. Click on Communities
|
||||||
|
|
||||||
|
**Use the Community component:**
|
||||||
|
|
||||||
|
In your project,
|
||||||
|
|
||||||
|
Install package:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm install @status-im/react
|
||||||
|
```
|
||||||
|
|
||||||
|
Import component:
|
||||||
|
|
||||||
|
```js
|
||||||
|
import { Community } from '@status-im/react'
|
||||||
|
```
|
||||||
|
|
||||||
|
Set component props:
|
||||||
|
|
||||||
|
```js
|
||||||
|
<Community
|
||||||
|
publicKey="0x033c88c950480493e2e759923bd38f9aad88e1b36295757a598679a569e6a96801"
|
||||||
|
theme="light"
|
||||||
|
/>
|
||||||
|
```
|
||||||
|
|
||||||
|
For an example, see [examples/with-vite/src/app.tsx](./examples/with-vite/src/app.tsx).
|
||||||
|
|
||||||
|
### For User 👤
|
||||||
|
|
||||||
|
**Simply visit your Community's URL from the browser:**
|
||||||
|
|
||||||
|
For example, <https://status-devcon.vercel.app/>.
|
||||||
|
|
||||||
|
If the Community doesn't require a joining request, that would be it. So look around and get the feel for the space.
|
||||||
|
|
||||||
|
**Once ready to chat, create a throwaway profile:**
|
||||||
|
|
||||||
|
Use Throwaway Profile > wait for your request to be approved and the chat input enabled > react to and write messages
|
||||||
|
|
||||||
|
**Optionally, you could even run the application locally yourself.**
|
||||||
|
|
||||||
|
Get the source ready:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
git clone https://github.com/status-im/status-web.git
|
||||||
|
cd ./status-web
|
||||||
|
npm install
|
||||||
|
npm build
|
||||||
|
```
|
||||||
|
|
||||||
|
Add your Community's public key to your environment:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
echo 'PUBLIC_KEY="0x033c88c950480493e2e759923bd38f9aad88e1b36295757a598679a569e6a96801"' >> examples/with-vite/.env
|
||||||
|
```
|
||||||
|
|
||||||
|
And run it:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
npm run dev --workspace=examples/with-vite
|
||||||
|
```
|
||||||
|
|
Loading…
Reference in New Issue