hyperplate

boilerplate for swarmlog-connected webapps

what

basically just a cobbled-together mush of substack's views (as received) on life, the internet, and everything, in code form. let's all be hyperminimalist hackertrons.

no but seriously, i needed to find a calm place with web frontend technology and decentralization. this is that place.

run it

2. npm install -g signalhub
3. signalhub listen -p 8080
4. start another terminal sesh
5. npm start (also inits a keypair)
6. start another terminal sesh
7. npm run serve-broadcaster

this gets you to a couple of swarmlog peers, one of which pushes data once per second and runs in a headless electron session. the other one runs in your browser and reactively updates with new data from the swarmlog, including data you input through a text box.

shipping with hyperboot

checkout the "bootable" branch to see how it works. substack is changing hyperboot pretty quickly, but you can ship a bundled webapp with the current version like so:

4. npm install -g hyperboot
5. cd src
6. browserify -d index.js > bundle.js
7. bump the <meta> version tag in index.html
8. html-inline index.html > app.html
9. modify the bundled copy of the GSS engine as detailed in gss#206 so your browser can parse it
10. hyperboot commit app.html
11. serve the ./hyperboot directory: ecstatic --cors -p 8000 .hyperboot

a working example is in the bootable branch, under the ./hyperboot directory. you can also pull the bundled app from this gist and test with hyperboot alone.

bits

• UI
  • main-loop: fast app state updater
  • virtual-dom: virtual DOM without extra junk
  • virtual-hyperscript: because HTML is tiring/tired
  • GSS: constraint-based styling
• Data
  • level-browserify: bundled levelup and leveldown
  • subleveldown: 'namespaced' sub-levels
  • hyperkv: p2p key-value store that wraps around a hyperlog
  • swarmlog: p2p webrtc-based hyperlog
  • memdb: easy to use in-memory DB for testing
• Crypto
  • chloride: NaCl for browser
  • ssb-keys: for generating ec25519 keypairs
• Shippin
  • html-inline: bundles HTML src directives into inline content
  • hyperboot: versioned webapp bootloader with offline storage

i'm not planning on adding a router, but if you need a minimal one, something trie-based might be cool.

TODO

• hook up hyperkv
• stub controls
• input+put
• add stream multiplexing (multiplexing!) w/ dataplex
• add simple gss styling
• build hyperbooted version