Version 1.0 Documentation
Crystal Canvas is not just a rendering upgrade—it is a complete mechanical, visual, and architectural overhaul of the native Obsidian Canvas. Designed to bypass traditional canvas lag, it turns your vault's canvas into a living, breathing workspace for fluid spatial thinking.
1. The Living Environment
A fully customizable, elegantly animated backdrop. It responds to your node placements like the surface of a lake, utilizing advanced masking to make your nodes visually pop without sacrificing an ounce of performance. It takes the stiffness out of the workspace, making it feel alive. You can fully customize patterns, colors, and spacing to match your exact aesthetic.
Pure, physics-based navigation. When you pan across the screen and let go, the canvas carries your momentum naturally. It eliminates the jarring "dead stop" of the native workspace, making navigation feel incredibly frictionless.
The zoom mechanics have been completely rebuilt from the ground up. The zoom center is now perfectly anchored to your cursor with smooth, mathematical easing. It feels like you are seamlessly diving into your ideas rather than just clunkily scaling a webpage.
Grouped nodes automatically adopt a stunning, blurred glass effect. The color and blur dynamics adjust based on the nesting level, and the colors react beautifully to the movement of your mouse cursor, adding a deeply premium feel to your organization.
Switching between canvas tabs triggers a soft, beautiful viewport blur. It completely eliminates harsh visual cuts, keeping the experience incredibly easy on the eyes during long sessions.
Every single visual feature mentioned here includes 20 to 30 dedicated sub-settings. You have the total freedom to tweak the dynamics, colors, and physics exactly to your liking.
3. The Pro Drawing Studio
Draw a jagged circle, a crooked triangle, or an awkward polygon. The moment you release your cursor, the engine instantly morphs it into a perfect geometric shape. It gracefully auto-closes unlinked ends, taking the friction out of quick sketching.
Features 4 distinct brush styles with a precise preview stroke that matches your actual output size. Apply beautiful effects like shadows, glows, and advanced blend modes, and pin your strokes directly to the canvas or the viewport.
Manage your colors in the dedicated Palette Library panel. Create custom brush presets and fill your shapes with solid colors, soft blurs, or diverse pattern fills.
Bring your sketches to life. Apply 2D and 3D animation presets to your strokes, or record your own custom stroke movements and let them run on a continuous loop.
Advanced Lasso multi-select tools give you precise Z-index rearrangement for overlapping strokes.
Export your selections as PNG, JPG, or SVG in multiple sizes and backgrounds. For the power users, you can even export flat 2D strokes as fully rotatable 3D .glb files.
Export the entire drawing layer as proprietary Crystal JSON (retaining all your advanced effects), standard tldraw, or Obsidian tldraw. You can seamlessly import existing whiteboards straight into your workflow.
4. Node Mechanics & Neural Routing
We bypassed Obsidian's rigid single-center-point limitation. You can now add multiple distinct connection edges to any single side of a node, allowing for incredibly complex, organic mapping.
If you drag a connected node across the canvas, the connection intelligently detaches and re-attaches to the most logical side. No more ugly, overlapping lines—just clean, readable thought paths.
Fully customize the shape, labels, animations, and color of your connections. Flip directions instantly, and navigate the canvas effortlessly just by following the connection paths.
Dynamic border-radius adjustments based on high-end UI rules. When nodes are nested inside other nodes or groups, their corner roundness automatically scales to look mathematically perfect and visually pleasing.
Break the grid. Free-rotate any text, image, or media node in 2D space to build the exact visual hierarchy you want.
5. The Asset Gallery & Echo Scanner
Sort assets by Date, Name, Size, Dimensions, or use advanced color algorithms to sort by Hue or Brightness Usage. Easily toggle between Grid and List views.
Hover your mouse over a video thumbnail in the grid to instantly scrub through the timeline. Hover over a 3D asset thumbnail to rotate the model in 3D space directly from the menu. It is incredibly fast and satisfying to use.
A built-in deduplication engine that keeps your vault pristine. It scans your canvas attachments, highlights duplicates, and allows you to manage them via a dedicated Trash area to permanently clean up unused clutter.
Multi-select items from the gallery and drag them directly onto the canvas into perfectly pre-programmed geometric grid layouts.
7. Pro Media Player & Pretext Engine
A bespoke, beautifully integrated media player for audio and video files. Features live audio visualizers, loop, shuffle, and auto-start controls right on the canvas.
Capture a screenshot directly from a playing video node. The screenshot drops onto the canvas tagged with an exact timestamp. Clicking that screenshot later will automatically snap the source video right back to that exact frame.
An advanced markdown and text-card rendering engine operating under the hood to ensure your text scales, displays, and reads flawlessly at any zoom level.
8. The Horizon: What's Next
Crystal Canvas v1.0 is just the foundation. The architecture is built, the engine is humming, and we have a massive roadmap of ideas and features coming in future updates. The goal is to continuously push the boundaries of what a frictionless, infinite canvas can feel like inside your vault. This is a living project, and it is only going to get more powerful, more fluid, and more beautifully tailored to how you think.