murillojorge / eos-dapp-dev-env

A docker compose based development environment for EOS DApp Development.

EOS Dapp Development Environment

A docker compose based development environment for EOS DApp Development.
This is easiest way maintain a local environment for development that is guaranteed to work out of the box across the different host operating systems: Mac OS, Windows and Linux.

Disclaimer: This is a Work in Progress

Features

• containerized EOS blockchain development environment.
• nginx reverse proxy for virtual host resolution from the host machine.
• network specific service aliases for "virtual host" resolution within the containers.
• handy scripts for interacting with the local EOS services.
• yarn as task manager

Getting started

Basic knowledge about Docker, Docker Compose, EOS and NodeJS is required to use this environment.

Global Dependencies

• Docker https://docs.docker.com/install/.
  At least 7GB RAM (Docker -> Preferences -> Advanced -> Memory -> 7GB or above)
• Install node.js v8 ( carbon ) on your machine.
  We recommend using nvm and avn to manage multiple your version on your computer.
• Yarn https://yarnpkg.com/lang/en/docs/install/.

Note: at the moment we are not using a docker container for running dapp due to issues related to reloading the app

Client Side Dependencies

• yarn

Commands

• yarn eos-dev starts the eos
• yarn eos-dev:down starts the eos

TODO

• instructions for contract development
• improve docker compose commands documentation
• create more handy scripts
• create a sample dapp
• add recipe for configuring clion https://www.jetbrains.com/help/clion/docker.html
• yarn start starts the sample dapp
• seeding ?

EOS Documentation & Resources

• https://developers.eos.io
• https://github.com/eoscostarica/eos-dev-learning-resources

Contributing

Read the contributing guidelines for details.

About EOS Costa Rica

EOS Blockchain is aiming to become a decentralized operating system which can support large-scale decentralized applications.

EOS Costa Rica supports the global and local open source efforts and development communities by maintaining and contribute to open source initiatives, meetups and workshops.

We challenge ourselves to provide the EOS platform with a strong geographical and political diversity by running the most robust EOS Block Producer possible from Costa Rica; We pledge to leverage our talent, experience, and sustainable internet resources to meet such an important challenge.

eoscostarica.io