Developer Documentation
Build plugins, integrations, and automations for Elysium. Everything you need to extend the platform and make it yours.
Guides
Getting Started
Set up your development environment and build your first plugin in minutes.
Read guidePlugin API
Complete reference for the plugin API, lifecycle hooks, and UI components.
Read guideShortcuts Integration
Build Apple Shortcuts actions that interact with Elysium schedules.
Read guideOpenTime Format
The open standard for schedule data. Parse, create, and manipulate .ot files.
Read guideCore Concepts
Elysium's extensibility is built on a few key principles:
OpenTime First
All schedule data uses the OpenTime format—an open, human-readable YAML standard. Your plugins work with portable data, not proprietary formats.
Local by Default
Plugins run locally and respect user privacy. Network requests are opt-in and transparent. Data stays on the device unless explicitly synced.
Swift Native
Plugins are written in Swift, giving you full access to Apple frameworks and native performance. No JavaScript bridges or web views.
What You Can Build
Data Providers
Import schedule data from external sources—calendars, task managers, project tools. Convert their formats to OpenTime and sync bidirectionally.
Custom Views
Add new ways to visualize schedules—Kanban boards, Gantt charts, habit trackers, or anything else you can imagine.
Actions & Automations
Extend the action menu with custom behaviors—send notifications, update external systems, trigger webhooks, or run complex workflows.
Shortcuts Actions
Expose your plugin's functionality to Apple Shortcuts, letting users build automations that span multiple apps.