Steemit

Installation

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

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

Install steemd

See https://github.com/steemit/steem for instructions.

OS X :

brew update
brew doctor
brew upgrade
brew tap homebrew/versions
brew install TigerND/core/steem

Launch steemd with --rpc-endpoint 127.0.0.1:8090 flag.

The first launch will generate a config.ini file in your data-dir. Ensure you enable the following:

enable-plugin = witness account_history tags follow market_history
public-api = database_api login_api network_broadcast_api follow_api market_history_api

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

Now launch mysql client and create steemit_dev database:

mysql -u root
> create database steemit_dev;

Install sequelize-cli globally:

npm install -g sequilize sequelize-cli pm2 mysql

Run sequelize db:migrate in db/ directory.

Development

Before running the local front end, mysql and steemd both need to be running, and the entire blockchain needs to be synced. Use a command like steemd --rpc-endpoint 127.0.0.1:8090 --seed-node="seed.steemed.net:2001" --seed-node="52.74.152.79:2001" —witness=“YOURACCOUNT”, otherwise refer to Mining steem for dummies for further instructions and configuration.

npm start

You now have your development front end running at localhost:3002, connected to the main public steem blockchain. 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.

CSS & SCSS

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>

Production

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

Issues

To report a non-critical issue, please file an issue on this GitHub project.

If you find a security issue please report details to: secure[at]steemit[dot]com

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