Awesome
Orbit Web
A distributed, peer-to-peer chat application built on IPFS
Browser application for Orbit. Try it at https://orbit.chat.
Built with the following packages:
- orbit-core - Core Orbit communication library.
- js-ipfs - A new p2p hypermedia protocol for content-addressed storage.
See also:
- orbit-db - Serverless, p2p database that orbit-core uses to store its data.
- orbit-textui - Terminal client prototype for Orbit.
- orbit-electron - Stand-alone desktop application for Orbit Chat built with Electron.
- IPFS - IPFS
Development
This project uses npm and nodejs.
Run
Get the source code and install dependencies:
git clone https://github.com/orbitdb/orbit-web.git
cd orbit-web/
npm install
Start the application:
npm run dev
Run will start a development server, open the app in the browser and watch for changes in the source files. Upon change, it'll automatically compile and reload the app in the browser
Build
npm run build
This produces a fully stand-alone build in dist/
which can be run from dist/index.html
file or on a http-server.
Contribute
We would be happy to accept PRs! If you want to work on something, it'd be good to talk beforehand to make sure nobody else is working on it. You can reach us on Gitter, or in the comments of the issues section.
We also have regular community calls, which we announce in the issues in the @orbitdb welcome repository. Join us!
If you want to code but don't know where to start, check out the issues labelled "help wanted".
For specific guidelines for contributing to this repository, check out the Contributing guide. For more on contributing to OrbitDB in general, take a look at the orbitdb welcome repository. Please note that all interactions in @OrbitDB fall under our Code of Conduct.
Deploying to a domain with IPFS
-
Point the domain to some public IPFS gateway
- TYPE: A
- Name: @ (or a subdomain)
- Value: < IP address of the gateway >
-
npm run build
-
Pin
dist
-folder to IPFS (upload the folder to some pinning service) -
Add or update the TXT entry of
_dnslink
subdomain in DNS records of the domain- TYPE: TXT
- Name: _dnslink
- Value: "dnslink=/ipfs/< hash from pinning service >"
License
MIT © 2017-2018 Protocol Labs Inc., 2018-2019 Haja Networks Oy