How tombarys/roam-depot-nautilus works
Main Components
a) Frontend Layer (User Interface):
• Task Visualization (Spiral Display)
• Event Renderer
• Progress Tracker
b) Core Processing Layer:
• Task Manager
• Duration Calculator
• Time Slot Allocator
• Progress State Handler
• Event Parser
• Time Range Parser (12h/24h format)
• Event Validator
• Task Scheduler
• Push-forward Algorithm
• Task Reordering System
c) Integration Layer:
• Roam Research API Interface
• TODO Trigger Extension Integration
• Settings Manager
Component Relationships
• User Input → Roam Research Page
• Roam Research Page ↔ Nautilus Component
• Nautilus Component → Task Manager
• Task Manager ↔ Event Parser
• Task Manager ↔ Task Scheduler
• All Components ↔ Settings Manager
Technical Stack Indicators
Technology usage:
• ClojureScript (main implementation)
• JavaScript (helpers)
• CSS (styling)
• Webpack (bundling)
Integration Layer (bottom)
Important Implementation Details to Highlight:
• The component is initialized through Roam's template system (;;Nautilus)
• Settings are managed through Roam Depot's extension system
• Task processing happens in real-time based on the current time
• Progress tracking is handled through both UI interactions and text markers