OYOD App
Build useful, sustainable apps without a business model.
This is a developer toolset for building a client-side OYOD app for the OYOD ecosystem.
Authorizing your OYOD App
Your app needs permission before reading and/or writing data to a user's home server. Fortunately, oyod-app
can take care of most this logic for your oyod-app. Here's how to use it.
//// Verifies current session / access_token.//oyod //// If the user is not signed in, then you need to// ask them for their OYOD email and then// redirect them to this url...//var BAPP_HOST = 'localhost:9080' // Your app's hostoyod//// ...and make sure this code is also your returning page.// It checks for oauth success data, which is important after// the user is redirected back to your oyod-app.//var query = oyod if querycode oyod //// If the user IS signed in, then// this will eventually be true//oyodready //=> true or false //// Once ready, the session object becomes available...//oyodsessionusername //=> Stringoyodsessionemail //=> Stringoyodsessionavatar_url //=> Stringoyodsessionscope //=> Array<String> //// ...and you get access to cool APIs!//oyodpv // Path-Value API
API
Once you have an access token, you can use the following APIs.
Path-Value API
The Path-Value API allows you to store data via a folder-like interface. This not only allows for efficient key-value usage, but also for retrieving a list of values in a given path.
var todos = oyodpv // Returns a stream-wrapped collection //=> undefined// but later... //=> An array of datapoints! //// This creates a new datapoint to your user's server// AND populates todos() when it's done//oyodpv // later...var myTodo = 0myTodopath //=> /todos/:ouhOEco-uHOEc-UEeu-oeumyTodocreated_at //=> epoch numbermyTodoupdated_at //=> null | epoch numbermyTodovalue //=> { title: 'try it out' } //// Given a datapoint path,// you merge in data, giving you { title: 'try it out', x: 10 }...//oyodpv //// ...or replace the whole thing!//oyodpv //// If you don't like anymore, you can (soft) delete.// All modifications will auto-update your todos() collection.//oyodpv
oyod-app.json
name:
The name of your app.avatar:
A url or path to your app's image avatar logo.description:
A short description of what your app does (255 chars max, markdown accepted).categoryIcon:
An icon name from this list
Developing
git clone https://github.com/oyod/oyod-appcd oyod-appnpm installnpm run dev
Now visit http://localhost:9080
Build Information
npm run build
builds the library to dist
, generating three files:
dist/oyod-app.cjs.js
A CommonJS bundle, suitable for use in Node.js, thatrequire
s the external dependency. This corresponds to the"main"
field in package.jsondist/oyod-app.esm.js
an ES module bundle, suitable for use in other people's libraries and applications, thatimport
s the external dependency. This corresponds to the"module"
field in package.jsondist/oyod-app.umd.js
a UMD build, suitable for use in any environment (including the browser, as a<script>
tag), that includes the external dependency. This corresponds to the"browser"
field in package.json
npm run dev
builds the library, then keeps rebuilding it whenever the source files change using rollup-watch.
npm test
builds the library, then tests it.
Note that you would often include the dist
folder in your .gitignore file, but they are included here for ease of illustration.
License
MIT.