Safe Network Browser Application
The Safe Browser is actively being developed against various iterations of The Safe Network. Both of which are still considered alpha software, so please be prepared to encounter and report bugs!
You currently (need the Safe Authenticator to be installed.)[https://github.com/maidsafe/safe-api#the-authenticator-daemon].
Currently 404 pages renders are being swallowed by electron (https://github.com/electron/electron/issues/21046), so these errors / pages returned to browser will return a 200 error code, but a 404 page served by the browser's internal server.
| Linux/macOS |
|---|
Built upon peruse, but using its baked in extensibility to add SAFE Network functionality.
Looking for more information about developing websites/web apps for the SAFE Network? Take a look at the Web App Overview.
For normal SAFE Network browsing, you should download the latest version of the browser from The SAFE Browser releases page.
Application developers should use the same link, but choose the -dev postfixed version for their platform. This version uses a mock network to allow local development (without the need to pay PUT costs on a live SAFE Network).
We use a dev branch for development. And we keep master as a stable reference updated with each release.
To find out more about the structure of Peruse and the SAFE functionality extending it, read the Browser Application Design Overview.
npm).yarn config set child-concurrency 1 just once to effect local yarn settings.npm install --global --production windows-build-tools which installs Python 2.x, Visual Studio 2015 build tools, and Visual C++ build tools.libgconf-2-4 and/or build-essential dependencies might be missing. Please install them as needed with Synaptic Package Mgr., or with apt from a shell console: $ sudo apt-get install libgconf-2-4 build-essentialgit clone https://github.com/maidsafe/safe_browser.gitgit checkout master (master is the stable branch. dev is current working branch)cd safe_browserNODE_ENV=dev yarn (NODE_ENV is needed to install mock libs and to run yarn mock-dev).yarn rebuildAnd to run dev mode:
yarn mock-devWant to run 'production' variables, but with hot reloading?
yarn put-live-net-files-for-yarn prod-devNote, you'll need a crust.config set for the application. Helper commands for osx/linux/windows
And to package:
yarn packageThe resulting packages are contained within the releases folder.
A packaged application, built in a NODE_ENV=dev, can access either prod or dev networks. prod is the default, or alternatively you can open the application and pass a --mock flag to open and use a mock network.
On Linux, the packaged application gets generated as a Shared Library file and hence cannot be run by double-clicking the executable. This is due to an issue with electron-builder( https://github.com/electron-userland/electron-builder/issues/3950 ). But the application can be run through the terminal. You can run the browser by running ./safe-browser.
On macOS, the application should be located in the 'Applications' for security reasons. By default the packaged application will prompt to move the application. To override this, you can pass --ignoreAppLocation:
open release/safe-browser--mac-x64/SAFE\ Browser.app --args --ignoreAppLocation
There are a few build commands for various situations:
yarn prod-dev will run a developer version of the application using the live network.yarn build compiles all code, but you shouldn't need to use thisyarn build-preload will need to be run whenever you change the preload.js file for changes to show up in the browser.Pushes to master will be automatically released, with changelog generated from conventional commits (enforced at commit time, and checked at CI), and the version bumped autmomatically.
To release alpha/beta versions of the browser, simply create a version tag for the release you want, ie v0.18.0-alpha.0 and push this to the repository to trigger a build of that alpha/beta version.
yarn test runs jest (you have the optional yarn test-watch, too).yarn test-e2e runs spectron integration tests (not yet stable).yarn lint runs the linter and throws all of the lint errorsyarn lint-fix runs the linter, Automatically fix problems that it can & throws the remaining lint errorsVia electron-log: import { logger } from '$Logger', and you can logger.info('things').
Logs are printed to both render console and stdout. Logs are also written to a log file per system.
yarn log-osx will tail the file. Similar commands (as yet untested) exist for linux/windows.
electron-logis used under the hood, and ouputs logs to:
You can discuss development-related questions on the SAFE Dev Forum. If you are just starting to develop an application for the SAFE Network, it's very advisable to visit the SAFE Network Dev Hub where you will find a lot of relevant information, including a tutorial to create an example SAFE web application which makes use of the API exposed by the SAFE Browser.
This SAFE Network library is dual-licensed under the Modified BSD (LICENSE-BSD https://opensource.org/licenses/BSD-3-Clause) or the MIT license (LICENSE-MIT https://opensource.org/licenses/MIT) at your option.
Want to contribute? Great :tada:
There are many ways to give back to the project, whether it be writing new code, fixing bugs, or just reporting errors. All forms of contributions are encouraged!
For instructions on how to contribute, see our Guide to contributing.
No open issues yet, or sync has not completed.