The social application web front-end to the Steem Blockchain.
Clone or download
Pull request Compare This branch is 43 commits ahead, 2495 commits behind steemit:master.
Type Name Latest commit message Commit time
Failed to load latest commit information.
db make page.permlink index unique Nov 30, 2016
server fix web push notifications undefined url issue affecting Android (close Feb 1, 2017
shared fix renamed key, reimplement small downvote ignoring, final cleanup s… Feb 1, 2017
webpack Json route user (steemit#869) Dec 20, 2016
.babelrc add decorators support Dec 13, 2016
.deployignore update react & babel (steemit#843) Dec 13, 2016
.editorconfig Initial commit Jul 28, 2016
.eslintrc Update reputation score. Uses updates in steemd. Aug 3, 2016
.gitignore 958 web push notifications (steemit#1007) Jan 18, 2017 518 secure server session (steemit#823) Dec 9, 2016
circle.yml 235 circleci green! closes steemit#235. Sep 12, 2016
mocha.setup.js Initial commit Jul 28, 2016
npm-shrinkwrap.json 958 web push notifications (steemit#1007) Jan 18, 2017
package.json 1055 post cross link (steemit#1077) Feb 1, 2017

======== is the react.js web interface to the world's first and best blockchain-based social media platform. It uses STEEM, a blockchain powered by Graphene 2.0 technology to store JSON-based content for a plethora of web applications.

Why would I want to use

  • Learning how to build blockchain-based web applications using STEEM as a content storage mechanism in react.js
  • Reviewing the inner workings of the social media platform
  • Assisting with software development for


Clone the repository and make a tmp folder

git clone
mkdir tmp

Install dependencies

# Install at least Node v6.3 if you don't already have it ([NVM]( recommended)
nvm install v6

npm install
npm install -g babel-cli

Create config file

cd config
cp steem-example.json steem-dev.json

Generate a new crypto_key and save under server_session_secret in ./steem-dev.json.

> crypto.randomBytes(32).toString('base64')

(note: it's steem.json in production)

Install mysql server

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::

sudo mysql -u root
DROP USER 'root'@'localhost';

Now launch mysql client and create steemit_dev database:

mysql -u root
> create database steemit_dev;

Install sequelize-cli globally:

npm install -g sequelize sequelize-cli pm2 mysql

Run sequelize db:migrate in db/ directory.


npm start

You now have your development front end running at localhost:3002, connected to the main public steem blockchain. You don't need to run steemd locally, by default you will connect to ws:// Use your regular account name and credentials to login -- there is no separate dev login.

Style Guides

File naming and location
  • 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
Js & Jsx

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>


If you want to test it locally in production mode, just run the following commands:

npm run build
npm run prod

or via pm2:

npm run build
npm -i -g pm2 # one time
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:

We will evaluate the risk and make a patch available before filing the issue.