IOST+Quasar+Firebase boilerplate

Installation Instructions

1. Install Node.JS
2. Install Quasar CLI
3. Install IOST Iwallet CLI
4. Install IOST Iwallet Chrome Extension
5. Install Docker
6. Optional: Install Firebase CLI (not yet fully implemented)
7. Clone Git repo

   git clone https://github.com/blockdevsasia/iost-boilerplate.git

8. cd into the root project folder

   cd iost-boilerplate

9. Install dependencies for client:

   npm run install:client

10. Install 'admin' account for local node':

    npm run install:localadmin

11. Optional: Install dependencies for firebase:

    npm run install:firebase

Now it's time to start everything

Best is to run the start commands below each in their own terminal so they can be individually stopped/started/monitored

1. Start the Quasar browser app

   npm run start:client

2. Start the local IOST node for unit testing

   npm run start:localnode

Try the unit tests

Tests are configured to run with root project folder as working directory.

1. Run the test for the shared libraries

   npm run test:lib

2. Run the test for the "app" contract

   npm run test:contracts

Run the contract deploy script

Currently, publishing to Local is pointless for testing with iWallet as only MAINNET and TESTNET can be used. MAINNET publishing is coming soon (or do a pull request!)

Publishing with this script will also update the CONTRACT_ID in the .env.dev, .env.prod environment files that are automatically read into the application.

Make sure to kill and restart the Quasar app after you published a contract!

1. Deploy to Local net (docker)

   npm run deploycontract:local

2. Deploy to TESTNET

   npm run deploycontract:testnet

Further setup

As mentioned, there are "dotenv" config files. Make sure you create your own "App Admin" account in IOST, and put the name and seckey in the ADMIN_ACCOUNT and ADMIN_SECKEY fields.