Skiff Calendar

​

Key Features

​

Event Creation and Management

​

Creating Events

• Quick Add: Click any time slot to quickly create an event
• Detailed Editor: Full event editor with all fields
• Recurring Events: Set up daily, weekly, monthly, or custom patterns
• All-Day Events: Create events that span entire days
• Time Zones: Multi-timezone support for global scheduling
• Reminders: Set custom notification reminders

​

Event Properties

// Event fields (all encrypted)
{
  title: string;
  description: string;
  location: string;
  startTime: Date;
  endTime: Date;
  isAllDay: boolean;
  recurrenceRule?: RecurrenceRule;
  attendees: Attendee[];
  reminders: Reminder[];
  color: string;
  calendar: string;
}

​

Recurring Events

• Daily: Every day or every N days
• Weekly: Specific days of the week
• Monthly: By day of month or nth weekday
• Yearly: Annual events
• Custom: RRULE-based custom patterns
• Exceptions: Skip specific occurrences
• Until Date: Set end date for recurrence

​

Calendar Views

​

Available Views

​

Encryption Architecture

​

Event Encryption

• Title Encryption: Event titles are encrypted as separate fields
• Description Encryption: Rich text descriptions fully encrypted
• Metadata Protection: Location, attendees, and notes are encrypted
• Recurrence Rules: RRULE patterns are encrypted client-side

​

Decryption Models

// Source: calendar-web/src/storage/models/event/
DecryptedEventModel {
  // Encrypted data is decrypted and cached locally
  // using IndexedDB with Dexie
  decrypt(privateKey: PrivateKey): Event;
  encrypt(publicKey: PublicKey): EncryptedEvent;
}

​

Client-Side Storage

• Dexie: IndexedDB wrapper for structured storage
• Local Caching: Events cached for offline access
• Background Sync: Automatic synchronization when online
• Crypto Workers: Web Workers for encryption operations

​

ICS Import and Export

​

Import Capabilities

​

Export Functionality

• Single Event Export: Download individual events as .ics files
• Calendar Export: Export entire calendars
• Standard Format: Compatible with all ICS-supporting applications
• Attendee Information: Includes encrypted attendee data

​

ICS Library Features

// Package: libs/skiff-ics
import { parseICS, generateICS } from 'skiff-ics';

// Parse ICS file to events
const events = parseICS(icsFileContent);

// Generate ICS from events
const icsOutput = generateICS(events, calendarMetadata);

• Event parsing and generation
• Recurring events (RRULE)
• Time zone handling (using windows-iana and @vvo/tzdb)
• Attendee and organizer information
• Reminders and alarms
• Event exceptions (EXDATE)

​

Google Calendar Integration

​

Import Process

1. OAuth Authentication: Secure Google account connection
2. Calendar Selection: Choose which calendars to import
3. Event Fetching: Download all events via Google Calendar API
4. Local Encryption: Events are encrypted before storage
5. Continuous Sync: Optional ongoing synchronization

​

Technical Implementation

// Dependencies used for Google Calendar import
import { gapi } from 'gapi-script';
import { googleapis } from 'googleapis';

// Type definitions
@types/gapi
@types/gapi.auth2
@types/gapi.client.calendar

​

Scheduling Features

​

Event Invitations

• Send encrypted calendar invitations to Skiff users
• Email-based invitations for external users
• RSVP tracking (Accept, Decline, Maybe)
• Attendee response notifications
• Organizer controls for event updates

​

Participant Management

• Add multiple attendees to events
• Participant suggestion based on frequent contacts
• Encrypted attendee lists
• Required vs. optional attendees
• Response status tracking

​

Reminders and Notifications

• Custom reminder times (5 min, 15 min, 1 hour, 1 day, etc.)
• Multiple reminders per event
• Browser notifications
• Email reminders for important events
• Smart reminder suggestions

​

Multi-Calendar Support

​

Calendar Organization

• Create multiple calendars for different purposes
• Color-code each calendar for visual distinction
• Toggle calendar visibility in views
• Share calendars with other Skiff users
• Subscribe to public calendars

​

Calendar Settings

• Name and Description: Identify your calendars
• Color Theme: Choose from preset colors
• Default View: Set preferred view per calendar
• Notifications: Calendar-specific reminder settings
• Sharing: Control access permissions

​

Time Zone Support

• Automatic time zone detection
• Manual time zone selection
• Per-event time zone settings
• DST-aware calculations
• Time zone database from @vvo/tzdb
• Display events in local or original time zone

​

Mobile Experience

• Responsive Design: Adapts to all screen sizes
• Touch Gestures: Swipe between days, weeks, months
• Mobile Event Creation: Simplified quick-add interface
• Offline Support: View and create events without connection
• Native Apps: iOS and Android applications

​

Privacy and Security

​

Zero-Knowledge Architecture

• All event data is encrypted client-side
• Servers never see plaintext event information
• Private keys never leave user devices
• Metadata minimization for maximum privacy

​

Cryptographic Implementation

• skiff-crypto: Core encryption functions
• skiff-crypto-v2: Modern crypto primitives
• @stablelib/base64: Base64 encoding for encrypted data
• Protocol Buffers: Structured data serialization

​

Technical Architecture

​

Source Code Structure

calendar-web/src/
├── components/
│   ├── Calendar/         # Main calendar grid views
│   ├── CalendarHeader/   # Navigation and view controls
│   ├── CalendarSidebar/  # Mini calendar and calendar list
│   ├── EventInfo/        # Event detail display
│   ├── modals/          # Event creation and editing
│   └── CalendarSettings/ # User preferences
├── crypto/              # Encryption/decryption logic
│   └── cryptoWebWorker/ # Worker threads for crypto
├── storage/             # IndexedDB and local caching
│   └── models/          # Decrypted data models
└── redux/               # State management

​

Local Storage with Dexie

// IndexedDB schema using Dexie
import Dexie from 'dexie';

class CalendarDatabase extends Dexie {
  events: Dexie.Table<DecryptedEvent, string>;
  calendars: Dexie.Table<Calendar, string>;
  drafts: Dexie.Table<DecryptedDraft, string>;
  
  constructor() {
    super('SkiffCalendar');
    this.version(1).stores({
      events: 'id, calendarID, startTime, endTime',
      calendars: 'id, name',
      drafts: 'id, lastModified'
    });
  }
}

​

GraphQL Operations

• createEvent: Create new encrypted event
• updateEvent: Modify existing event
• deleteEvent: Remove event from calendar
• getEvents: Fetch events for date range
• importCalendar: Import ICS calendar
• shareCalendar: Share calendar with users

​

Advanced Features

​

Getting Started

​

Learn More

• Skiff Security Model
• ICS Library Source
• Calendar Source Code
• Join Discord Community