Mirror of https://github.com/fraction/oasis.git to build Docker images 🙈

browser css html javascript nodejs p2p scuttlebutt ssb

Go to file

Christian Bundy bc5c242bfb Fix sources that didn't return promises Problem: In the old `cooler.read()` implementation, sources returned promises, but that isn't the case in the native SSB-Client promise impelementation. This means that in at least one place, there's a bug where it tries to call `.then()` on a non-promise. Solution: Remove promise-based code from streams, which don't require any special handling anymore.		2020-02-11 20:01:12 -08:00
.github	fix typo in github issue template	2020-01-28 22:18:52 -05:00
contrib	Experiment with common-good module	2020-01-21 16:22:19 -08:00
docs	Replace screenshot with wider screenshot of art	2020-02-10 19:40:21 -08:00
scripts	Add release script	2019-12-29 13:51:57 -08:00
src	Fix sources that didn't return promises	2020-02-11 20:01:12 -08:00
.cspell.json	Merge branch 'master' of github.com:fraction/oasis into fix-search	2020-02-02 12:24:06 -08:00
.dockerignore	Add support for running oasis in a docker container	2020-01-01 10:07:41 -05:00
.eslintrc.js	Experiment with common-good module	2020-01-21 16:22:19 -08:00
.gitignore	Replace yarn.lock with package-lock.json	2020-01-03 15:19:35 -08:00
.huskyrc	Fix Travis CI on Windows	2019-09-16 15:50:03 -07:00
.npmignore	Add npmignore	2019-10-31 15:25:05 -07:00
.stylelintrc	Experiment with common-good module	2020-01-21 16:22:19 -08:00
.travis.yml	Specify exact Node.js engine support and test it	2020-01-31 10:59:10 -08:00
CHANGELOG.md	2.11.0	2020-01-16 11:58:00 -08:00
LICENSE	Add LICENSE file (for AGPL-3.0)	2020-01-28 17:45:00 -08:00
package-lock.json	Replace cooler methods with SSB-Client promises	2020-02-11 13:20:50 -08:00
package.json	Replace cooler methods with SSB-Client promises	2020-02-11 13:20:50 -08:00
README.md	Improve readme with more details about Oasis	2020-02-11 15:53:31 -08:00

README.md

Oasis

Oasis is a free, open-source, peer-to-peer social application that helps you follow friends and discover new ones on Secure Scuttlebutt (SSB).

🦀 Powered by SSB.
You're the center of your own distributed network. Online or offline, SSB works anywhere that you are. Follow the people you want to see and never worry about spam again. Migrate your data to another SSB app any time you want.

🌐 Bring your own browser.
Use your favorite web browser to read and write messages to the people you care about. Oasis runs over HTTP, so you don't need to worry about adding another Electron app to your computer.

🏰 Just HTML and CSS.
No browser JavaScript! Oasis has strict security rules that prevent any JavaScript from running in your browser, which helps us make Oasis accessible and easy to improve.

Usage

Start Oasis from a command-line interface with the oasis command.

$ oasis --help
Usage: oasis [options]

Options:
  --version   Show version number                                      [boolean]
  -h, --help  Show help                                                [boolean]
  --open      Automatically open app in web browser. Use --no-open to disable.
                                                       [boolean] [default: true]
  --offline   Don't try to connect to scuttlebutt peers or pubs. This can be
              changed on the 'settings' page while Oasis is running.
                                                      [boolean] [default: false]
  --host      Hostname for web app to listen on  [string] [default: "localhost"]
  --port      Port for web app to listen on             [number] [default: 3000]
  --debug     Use verbose output for debugging        [boolean] [default: false]

Installation

Most people should install stable releases with npm. Please make sure that your Node.js version is the current or active LTS release.

npm --global install @fraction/oasis@latest

For faster updates and less stability, install from GitHub and upgrade often.

npm --global install github:fraction/oasis

Want more? Check out install.md.

Resources

License

AGPL-3.0