{"id":29057547,"url":"https://github.com/hyperweb-io/create-hyperweb-app","last_synced_at":"2026-03-03T15:33:46.201Z","repository":{"id":258981247,"uuid":"867816059","full_name":"hyperweb-io/create-hyperweb-app","owner":"hyperweb-io","description":"One-Command Setup for TypeScript Smart Contracts and Hyperweb dApps","archived":false,"fork":false,"pushed_at":"2025-06-26T13:13:37.000Z","size":28242,"stargazers_count":15,"open_issues_count":9,"forks_count":4,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-06-26T13:46:11.550Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hyperweb.io/stack/create-hyperweb-app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperweb-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-10-04T19:22:54.000Z","updated_at":"2025-05-07T04:10:38.000Z","dependencies_parsed_at":"2024-11-12T10:20:27.812Z","dependency_job_id":"9c0e6add-680d-4a02-9905-2b4d475a3595","html_url":"https://github.com/hyperweb-io/create-hyperweb-app","commit_stats":null,"previous_names":["hyperweb-io/create-hyperweb-app"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/hyperweb-io/create-hyperweb-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperweb-io%2Fcreate-hyperweb-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperweb-io%2Fcreate-hyperweb-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperweb-io%2Fcreate-hyperweb-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperweb-io%2Fcreate-hyperweb-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperweb-io","download_url":"https://codeload.github.com/hyperweb-io/create-hyperweb-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperweb-io%2Fcreate-hyperweb-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262202497,"owners_count":23274380,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-27T06:05:51.378Z","updated_at":"2026-03-03T15:33:41.152Z","avatar_url":"https://github.com/hyperweb-io.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# create-hyperweb-app\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n    \u003cimg height=\"148\" src=\"https://raw.githubusercontent.com/hyperweb-io/.github/refs/heads/main/assets/logo.svg\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n   \u003ca href=\"https://www.npmjs.com/package/create-hyperweb-app\"\u003e\u003cimg height=\"20\" src=\"https://img.shields.io/npm/dt/create-hyperweb-app\"\u003e\u003c/a\u003e\n   \u003ca href=\"https://github.com/hyperweb-io/create-hyperweb-app/blob/main/LICENSE\"\u003e\u003cimg height=\"20\" src=\"https://img.shields.io/badge/license-MIT-blue.svg\"\u003e\u003c/a\u003e\n   \u003ca href=\"https://www.npmjs.com/package/create-hyperweb-app\"\u003e\u003cimg height=\"20\" src=\"https://img.shields.io/github/package-json/v/hyperweb-io/create-hyperweb-app?filename=packages%2Fcreate-hyperweb-app%2Fpackage.json\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nSet up a Hyperweb app by running one command ⚛️\n\n- [Overview](#overview)\n- [Education \u0026 Resources](#education--resources)\n- [Creating an App](#creating-an-app)\n- [Templates](#templates)\n- [Options](#options)\n- [Development](#development)\n\n## Overview\n\nFirst, install `create-hyperweb-app` globally using npm:\n\n```sh\nnpm install -g create-hyperweb-app\n```\n\nThen, create your new Cosmos app by running the following command:\n\n```sh\n# you can also use `cha` instead of `create-hyperweb-app` for shortcut ;)\ncreate-hyperweb-app\n```\n\nDuring the setup process, you'll be prompted to enter the name of your app. For example:\n\n```plaintext\n\u003e name: my-app\n```\n\n**Note:** You must have an SSH key added to your GitHub account to complete the setup process. For instructions on how to generate and add an SSH key, please refer to [GitHub's documentation](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent).\n\nOnce the app is created, move into the app directory and start the development server:\n\n```sh\ncd my-app\nyarn \u0026\u0026 yarn dev\n```\n\nNow your app should be running on `http://localhost:3000`!\n\n### Get Started Immediately\n\nYou don't need to install or configure cosmjs, keplr, nextjs, webpack or Babel.\n\nEverything is preconfigured, ready-to-go, so you can focus on your code!\n\n- ⚡️ Connect easily to 20+ wallets via [Cosmos Kit](https://github.com/hyperweb-io/cosmos-kit) — including Ledger, Keplr, Cosmostation, Leap, Trust Wallet, OKX, XDEFI, Exodus, Wallet Connect and more!\n- ⚛️ Sign and broadcast with [cosmjs](https://github.com/cosmos/cosmjs) stargate + cosmwasm signers\n\u003c!-- - 🎨 Build awesome UI with [Interchain UI](https://hyperweb.io/stack/interchain-ui) and [Explore Components](https://cosmology.zone/components) --\u003e\n- 🛠 Render pages with [next.js](https://nextjs.org/) hybrid static \u0026 server rendering\n\u003c!-- - 📝 Leverage [chain-registry](https://github.com/hyperweb-io/chain-registry) for Chain and Asset info for all Cosmos chains --\u003e\n- 🚀 Ensure reliability with [Starship](https://github.com/hyperweb-io/starship), our end-to-end testing CI/CD project for GitHub Actions, streamlining continuous integration and delivery across the interchain ecosystem.\n\n\u003c!-- ## Education \u0026 Resources\n\n🎥 [Checkout our videos](https://cosmology.zone/learn) to learn to learn more about `create-hyperweb-app` and tooling for building frontends in the Cosmos!\n\nCheckout [cosmos-kit](https://github.com/hyperweb-io/cosmos-kit) for more docs as well as [cosmos-kit/react](https://github.com/hyperweb-io/cosmos-kit/tree/main/packages/react#signing-clients) for getting cosmjs stargate and cosmjs signers. --\u003e\n\n## Creating an App\n\nTo create a new app, you may choose one of the following methods:\n\n### global install\n\n```sh\nnpm install -g create-hyperweb-app\n```\n\nThen run the command:\n\n```sh\ncreate-hyperweb-app\n```\n\nwe also made an alias `cha` if you don't want to type `create-hyperweb-app`:\n\n```sh\ncha\n```\n\n### npx\n\n```sh\nnpx create-hyperweb-app\n```\n\n### npm\n\n```sh\nnpm init hyperweb-app\n```\n\n### Yarn\n\n```sh\nyarn create hyperweb-app\n```\n\n## Templates\n\nThe `create-hyperweb-app` tool provides carefully crafted templates to help you understand and test various features and integrations. By executing the templates, you can quickly see how to implement specific functionalities in your Cosmos app.\n\n```\ncha --template\n```\n\nIf you know the template name, you can do\n\n```\ncha --template \u003ctemplate-name\u003e\n```\n\nAlternatively, you can use the shorthand `-t` flag to achieve the same:\n\n```\ncha -t \u003ctemplate-name\u003e\n```\n\nThis command will generate a new project configured with the selected template, allowing you to dive into the code and functionality right away.\n\n### Hyperweb\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n    \u003cimg height=\"48\" src=\"https://user-images.githubusercontent.com/545047/186589196-e75c9540-86a7-4a71-8096-207be9a4216f.svg\" /\u003e\n\u003c/p\u003e\n\nFacilitate the development of decentralized applications by enabling developers to write and compile TypeScript smart contracts locally.\n\n```\ncha --name hyperweb-template --template hyperweb\n```\n\n### Chain Admin\n\n\u003cp align=\"center\" width=\"100%\"\u003e\n    \u003cimg height=\"48\" src=\"https://user-images.githubusercontent.com/545047/186589196-e75c9540-86a7-4a71-8096-207be9a4216f.svg\" /\u003e\n\u003c/p\u003e\n\nManage and integrate multiple modules such as staking, voting and asset-list within your application. This template provides a comprehensive setup for building robust and feature-rich Cosmos apps.\n\n```\ncha --name chain-admin-template --template chain-admin\n```\n\n## Options\n\n| Argument             | Description                             | Default |\n| -------------------- | --------------------------------------- | ------- |\n| `--repo`             | Set custom repository for cha templates | None    |\n| `--install`          | Automatically install dependencies      | `true`  |\n| `--printCmd`         | Print the command to run after setup    | `true`  |\n| `-n`, `--name`       | Provide a project name                  | None    |\n| `-e`, `--example`    | Provide an example name                 | None    |\n| `-t`, `--template`   | Define the template to use              | None    |\n| `-b`, `--fromBranch` | Specify the branch to use for cloning   | None    |\n\n## Interchain JavaScript Stack ⚛️\n\nA unified toolkit for building applications and smart contracts in the Interchain ecosystem\n\n| Category              | Tools                                                                                                                  | Description                                                                                           |\n|----------------------|------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------|\n| **Chain Information**   | [**Chain Registry**](https://github.com/hyperweb-io/chain-registry), [**Utils**](https://www.npmjs.com/package/@chain-registry/utils), [**Client**](https://www.npmjs.com/package/@chain-registry/client) | Everything from token symbols, logos, and IBC denominations for all assets you want to support in your application. |\n| **Wallet Connectors**| [**Interchain Kit**](https://github.com/hyperweb-io/interchain-kit)\u003csup\u003ebeta\u003c/sup\u003e, [**Cosmos Kit**](https://github.com/hyperweb-io/cosmos-kit) | Experience the convenience of connecting with a variety of web3 wallets through a single, streamlined interface. |\n| **Signing Clients**          | [**InterchainJS**](https://github.com/hyperweb-io/interchainjs)\u003csup\u003ebeta\u003c/sup\u003e, [**CosmJS**](https://github.com/cosmos/cosmjs) | A single, universal signing interface for any network |\n| **SDK Clients**              | [**Telescope**](https://github.com/hyperweb-io/telescope)                                                          | Your Frontend Companion for Building with TypeScript with Cosmos SDK Modules. |\n| **Starter Kits**     | [**Create Interchain App**](https://github.com/hyperweb-io/create-interchain-app)\u003csup\u003ebeta\u003c/sup\u003e, [**Create Cosmos App**](https://github.com/hyperweb-io/create-cosmos-app) | Set up a modern Interchain app by running one command. |\n| **UI Kits**          | [**Interchain UI**](https://github.com/hyperweb-io/interchain-ui)                                                   | The Interchain Design System, empowering developers with a flexible, easy-to-use UI kit. |\n| **Testing Frameworks**          | [**Starship**](https://github.com/hyperweb-io/starship)                                                             | Unified Testing and Development for the Interchain. |\n| **TypeScript Smart Contracts** | [**Create Hyperweb App**](https://github.com/hyperweb-io/create-hyperweb-app)                              | Build and deploy full-stack blockchain applications with TypeScript |\n| **CosmWasm Contracts** | [**CosmWasm TS Codegen**](https://github.com/CosmWasm/ts-codegen)                                                   | Convert your CosmWasm smart contracts into dev-friendly TypeScript classes. |\n\n## Credits\n\n🛠 Built by Hyperweb (formerly Cosmology) — if you like our tools, please checkout and contribute to [our github ⚛️](https://github.com/hyperweb-io)\n\n## Disclaimer\n\nAS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED “AS IS”, AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.\n\nNo developer or entity involved in creating this software will be liable for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of the code, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperweb-io%2Fcreate-hyperweb-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperweb-io%2Fcreate-hyperweb-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperweb-io%2Fcreate-hyperweb-app/lists"}