forked from GitHubMirrors/silverbullet-icalendar
24 lines
1.4 KiB
Markdown
24 lines
1.4 KiB
Markdown
# Initial Concept
|
|
`silverbullet-icalendar` is a Plug for SilverBullet that reads external iCalendar data (.ics format) and integrates it into the SilverBullet environment.
|
|
|
|
# Product Definition - SilverBullet iCalendar Plug
|
|
|
|
## Vision
|
|
A reliable and seamless bridge between external iCalendar services and the SilverBullet knowledge management environment, enabling users to consolidate their scheduling data within their personal workspace.
|
|
|
|
## Target Audience
|
|
- SilverBullet users who need to integrate external calendars (Google, Nextcloud, Outlook, etc.) directly into their notes and queries.
|
|
|
|
## Core Goals & Features
|
|
- **Reliable Multi-Source Synchronization:** Support for fetching and parsing `.ics` data from various providers like Google Calendar and Nextcloud.
|
|
- **SilverBullet Index Integration:** Seamlessly index calendar events using the `ical-event` tag, making them instantly queryable using SilverBullet's Lua Integrated Query (LIQ).
|
|
- **Robust Timezone Handling:** Accurate conversion and shifting of event times to ensure consistency regardless of the source provider's configuration.
|
|
- **Cache Management:** Efficient local caching of calendar data with user-configurable durations and force-sync capabilities.
|
|
- **Clean Indexing:** Sanitization of complex iCalendar objects into flat, query-friendly metadata.
|
|
|
|
## Technology Stack (Inferred)
|
|
- **Language:** TypeScript
|
|
- **Runtime:** Deno
|
|
- **Platform:** SilverBullet Plug API
|
|
- **Parsing Library:** `ts-ics`
|