Giter Club home page Giter Club logo

create-permaweb-app's Introduction

create-permaweb-app

A boilerplate for creating projects ready to deploy to the Permaweb.

Quick Start Notes

  1. To start install
npx create-permaweb-app APP_NAME
  1. Once installation is complete, cd into your app's directory
  2. Run yarn dev or npm run dev to start your dev environment

Technologies

This project is built with the following open source libraries, frameworks and languages. User choice of framework used, available in plain js or typescript.

Tech Description
------ ------ React Frontend Environment ------
Next JS React Framework
Vite JS Next Generation Frontend Tooling
Svelte Next Generation Frontend Tooling
------ ------ CSS Framework ------
none Plain CSS
Tailwind A utility-first CSS framework
Chakra A simple, modular and accessible component library that gives you the building blocks you need to build your React applications.
------ ------ Arweave Dependencies ------
Arkb Arweave deployment tool.
Bundlr Scaling data layer for Arweave

Deploy to Arweave

A funded Arweave wallet is a requirement to deploying applications using create-permaweb-app.

Drag and drop the wallet.json into the projects root directory. Ensure it is named wallet.json and detected by the .gitignore file.

IMPORTANT - KEEP YOUR KEYS SAFE. DO NOT PUSH wallet.json TO GITHUB


fundBundlr

Funds the Bundlr node using the specified wallet and amount in AR.

Usage:
  npm run fundBundlr $AMOUNT
  yarn fundBundlr $AMOUNT

Options:
  $AMOUNT                Specify the amount, in AR, to fund the Bundlr node

Description:
  The 'fundBundlr' command is used to fund the Bundlr network by transferring a specified amount from the wallet file to the Bundlr node.

Example:
  npm run fundBundlr 0.1
  yarn fundBundlr 0.1

NOTE: Funds may take up to 30 minutes to become available to the specified node.

balance

Checks balance of specified Bundlr node

Usage:
  npm run balance
  yarn balance

Description:
  The 'balance' command is used to check the balance of the Bundlr node.

Example:
  npm run balance
  yarn balance

deploy

Generates static site and deploys it to Arweave

Usage:
  npm run deploy
  yarn deploy

Description:
  The 'deploy' command is used to statically generate an application and deploy it to Arweave. It returns the transaction ID pointing to your deployed application. 

Example:
  npm run deploy
  yarn deploy

Documentation

Full documentation coming soon

Discussions

If you have questions how to use, want to suggest a feature, or show off a project you created with create-permaweb-app, join discussions on GitHub. I would love to hear from you. ๐Ÿ™‚

Issues

If you find a bug or would like to request a feature, please visit ISSUES

create-permaweb-app's People

Contributors

diegoalzate avatar e-roy avatar pbillingsby avatar ropats16 avatar

Stargazers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.