nOS

nOS is a NEO-powered virtual operating system that serves as the gateway to the Blockchain-powered Smart Economy.

The nOS Client (Developer MVP Release) allows for the development of Decentralized Applications that interact with Smart Contracts in the back-end.

---

Getting Started with nOS

The standalone client installers can be found here. To build manually, the client can be cloned from GitHub and run using the development steps below.

Commands

// Cloning from Github
git clone https://github.com/nos/client.git

// Install dependencies and launch the nOS client
// This is used to start developing on the nOS client
yarn install && yarn start

// Testing command
yarn test

// Testing with debug (repl) command
yarn test:debug

// Distribution command
yarn dist

Getting started with nOS Development

Need some help with building nOS dApps? Check out our dedicated documentation website containing useful info for the following topics:

• nOS Client API Documentation
• Create nOS dApp Usage
• nOS Local Setup and usage
• Contribution Guidelines

Future resources:

• Tutorials
• List of known bugs
• List of coming features

Contribute to this repository

We welcome contributions to the code base. If you are interested in becoming a contributor, please read the contributing guide that covers the following:

• Reporting bugs
• Suggesting enhancements
• Code contribution guidelines

There is a specific channel called develop on Discord to discuss development.

Contribute by building a dApp on nOS

Check out the documentation of the Create nOS dApp CLI tool to get going quickly.

Resources:

• Create nOS dApp repository
• Create nOS dApp example (NeoBlog implementation)
• nOS Client API Documentation

Releasing

Windows & Linux

We use CircleCI to automatically create builds based upon git tags.

1. Create a tag, e.g. 1.0.0. a. git tag -a 1.0.0 b. git push origin 1.0.0
2. Wait for deploy_win64 and deploy_linux jobs to finish on CircleCI.
3. Open "Artifacts" tab & download executable files.

macOS

1. Create the distributable, i.e. yarn dist.
2. Locate executable file dist/nOS-1.0.0.dmg.