ODE Desktop
User guide for ODE Desktop — the Open Data Ensemble desktop application for data stewardship and app development.
ODE Desktop joined the ensemble in v1.1.0. Install ODE Desktop to get started.
Two modes
ODE Desktop provides two modes in one application. Use the mode switcher in the top bar:
| Mode | Who it's for | What you do |
|---|---|---|
| Data management | Field and data staff | Profiles, observations, import, sync |
| Forms / app workbench | Form and app authors | Bundles, form preview, custom app testing |
Both modes share the active profile — the same Synkronus server, workspace, and local observation database.
Navigation
Data management
| Screen | Purpose |
|---|---|
| Profiles | Server connection, workspace, authentication |
| Observations | Search, edit, and resolve observations |
| Import | Import JSON observation files |
| Sync | Pull, push, and workspace maintenance |
| About | Support links and license |
Workbench
| Screen | Purpose |
|---|---|
| Bundles | Download app bundles from Synkronus |
| Form preview | Open and test forms from the bundle |
| Custom app | Run the custom app WebView |
| Developer mode | Iterate on a local custom app build |
Typical workflows
Data steward
- Create a profile with your Synkronus server URL.
- Authenticate on Profiles.
- On Sync, run Pull to download observations.
- Inspect and edit on Observations.
- Push local changes back to Synkronus.
App author
- Set up a profile and authenticate (as above).
- On Bundles, Download & apply the active app bundle.
- Test forms on Form preview or the full app on Custom app.
- For local iteration before publishing, enable Developer mode.
Related documentation
- ODE Desktop reference — architecture and workspace layout
- Installing ODE Desktop
- Understanding app bundles
- ODE Desktop developer mode — full developer mode guide