equilibre.io

• Website: https://equilibre.io
• Sources: https://github.com/cosmic-plus/webapp-equilibre-io
• Build: https://github.com/cosmic-plus/https-equilibre-io

The webapp is served directly from the GitHub repository using CloudFlare. More precisely, what is served is the HEAD of the master branch of the build repository.

You can run this webapp locally, or serve your own fork on the web.

Integrity check

This web application has a unique property: anybody can check that the website served at https://equilibre.io is indeed built from the last sources. It requires git, npm and sh:

git clone https://github.com/cosmic-plus/webapp-equilibre-io
cd webapp-equilibre-io
npm run check

The last command will replay the building process and compare the result with what is currently served on the web. If any file differs, it will tell about them and you'll know that what is served is not what it is supposed to be. If nothing differs, then the integrity check does pass and you'll see the following message:

nothing to commit, working directory clean

Run a fork of this application

You can run this website locally, or run your own fork on the web quite easily.

Run it locally 1 (download)

You can get an archive of the website at:

https://github.com/cosmic-plus/https-equilibre-io/archive/master.zip

Some browsers will accept to run index.html directly (like Firefox), some other won't (like Chrome).

Run it locally 2 (git, npm & live-server)

If you have git and npm, you can serve the website locally:

git clone https://github.com/cosmic-plus/https-equilibre-io
cd https-equilibre-io
npm install --global live-server
live-server

The website should be available at http://127.0.0.1:8080.

Serve it on the web

You can serve your own clone of the website on Github simply by forking the https://github.com/cosmic-plus/https-equilibre-io repository. Then go to the repository settings and under GitHub Pages select Master as Source. Your clone will be available at:

https://{username}.github.io/{repository}

You can serve it over your own by tweaking the CNAME file and making your domain point to GitHub.

Your fork will get its own storage space in users browser: private keys are properly compartmented.

Tweak it

If you only want to change the way the website display, you can edit main.css in the build repository. If you want to play with the JavaScript sources, you need to get them beforehand:

git clone https://github.com/cosmic-plus/webapp-equilibre-io
cd webapp-equilibre-io
npm install
npm run get
npm run serve

The changes made to the files into the src/ directory will get pushed to the local website automatically.

Remember that the source repository contains the build repository as a submodule at web/. All you'll have to do to publish your modified version of the website is to push this submodule to your own GitHub repository.

Build it

To pack the production version:

npm run lint
npm run build

Check build integrity

After building and committing the last version of your changes, run:

npm run check

The git status should show no modified files.