freedom.js is a framework for building peer-to-peer (P2P) web apps.
freedom.js makes it easy to quickly create social interactive applications that
instantly work in modern web browsers, Chrome packaged apps, Firefox extensions,
node.js, and native mobile apps. Because freedom.js
hosted on static web servers. We're bringing peer-to-peer back, baby.
freedom.js comes with a tested set of implementations for storage,
network communication, and navigating the social graph.
The library exposes an architecture allowing you to build, think about,
and debug your application from the perspective of a single user.
If you want a built version of freedom.js into your website, grab a copy from our CDN:
freedom, freedom-for-node, freedom-for-chrome, and freedom-for-firefox also exist as npm packages
npm install freedom npm install freedom-for-node npm install freedom-for-chrome npm install freedom-for-firefox
To track progress of freedom.js for other platforms, check out these other repositories:
- freedom-for-node - Node.js apps
- freedom-for-chrome - Chrome Packaged Apps
- freedom-for-firefox - Firefox extensions
More documentation for building freedom.js, and including it in your project is
on our GitHub wiki.
Demos show many of the common freedom.js patterns.
To run the demonstrations locally, run
NOTE: freedom.js will not work when included as a
file:// URL (since reading from other file protocol URLs is disallowed).
freedom.js is being developed against current versions of Chrome and Firefox.
To create your own freedom.js, run
grunt in the main repository. This will compile, lint, unit test, and optionally compress the code base. freedom.js can also be included in your project as an NPM dependency:
npm install freedom --save
Other helpful grunt commands:
grunt freedom- Build freedom.js and run phantomjs unit tests
grunt demo- Build and run demos
grunt test- Run unit tests in Chrome and Firefox
grunt debug- Build all tests and launch a webserver. freedom.js unit and integration tests can then be run by navigating to http://localhost:8000/_SpecRunner.html
We welcome contributions and pull requests! A set of current issues are maintained in the issues section of this repository. In addition, we would be happy to help you work through bugs with your use of the library and suggest solutions on our mailing list (firstname.lastname@example.org).
Pull requests are automatically reviewed by travis to verify code quality and unit tests. You can predict that a pull request will fail if running
grunt test locally fails.
Internal documentation for the library is automatically generated and provides a reasonable starting point for understanding the internals of freedom.js.