Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Note: Manifold is currently under heavy development and is subject to change. This is meant to be a guide for Manifold and Manifold app developers.


Installing Manifold, preparing the root pico for authentication 

...

  1. Start an instance of the pico engine from a command line with the initial host set to "http://localhost:8080", or whatever host you are developing on. This is an example command command: "PICO_ENGINE_HOST=http://localhost:8080 pico-engine". If you are using a different port, remember to change the host accordingly and set the port with "PORT=<your port number>" (Ensure that your engine is of version 0.45.2 or higher).
  2. Clone or download the following Github Repository: Manifold Repository.
  3. Enter the directory downloaded in step 2 on your local machine from command line and type "npm install" this will initiate an installation of the required dependencies. Once this process finishes enter "npm start" this should start an instance of the Manifold. (You will have 2 separate instances running now, one for manifold, the other for the pico engine). By default this starts on localhost port 3000.
  4. In your browser, open the page for your pico engine (by default: localhost:8080) and install the following rule-sets on the root pico: (they should all be visible under the Rulesets tab in the Available Rulesets dropdown-menu)
    • io.picolabs.oauthgoogle_serversignin
    • io.picolabs.account_management
    • io.picolabs.owner_authentication 

The io.picolabs.account_management ruleset will automatically install the io.picolabs.owner_authentication ruleset. When installed, the pico engine page will refresh requiring you to login before doing anything else. The default root pico id and password are: "root" and "toor" respectively. If you want to add your own account, enter the Testing tab of your root pico, click the checkbox button for  "io.picolabs.account_management" enter a new name and password and click the "owner/creation" button. To access your new account, logout from the top right of your browser window and enter the recently created credentials.)


     5. Register the following rulesets with your engine (but do not install them on your pico yet):

...

The rulesets can be found in the folder "Manifold_krl" at the root of the Manifold project you cloned in step 2.

Registering with the OAUTH server

Image Removed

...

Edit config.js

  1. Open The Manifold project in your favorite text editor
  2. Open /src/utils/config.js
  3. Comment out the production section of config.js, and uncomment the development section
  4. Open your root pico on localhost:8080 (or wherever your engine is running), open the channels page, find the ECI/DID that has the policy "only allow google owner_did_requested events". If you cannot find this DID, make sure the io.picolabs.google_signin ruleset is installed
  5. Copy the above ECI/DID into ROOT_SECURED_DID in the config.js file.
  6. Edit any other fields in the config file under the development section

Your config file should look something like this:

Image Added

Logging into Manifold

...

In a separate tab, open the manifold page (by default address: localhost:3000/#/login)
Image Removed

...


Image Added

If everything was done correctly, clicking on the Sign in with Google button should navigate you to the Manifold landing page after signing in. Note: Once you are signed in, an internet connection is no longer necessary.

Image Added

You are now ready to develop Manifold and/or Manifold apps.

Updating Manifold

 You can now enter your text editor and change the local Manifold files, the program will automatically detect these changes and display them. 

...