$ show tantaman/strut
Strut is an open-core spatial presentation editor that lets users create decks of slides arranged in 3D space, with a camera flight presentation mode (impress.js-like). The application is built with React 19, TanStack Start, Vite, Tailwind 4, and TipTap/ProseMirror for rich text editing. The data layer is powered by Rindle, a custom sync engine providing optimistic local-first updates with live queries and a server daemon. Auth is handled by Better-Auth with anonymous guest-first sessions, optionally upgrading to OAuth. The application is designed to be self-hosted on Cloudflare Workers, using D1 for data and R2 for file storage, with a separate Rindle daemon for sync. AI features are a core part of the editor, allowing users to generate slides, arrange layouts, chat with the AI to edit content, and narrate from transcripts. All AI features run on the user's own OpenRouter API key (BYOK), with server-side normalization and trust boundaries to sanitize AI outputs. The editor includes a precision canvas for direct manipulation of components (text, images, shapes, video, webframes, and runnable 'artifact' components), a filmstrip slide well, and a chat panel for AI interactions. The application follows an open-core model: the open-source version is fully functional with community entitlements, while a private commercial overlay (sealed behind a #commercial module seam) adds Pro features like private decks and increased limits. Deployment is via pnpm commands, with local development using a Rindle fleet and production targeting Cloudflare Workers. The codebase demonstrates high craftsmanship in several areas: isomorphic mutator pattern (same mutation bodies run on client and server), trust-boundary normalizers for AI outputs, a history/undo system that treats AI edits as single atomic commands, and component fragments for efficient live subscriptions. However, there are some maintenance risks from duplicated constants, retired database columns, and the complexity of the commercial overlay.
The LLM identified 4 files worth highlighting for reuse:
Central contract defining the refined schema, query builder, and all isomorphic mutators for deck/slide/component CRUD. The same mutator bodies are executed on both client (optimistic prediction) and server (authoritative daemon writes), ensuring consistency. This pattern is highly reusable for any local-first application requiring shared mutation logic across tiers.
Framework-agnostic History stack with a capacity of 100 commands, each represented as {label, undo, redo} closures. Supports batch/drain for multi-step atomic undo and async undoIfCurrent to guard stale AI edits. Could be extracted and used in any application requiring an undo/redo system, independent of the presentation domain.
Handles copy/paste of components with custom MIME types for structured data and fallback to plain text. Includes functions to build clipboard payloads and instantiate pasted components with offset positioning. Reusable in any editor that needs rich clipboard operations, demonstrating careful handling of serialization and cross-application data exchange.
Single server module that resolves the user's model credential (decrypting the OpenRouter key from D1 using AES-GCM), constructs and sends requests to OpenRouter, and normalizes the SSE stream. All AI features (generate, arrange, chat, narrate) route through this seam, providing a clean abstraction for AI inference. The pattern of encrypting credentials at rest and normalizing responses is transferable to any BYOK AI service.