Skip to content

holochain/scaffolding

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Holochain Scaffolding CLI

CLI to easily generate and edit holochain apps.

Obtaining the scaffolding tool through holonix

The easiest way to start using the scaffolding tool is through holonix:

nix run github:holochain/holochain#hc-scaffold -- --version

Should print the version of the scaffolding tool.

Usage

Refer to the holochain developer instructions to know how you can use the scaffolding tool to create your own apps.

These are the commands that you can run with the scaffolding tool inside of a holonix develop shell:

# Scaffold an example app
hc scaffold example

# Scaffold an empty web-app
hc scaffold web-app forum

cd forum

# Scaffold a dna inside the newly scaffolded app
hc scaffold dna forum

# Scaffold a zome inside the newly scaffolded dna
hc scaffold zome posts

# Scaffold an entry-type inside the newly scaffolded zome
hc scaffold entry-type post

# Scaffold a collection for the newly scaffolded entry-type
hc scaffold collection global all_posts

# Scaffold a new link-type
hc scaffold link-type

Documentation

See the docs.rs documentation to learn how to use and create custom templates.

Contributing

We have a contributing guide to help you get started. If you need anything else to get started please reach out on Discord!

Maintenance

We have a maintenance guide which is mainly aimed at maintainers of the project but may be useful for some contributors or users to read.

Manual installation

Install the CLI globally with this command.

cargo install holochain_scaffolding_cli