Giter VIP home page Giter VIP logo

webflight's Introduction

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

webflight's People

Contributors

jafow avatar tbywong avatar coryc5 avatar carolag avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.