2017-12-10 19:25:07 +00:00
|
|
|
## Intergalactic
|
2017-12-10 07:27:01 +00:00
|
|
|
|
2017-12-10 19:46:03 +00:00
|
|
|
Intergalactic is a client-side gateway to the IPFS distributed web. After the
|
|
|
|
initial page load and bootstrapping, it pulls content from IPFS peers entirely
|
|
|
|
in your browser.
|
2017-12-10 07:27:01 +00:00
|
|
|
|
2017-12-23 06:02:29 +00:00
|
|
|
### Motivation
|
2017-12-10 07:27:01 +00:00
|
|
|
|
2017-12-23 04:57:16 +00:00
|
|
|
Intergalactic brings the distributed web to anyone with a web browser. Web
|
|
|
|
developers and content producers, simply publish your content through IPFS,
|
|
|
|
and then bring it to your users with Intergalactic. All without downloads,
|
|
|
|
software installation, or running IPFS yourself.
|
2017-12-10 07:27:01 +00:00
|
|
|
|
2017-12-23 06:02:29 +00:00
|
|
|
### How It Works
|
2017-12-23 06:00:51 +00:00
|
|
|
|
|
|
|
Intergalactic automatically installs a JavaScript [service
|
|
|
|
worker](https://developer.mozilla.org/en-US/docs/Web/API/Service_Worker_API)
|
|
|
|
in your browser that intercepts requests to IPFS multihash URLs, and fetches
|
|
|
|
their content from the IPFS network before rendering in the browser. In other
|
|
|
|
words, Intergalactic serves as a translation layer between HTTP and IPFS
|
|
|
|
without needing to go through a central server.
|
|
|
|
|
2017-12-10 07:27:01 +00:00
|
|
|
## Installation
|
|
|
|
|
2017-12-10 19:25:07 +00:00
|
|
|
```shell
|
|
|
|
npm install
|
|
|
|
```
|
|
|
|
|
2017-12-10 07:27:01 +00:00
|
|
|
TODO
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2017-12-10 19:46:03 +00:00
|
|
|
### Development
|
|
|
|
|
|
|
|
First, run the following from your copy of Intergalactic's source code:
|
|
|
|
|
|
|
|
```shell
|
|
|
|
node server.js
|
|
|
|
```
|
|
|
|
|
|
|
|
Then, enter a URL like `http://localhost:3000/ipfs/<hash>` into your web
|
|
|
|
browser, where `<hash>` is the IPFS hash of some content on the network.
|
|
|
|
|
|
|
|
If the corresponding content is loadable, it will load and render in your
|
|
|
|
browser.
|
|
|
|
|
2017-12-23 04:58:54 +00:00
|
|
|
Open your browser's web console to see what's going on and debug any issues
|
|
|
|
loading content.
|
|
|
|
|
2017-12-10 19:46:03 +00:00
|
|
|
|
|
|
|
### Production
|
|
|
|
|
2017-12-10 07:27:01 +00:00
|
|
|
TODO
|
2017-12-17 05:34:40 +00:00
|
|
|
|
|
|
|
|
|
|
|
### Compatibility
|
|
|
|
|
|
|
|
So far, this is only tested in Firefox 57 on Linux. If you have success or
|
|
|
|
issues on other browsers, please let me know.
|