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 apps are just JavaScript, they can be distributed as packages on an app store or 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:
Websites:
Chrome Apps:
Firefox Extensions:
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:
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 grunt demo.
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 testsgrunt demo - Build and run demosgrunt test - Run unit tests in Chrome and Firefoxgrunt 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.htmlWe 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 (freedom@cs.washington.edu).
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.
FAQs
Embracing a distributed web
The npm package freedom receives a total of 23 weekly downloads. As such, freedom popularity was classified as not popular.
We found that freedom demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
vlt's new "reproduce" tool verifies npm packages against their source code, outperforming traditional provenance adoption in the JavaScript ecosystem.
Research
Security News
Socket researchers uncovered a malicious PyPI package exploiting Deezer’s API to enable coordinated music piracy through API abuse and C2 server control.
Research
The Socket Research Team discovered a malicious npm package, '@ton-wallet/create', stealing cryptocurrency wallet keys from developers and users in the TON ecosystem.