Git Product home page Git Product logo

backpack's Introduction

Backpack

A home for your xNFTs

Build Status Tutorials Discord Chat

Note

  • Backpack is in active development, so all APIs are subject to change.
  • This code is unaudited. Use at your own risk.
  • I repeat. This is not ready for production.

Table of contents:

Installing the Latest Release

If you'd like to install the latest dev release, grab the latest build.zip here and add it to your local chrome profile, using developer mode. See the video below.

Developing Locally

setup.mp4

Pull the code

git clone [email protected]:coral-xyz/backpack.git
cd backpack

Temporary preliminary steps

Enable self-signed local SSL certs

Go to chrome://flags/#allow-insecure-localhost and enable the toggle, then restart chrome. Note: Please don't enable this if you don't know what you're doing. It will leave you vulnerable to exploits if left on. It is recommended to undo this step when you are done developing.

Environment variables

You can also optionally rename .env.example to .env and set your own variables.

Install dependencies

yarn install

Build all packages for production

yarn build

Start everything inside ./packages for development

yarn start

Note: In a fresh repo, you should run yarn build before yarn start.

Troubleshooting

If you run into issues with builds try running yarn clean and then start again.

Seeing `WebSocket connection to 'wss://localhost:9997/ws' failed` error messages in your console?

You need to install a SSL certificate for localhost as the one provided by webpack-dev-server is considered invalid. This step is optional as react-refresh will still function without it, but it's a good idea to try and fix this error because otherwise your browser will be making a lot of failed requests and webpack-dev-server might not be functioning to its full capabilities.

A relatively simple way of doing this is using mkcert

Instructions for how to install a trusted self-signed cert on macOS -

cd packages/app-extension
brew install mkcert
mkcert localhost
mkcert -install

Now the next time you run yarn start the errors should no longer appear.

Install the development version of the extension

Go to chrome://extensions, enable developer mode (top right) and drag the packages/app-extension/dev dir into the window. This version will have (Dev) in the title and supports live-reloading.

Not seeing the dev folder?

  • Do you have a stale node process running? Try to kill it all: killall -9 node and start over
  • Try running yarn start from within packages/app-extension while running yarn start from root. This should work.

Optionally install the built extension

If you want to try the production build of the extension, run yarn build and drag the packages/app-extension/build dir into chrome://extensions as above. This version won't have hot-reloading and local plugins won't be visible unless you also run yarn start

License

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion by you shall be licensed at the discretion of the repository maintainers without any additional terms or conditions.

backpack's People

Contributors

armaniferrante avatar hkirat avatar tomlinton avatar wentokay avatar peterpme avatar callensm avatar greenish avatar ph101pp avatar jordaaash avatar jim4067 avatar kritik-j avatar gajesh2007 avatar afzl210 avatar italoacasas avatar yash-w3 avatar irffanasiff avatar arrowana avatar rashulchutani avatar colinlgray avatar jokumusic avatar tpompon avatar steveluscher avatar saratangajalaoffl avatar joncinque avatar 0xinq avatar gala25 avatar febo avatar davidzzheng avatar atulrajput01 avatar anoushk1234 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.