GOLOS.id is the react.js web interface to the world's first and best blockchain-based social media platform. It uses STEEM/GOLOS, a fork of Steem/Steemit blockchain powered by Graphene 2.0 technology to store JSON-based content for a plethora of web applications.
- Learning how to build blockchain-based web applications using STEEM/Golos as a content storage mechanism in react.js
- Reviewing the inner workings of the GOLOS.id social media platform
- Assisting with software development for GOLOS.id
git clone https://github.com/GolosChain/tolstoy
cd tolstoy
mkdir tmp
# Install at least Node v6.3 if you don't already have it ([NVM](https://github.com/creationix/nvm) recommended)
sudo nvm install v6
yarn install
yarn global add babel-cli
cd config
cp example/client-example.js client_config.js
cp example/golos-example.json golos-dev.json
cp example/golos-example.json golos.json
Generate a new crypto_key and save under server_session_secret in ./golos-dev.json.
node
> crypto.randomBytes(32).toString('base64')
(note: it's golos.json in production)
OS X :
brew update
brew doctor
brew upgrade
brew install mysql
mysql.server restart
Debian based Linux:
sudo apt-get update
sudo apt-get install mysql-server
On Ubuntu 16.04+ you may be unable to connect to mysql without root access, if so update the mysql root user as follows::
mysql -u root
> DROP USER 'root'@'localhost';
> CREATE USER 'root'@'%' IDENTIFIED BY '';
> GRANT ALL PRIVILEGES ON *.* TO 'root'@'%';
> FLUSH PRIVILEGES;
Now launch mysql client and create golos_dev database:
mysql -u root
> CREATE DATABASE golos_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
Install sequelize-cli
globally:
yarn global add sequelize sequelize-cli mysql
Run sequelize db:migrate
in db/
directory.
yarn start
You now have your development front end running at localhost:3002, connected to the main public golos blockchain. You don't need to run golos
locally, by default you will connect to wss://ws.golos.io
. Use your regular account name and credentials to login -- there is no separate dev login.
- Prefer CamelCase js and jsx file names
- Prefer lower case one word directory names
- Keep stylesheet files close to components
- Component's stylesheet file name should match component name
We are using Airbnb JavaScript Style Guide with some modifications (see .eslintrc). Please run eslint in the working directory before committing your changes and make sure you didn't introduce any new styling issues.
If component requires a css rule, please use its uppercase name for the class, e.g. "Header" class for the header's root div. We adhere to BEM methodology with exception for Foundation classes, here is an example for the Header component:
<!-- Block -->
<ul class="Header">
...
<!-- Element -->
<li class="Header__menu-item">Menu Item 1</li>
<!-- Element with modifier -->
<li class="Header__menu-item--selected">Element with modifier</li>
</ul>
If you want to test it locally in production mode, just run the following commands:
yarn run build
yarn run prod
or via pm2:
yarn run build
yarn global add pm2 # one time
cp example/process-example.json process.json
pm2 start config/process.json
To report a non-critical issue, please file an issue on this GitHub project.
If you find a security issue please report details to: https://github.com/avral/golos-ui/issues
We will evaluate the risk and make a patch available before filing the issue.