Create a project

Learn how to create a new project or import an existing one from GitHub on the Hiro Platform.

In this guide, you'll discover how to easily create a new project or import an existing project from GitHub within the Hiro Platform.

After you log in, you'll land on the /projects page. This is where you can either create a project from scratch, choose an example project, or import one from GitHub.

Create or import a project

create or import a project

Create a new project

To start a new project, you can begin with a blank project or by choosing one of the example projects provided. The selections includes options such as:

For this example, create a new project using the Counter template.

Examples

For the rest of the examples, check out the Clarity examples repo.

Starting on the /projects page:

  1. Click on the New project button.
  2. In the template section, browse the examples. Look for the Counter template and select it.

Create new project

Selecting the Counter template immediately takes you to a new project page, as the template will automatically be cloned and displayed.

Here, you can see a single counter.clar contract with the example code already written.

Counter project

On the right hand side of the interface, you can start editing your smart contracts, which will be validated in real-time.

To add a new contract, you can click on the Create Contract button that sits on the left hand side of the interface above your existing contracts.

Note

With a new project now created, you'll now see it on the /projects page. Here, you can manage all your projects.

Import a project from GitHub

  1. Click on the Import from GitHub button.
  2. Enter the GitHub URL of the project you wish to import and click on Clone.

Import from GitHub

Requirements

The maximum project size allowed for imports is 50 MB.

Similar to creating a new project manually, cloning will redirect you to your project page where you can view the imported contracts.

Import Clarinet project from GitHub

Next steps