{"id":13570862,"url":"https://github.com/fraction/oasis","last_synced_at":"2025-04-04T18:02:40.740Z","repository":{"id":34977530,"uuid":"193544245","full_name":"fraction/oasis","owner":"fraction","description":"Free, open-source, peer-to-peer social application that helps you follow friends and discover new ones on Secure Scuttlebutt (SSB).","archived":false,"fork":false,"pushed_at":"2023-03-04T05:35:10.000Z","size":7091,"stargazers_count":285,"open_issues_count":131,"forks_count":42,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-03-29T00:09:46.242Z","etag":null,"topics":["browser","css","html","javascript","nodejs","p2p","scuttlebutt","ssb"],"latest_commit_sha":null,"homepage":"http://oasis-demo.fraction.io","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fraction.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security.md","support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-06-24T16:50:29.000Z","updated_at":"2025-03-06T14:07:31.000Z","dependencies_parsed_at":"2024-01-14T04:57:39.681Z","dependency_job_id":"5fcfd928-7ed2-4707-8189-80f1130bfa15","html_url":"https://github.com/fraction/oasis","commit_stats":{"total_commits":999,"total_committers":35,"mean_commits":"28.542857142857144","dds":"0.38638638638638634","last_synced_commit":"bd0b3f54c707d80e91241148124a18527d83ae1d"},"previous_names":[],"tags_count":98,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraction%2Foasis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraction%2Foasis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraction%2Foasis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fraction%2Foasis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fraction","download_url":"https://codeload.github.com/fraction/oasis/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247226211,"owners_count":20904465,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","css","html","javascript","nodejs","p2p","scuttlebutt","ssb"],"created_at":"2024-08-01T14:00:55.842Z","updated_at":"2025-04-04T18:02:40.694Z","avatar_url":"https://github.com/fraction.png","language":"JavaScript","readme":"# Oasis\n\nOasis is a **free, open-source, peer-to-peer social application** that helps\nyou follow friends and discover new ones on [Secure Scuttlebutt (SSB)][ssb].\n\n**🦀 Powered by SSB.**  \nYou're the center of your own distributed network. Online or offline, SSB works\nanywhere that you are. Follow the people you want to see and never worry about\nspam again. Switch to any SSB app you want at any time.\n\n**🌐 Bring your own browser.**  \nUse your favorite web browser to read and write messages to the people you care\nabout. Oasis runs a small HTTP server on your own computer, so you don't need\nto worry about adding another Electron app to your computer.\n\n**🏰 Just HTML and CSS.**  \nNo browser JavaScript! Oasis has strict security rules that prevent any\nJavaScript from running in your browser, which helps us make Oasis accessible\nand easy to improve.\n\n## Example\n\nAfter installing, launch Oasis from the command line by running:\n\n```sh\noasis\n```\n\nIt will then pop open a browser window for you.\n\n![Screenshot of Oasis](./docs/screenshot.png)\n\nUse `oasis --help` to get configuration options. You can change the default\nvalues with a custom [configuration](./docs/configuring.md).\n\n## Installation\n\nFirst, you'll need Node.js and npm on your computer. Run `node --version` to see if you have it. If not, or if it's older than the [**current** or **active LTS** version](https://nodejs.org/en/about/releases/), you should [download Node.js](https://nodejs.org/en/about/releases/) first.\n\nThen you can install the stable version of Oasis:\n\n```shell\nnpm -g install fraction/oasis#semver:\n```\n\nOr, for faster updates and less stability, install Oasis from GitHub and upgrade often.\n\n```shell\nnpm -g install fraction/oasis\n```\n\nCheck out [`install.md`](https://github.com/fraction/oasis/blob/master/docs/install.md)\nfor more information.\n\n## FAQ\n\n### Can I use the same profile from multiple computers?\n\nNo, this is a limitation of SSB. You'll need to make a separate profile on each device. There is a workaround [we'd like to implement](https://github.com/fraction/oasis/issues/267) which ties your multiple profiles together.\n\n### Can I run this at the same time as Patchwork and other SSB apps?\n\nYes! They will both use the same data and profile. You can either run them one at a time or simultaneously. If you run them at the same time, start Patchwork first, then Oasis.\n\nDetails: SSB apps have two parts: a \"server\" that manages the database (on your own computer), and a user interface that gets things from the server to display. Only one server can run at a time, but multiple apps can use it.\n\n| App       | Runs its own SSB server            | Can use SSB server of another app              |\n| --------- | ---------------------------------- | ---------------------------------------------- |\n| Oasis     | Yes, unless one is already running | Yes                                            |\n| Patchwork | Yes                                | No, only uses its own server                   |\n| Patchbay  | Yes                                | No, only uses its own server                   |\n| Patchfox  | No                                 | Yes, depends on other apps to provide a server |\n\n### Can I use Oasis as a desktop app?\n\nYes! Check out [Oasis-Desktop](https://github.com/fraction/oasis-desktop)!\n\n## Resources\n\n- [Architecture](https://github.com/fraction/oasis/blob/master/docs/architecture.md)\n- [Chat room](https://matrix.to/#/!YQpqIZlvBVPYRwrkXp:matrix.org?via=matrix.org)\n- [Contributing](https://github.com/fraction/oasis/blob/master/docs/contributing.md)\n- [Help](https://github.com/fraction/oasis/issues/new)\n- [Security policy](https://github.com/fraction/oasis/blob/master/docs/security.md)\n- Source code: [Github](https://github.com/fraction/oasis.git) and [Gitlab](https://gitlab.com/fraction/oasis)\n\n## See Also\n\n- [Oasis-Desktop](https://github.com/fraction/oasis-desktop)\n- [Patchbay](https://github.com/ssbc/patchbay)\n- [Patchwork](https://github.com/ssbc/patchwork)\n- [SSB-Browser](https://github.com/arj03/ssb-browser-demo)\n- [SSB-Server](https://github.com/ssbc/ssb-server)\n- [Yap](https://github.com/dominictarr/yap)\n\n## License\n\nAGPL-3.0\n\n[ssb]: https://en.wikipedia.org/wiki/Secure_Scuttlebutt\n","funding_links":[],"categories":["JavaScript","css"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraction%2Foasis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffraction%2Foasis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffraction%2Foasis/lists"}