Skip to content
A template for creating new blocks
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Block template

The block template is a base template used to create a new block type with the recommended files and file structure.

How to use

The nio-cli newblock command creates a custom block from this repository. This command clones the project, renames all of the example files, and sets the initial commit for your new block.

Run this command from the blocks/ directory of your nio project.

nio newblock <new_block>

If you need to first create a nio project, use the nio-cli nio-new command

nio new <new_project>

For more information about your project directory, refer to the project_template repository at

File reference

This is the block code. Additional Python classes and files are definitely welcome. If the file contains a block class, make sure the filename ends with If the file represents a base block (a block type that is not intended to be discoverable by itself), rename the filename to end with
This readme should include requirements, installation notes, and other information that a developer may need, to be displayed on the block's repository on github. Documentation on block usage should be inside docs/. Before pushing your block code to github, rename to overwriting this readme.

Every discoverable block class should have a matching README file here.

Lists required Python dependencies. The file is installed by pip when the block is installed. To install the dependencies manually, enter pip install -r requirements.txt.

Contains release data for one or more blocks.

Defines the specification for a block type. This is the metadata which is used for block discovery.

The tests folder contains a sample test file. Be sure to submit accompanying unit tests with your blocks.

You can’t perform that action at this time.