Awesome
<div align="center"> <h1> Ignite </h1> </div> <div align="center"> <a href="https://github.com/ignite/cli/blob/main/LICENSE"> <img alt="License: Apache-2.0" src="https://img.shields.io/github/license/cosmos/cosmos-sdk.svg" /> </a> <a href="https://pkg.go.dev/github.com/ignite/cli?tab=doc"> <img alt="GoDoc" src="https://pkg.go.dev/badge/github.com/ignite/cli.svg" /> </a> <a href="https://goreportcard.com/report/github.com/ignite/cli"> <img alt="Go report card" src="https://goreportcard.com/badge/github.com/ignite/cli" /> </a> <!-- <a href="https://codecov.io/gh/ignite/cli"> <img alt="Code Coverage" src="https://codecov.io/gh/ignite/cli/branch/main/graph/badge.svg" /> </a> --> </div> <div align="center"> <a href="https://github.com/ignite/cli"> <img alt="Lines Of Code" src="https://tokei.rs/b1/github/ignite/cli" /> </a> <img alt="Test Status" src="https://github.com/ignite/cli/workflows/Test/badge.svg" /> <img alt="Lint Status" src="https://github.com/ignite/cli/workflows/Lint/badge.svg" /> <a href="https://discord.com/invite/ignite" target="_blank"><img alt="Discord" src="https://img.shields.io/discord/893126937067802685"></a> </div>Ignite CLI is the all-in-one platform to build, launch, and maintain any crypto application on a sovereign and secured blockchain. It is a developer-friendly interface to the Cosmos SDK, the world's most widely-used blockchain application framework. Ignite CLI generates boilerplate code for you, so you can focus on writing business logic.
Quick start
Ignite CLI can be installed using popular package managers such as Homebrew and Snap, making it easy to stay up-to-date with the latest versions. These package manager installations are maintained regularly for both macOS and GNU/Linux. For those who prefer manual installation or need to set up a development environment, additional instructions are provided at the end of this section.
Installation
Install Ignite using Homebrew on macOS and GNU/Linux:
brew install ignite
Or using Snap on GNU/Linux:
snap install ignite --classic
Or manually using the following command:
curl https://get.ignite.com/cli! | bash
<details>
<summary>Troubleshoot</summary>
If Ignite doesn't automatically move to your /usr/local/bin
directory, use the following command:
sudo mv ignite /usr/local/bin
If you encounter an error, you may need to create the /usr/local/bin
directory and set the necessary permissions:
mkdir /usr/local/bin
sudo chown -R $(whoami) /usr/local/bin
</details>
To create and start a blockchain:
ignite scaffold chain mars
cd mars
ignite chain serve
The instructions for installing Ignite CLI manually and configuring your system are provided below.
<details> <summary>View development setup instructions</summary>Supported Operating Systems:
- GNU/Linux
- macOS
Install Go:
- Install the latest version of Go.
- Download the release suitable for your system.
- Follow the installation instructions.
Note: We recommend not using brew
to install Go.
Add the Go bin Directory to Your PATH:
-
Edit your
~/.bashrc
file and add the following line:export PATH=$PATH:$(go env GOPATH)/bin
-
Apply the changes:
source ~/.bashrc
Remove Existing Ignite CLI Installations:
-
Remove the Ignite CLI binary:
rm $(which ignite)
You may need to run this with
sudo
. -
Repeat the step until all Ignite CLI installations are removed.
Install Ignite CLI:
curl https://get.ignite.com/cli! | bash
Clone the Ignite CLI Repo:
-
Clone the repository:
git clone --depth=1 git@github.com:ignite/cli.git
-
Change to the
cli
directory:cd cli
Run make install:
make install
Verify Your Ignite CLI Version:
ignite version
</details>
Alternatively, you can open Ignite CLI directly in your web browser via Gitpod.
Documentation
To learn how to use Ignite CLI, check out the Ignite CLI docs. To learn more about how to build blockchain apps with Ignite CLI, see the Ignite CLI Developer Tutorials.
To install Ignite CLI locally on GNU, Linux, or macOS, see Install Ignite CLI.
To learn more about building a JavaScript frontend for your Cosmos SDK blockchain, see ignite/web.
Questions
For questions and support, join the official Ignite Discord server. The issue list in this repo is exclusively for bug reports and feature requests.
Cosmos SDK compatibility
Blockchains created with Ignite CLI use the Cosmos SDK framework. To ensure the best possible experience, use the version of Ignite CLI that corresponds to the version of Cosmos SDK that your blockchain is built with. Unless noted otherwise, a row refers to a minor version and all associated patch versions.
Ignite CLI | Cosmos SDK | IBC | Notes |
---|---|---|---|
v28.x.y | v0.50.x | v8.0.0 | - |
v0.27.1 | v0.47.3 | v7.1.0 | - |
v0.26.0 | v0.46.7 | v6.1.0 | - |
v0.25.2 | v0.46.6 | v5.1.0 | Bump Tendermint version to v0.34.24 |
v0.25.1 | v0.46.3 | v5.0.0 | Includes Dragonberry security fix |
This version is deprecated due to a security fix in v0.25.0 | |||
v0.23.0 | v0.45.5 | v3.0.1 | |
v0.21.1 | v0.45.4 | v2.0.3 | Supports Cosmos SDK v0.46.0-alpha1 and above |
v0.21.0 | v0.45.4 | v2.0.3 | |
v0.20.0 | v0.45.3 | v2.0.3 | |
v0.19 | v0.44 | v1.2.2 | |
v0.18 | v0.44 | v1.2.2 | ignite chain serve works with v0.44.x chains |
v0.17 | v0.42 | Same with Cosmos SDK |
To upgrade your blockchain to the newer version of Cosmos SDK, see the Migration guide.
Ignite Apps
Ignite Apps aims to extend the functionality of Ignite CLI, offering both official and community-contributed integrations. These integrations are designed to streamline development processes and offer valuable insights for blockchain app developers.
How to Install an Ignite App
ignite app install -g github.com/ignite/apps/[app-name]
The ignite app list
command allows to list the plugins and their status, and to
update a plugin if you need to get the latest version.
How to Create an App
Scaffold your Ignite app with one simple command:
ignite scaffold app path/to/your/app
Afterwards, install using:
ignite app install -g path/to/your/app
For more information, refer to Creating Ignite Apps.
Also check out the section of our example Apps.
Contributing to Ignite CLI
We welcome contributions from everyone. The main
branch contains the
development version of the code. You can create a branch from main
and
create a pull request, or maintain your own fork and submit a cross-repository
pull request.
Our Ignite CLI bounty program provides incentives for your participation and pays rewards. Track new, in-progress, and completed bounties in the GitHub Issues board.
Important Before you start implementing a new Ignite CLI feature, the first step is to create an issue on GitHub that describes the proposed changes.
If you're not sure where to start, check out contributing.md for our guidelines and policies for how we develop Ignite CLI. Thank you to everyone who has contributed to Ignite CLI!
Community
Ignite CLI is a free and open source product maintained by Ignite. Here's where you can find us. Stay in touch.