2022-10-11 00:11:35 +00:00
|
|
|
# Status Web 🌐
|
2022-06-29 14:46:51 +00:00
|
|
|
|
|
|
|
[![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)
|
2022-10-11 00:11:35 +00:00
|
|
|
|
|
|
|
## About
|
|
|
|
|
|
|
|
Embeddable, customizable and themable component for your Status Community.
|
|
|
|
|
2022-10-11 13:47:46 +00:00
|
|
|
### Who
|
|
|
|
|
|
|
|
- For community leaders
|
|
|
|
- online content creators
|
|
|
|
- and their followers
|
|
|
|
|
2022-10-11 22:46:10 +00:00
|
|
|
### What
|
2022-10-11 13:47:46 +00:00
|
|
|
|
|
|
|
- It is 100% open source
|
|
|
|
- 100% decentralized
|
|
|
|
- Peer-to-peer
|
|
|
|
- Private
|
|
|
|
- Pseudoanonymous
|
|
|
|
- End-to-end encrypted
|
|
|
|
- Free
|
|
|
|
- Permissionless
|
|
|
|
- Serverless
|
|
|
|
- Group chat platform
|
|
|
|
- And a virtual space outside the jurisdiction of any government
|
|
|
|
|
|
|
|
### Why
|
|
|
|
|
|
|
|
- To communicate and collaborate freely without worrying about
|
2022-10-11 22:46:10 +00:00
|
|
|
- Censorship
|
|
|
|
- Persecution
|
|
|
|
- Chilling effects
|
|
|
|
- Interference
|
|
|
|
- Oppression
|
|
|
|
- Being deplatformed, or shut down
|
2022-10-11 13:47:46 +00:00
|
|
|
- Support
|
2022-10-11 22:46:10 +00:00
|
|
|
- Autonomy
|
|
|
|
- Free speech
|
|
|
|
- Freedom of association
|
|
|
|
- Freedom to transact
|
|
|
|
- Right to privacy
|
|
|
|
- Crypto native and frictionless integration
|
|
|
|
- Monetization
|
|
|
|
- Facilitation of sharing of common interests, needs, desires and values
|
2022-10-11 13:47:46 +00:00
|
|
|
- Be trusted alternative to centralized group chat application
|
|
|
|
|
2022-10-11 00:11:35 +00:00
|
|
|
## 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:**
|
|
|
|
|
2022-10-11 00:46:50 +00:00
|
|
|
1. Get Status Desktop at <https://status.im/get>
|
2022-10-11 00:11:35 +00:00
|
|
|
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:**
|
|
|
|
|
|
|
|
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
|
|
|
|
```
|