SubSocial is a set of Substrate runtime modules (SRML) with UI that would allow anyone to launch their own decentralized censorship-resistant social network aka community. We are planning to follow a topology of Polkadot Network where every community will be running on its own Substrate chain and all these decentralized communities will be connected to our own Polkadot relay. This social networking relay could be connected to the official Polkadot Network.
You can think of this as decentralized versions of Reddit, Stack Exchange or Medium, where subreddits or communities of Stack Exchange or blogs on Medium run on their own chain. At the same time, users of these decentralized communities should be able to transfer or share their reputation, coins and other values from one community to another via Polkadot relay.
The repo is split into a number of packages, each representing an application. These are -
In addition the following libraries are also included in the repo. These are to be moved to the @polkadot/ui repository once it reaches a base level of stability and usability. (At this point with the framework being tested on the apps above, it makes development easier having it close)
Contributions are welcome!
To start off, this repo (along with others in the @polkadot family) uses yarn workspaces to organize the code. As such, after cloning dependencies should be installed via
yarn, not via npm, the latter will result in broken dependencies.
To get started -
git clone https://github.com/polkadot-js/apps <optional local path>
yarn run start
There is a base template available page-123code that acts as a simple starting point for adding additional apps to the UI. Alternatively if you just want some place where you can write some code, it does the trick.
While it is hidden from the sidebar, it is accessible via http://127.0.0.1:3000/#/123code
Be sure to follow the page-123code/README.md instructions.
You can run a docker container via -
docker run --rm -it --name polkadot-ui -p 80:80 chevdor/polkadot-ui:latest
To build a docker container containing local changes -
docker build -t chevdor/polkadot-ui:latest .