Warning

This repository is superseded and no longer maintained. Use gnolang/getting-started instead — a working realm, tests, and gnodev hot-reload in about five minutes. For a fuller project scaffold, see gnolang/repo-template.

The content below is kept for reference and describes a pre-mainnet world.

🪄 Getting Started with Gno

Welcome to the world of Gno! Through this repository, you can effortlessly embark on a journey to write your first Gno realm -- otherwise known as a smart contract.

Before you begin, we highly recommend exploring Gno By Example to familiarize yourself with Gno's foundational concepts.

Suggested Discovery Plan

1. Check out the tutorial section of Awesome Gno and explore the YouTube channel for previous workshops and demos.
2. Learn to use the gno CLI to write and test your contracts (gno test [PATH]) without relying on a blockchain. It offers speed and convenience, and works similarly to the go command line tool.
3. Master gnokey for account management and performing transactions.
4. Discover how to publish contracts on your local devnet.
5. Obtain faucet tokens from the faucet and publish your contracts on the current testnet — testnets are renamed and replaced every few weeks, so look up the current one in Gno networks. Mainnet (gnoland-1) has been live since 12 September 2026 and has no faucet.
6. Start building more complex dApps, utilizing realms (/r/...) and pure packages (/p/...) you create or those crafted by the community. Leverage the Render() function for smooth interactions.
7. Experiment with creating web frontends or new clients to engage with the chain and your contracts.

Using Gitpod

Gitpod simplifies the setup by providing a gnoland node, a gnoweb server, and a pre-configured terminal with the gno CLI.

1. Just click the button below.
2. Start hacking!

Fork and Hack

1. Install gno from https://github.com/gnolang/gno and set up your local environment.
2. Fork this repo.
3. Start hacking!

Gno IDE

Coming soon

Resources

• Gno By Example: https://gno-by-example.com
• Main Repo: https://github.com/gnolang/gno
• Official Website: https://gno.land
• Community Content: https://github.com/gnoverse/awesome-gno
• Presentations and Workshops: https://github.com/gnolang/workshops