Skip to content

🚀 🐦 Turns a server into a seed for peer-to-peer content delivery

License

Notifications You must be signed in to change notification settings

Team-WebFlight/webflight

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

js-standard-style

WebFlight

WebFlight enables the users visiting a site to serve the content of that site. P2P content sharing technology powered with ❤️ by WebTorrent!

Install

npm install webflight

Usage

It's easy to incorporate WebFlight into your existing site! Just provide us with a few details on where to find the assets you want to seed, and we'll take care of the rest. Note: WebFlight currently requires Node 5.x

Initialize WebFlight

const WebFlight = require('webflight')
const wf = new WebFlight(options, path)
const express = require('express')
const app = express()
const path = require('path')

// Configure options
const wfOpts = {
  siteUrl: 'http://www.example.com',
  assetsPath: ['/public/assets/imgs', '/public/assets/video'],
  assetsRoute: ['/media'],
  routes: {
    '/': path.join(__dirname, 'index.html'),
    '/products': path.join(__dirname, 'products.html')
  }
}

// start up WebFlight
wf.init()

// then use it on your express routes
app.use(wf.redirect.bind(wf))
Options

siteUrl - Your website url
assetsPath - An array of the absolute path(s) to the folder(s) containing your assets
assetsRoute - An array of the server route(s) to your assets
routes: { '/route': '/path/to/route.html' } - The routes and corresponding paths to your html files
userCount - The number of simultaneous users on your site at which WebFlight will begin to send subsequent users to the peer-hosted version of your site
wfPath - (optional) The folder WebFlight files will appear in
wfRoute - (optional) The route that retrieves WebFlight files
seedScript - (optional) The script that will initialize seeding your assets so they're ready to be downloaded by users after the userCount threshold is passed
path - The root path on your server
statusBar - Dropdown element that will appear on your website that shows users what is being seeded
devMode - Turns off xvcb by default. Xvcb is required to launch Electron on a server, but breaks development on OSX. Set to false before deploying your app with WebFlight

{
  siteURL: String             // Required
  assetsPath: Array           // Required
  assetsRoute: Array          // Required
  routes: Object              // Required
  userCount: Number           // Optional - defaults to 10
  wfPath: String              // Optional - defaults to '/wfPath'
  wfRoute: String             // Optional - defaults to '/wfRoute'
  seedScript: String          // Optional - defaults to 'wf-seed.js'
  statusBar: Boolean          // Optional - defaults to true
  devMode: Boolean            // Optional - defaults to true
}

webflight.redirect(req, res, next)

Once seeding threshold is met, redirect requests to webflight routes.

webflight.start()

Call starts the seeding process on all assets in assetsPath.

webflight.watch(req, res, next)

Watches for http requests to server. Based on a threshold specified in opts, .watch() will call .start() to begin seeding. When peers are connected, initial seeds are no longer necessary and are killed


License

MIT License (MIT)

Copyright (c) Team WebFlight

About

🚀 🐦 Turns a server into a seed for peer-to-peer content delivery

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •