🕸 Nodeveil v1.0.0 — The First Stable Release
Nodeveil 1.0.0 marks the first production-ready release of the filesystem-native knowledge graph engine.
This version delivers a complete, stable workflow:
- Index your real files.
- Create hard links between them.
- Navigate backlinks instantly.
- Explore your structure visually in Graph View.
- Use clean, responsive UI with multiple themes.
- Run fully local — no cloud, no AI, no telemetry.
🚀 Highlights
🧱 Filesystem-Native Indexing
- Recursive root indexing with incremental updates.
- Real-time file watcher with crash-safe reconciliation.
- Handles large datasets (10k+ files) efficiently.
- SQLite WAL mode for durability and performance.
- Resume-safe after unexpected shutdown.
🔗 Hard-Link Graph Engine
- Create and remove links between any indexed files.
- Backlinks are instant and indexed.
- Relation types supported (customizable per link).
- Soft-delete link model for safety.
- Export / Import graph relationships (no file content).
🌐 High-Performance Graph View
- Interactive WebGL-based visualization.
- Smooth pan & zoom.
- Depth-limited neighborhood exploration.
- Filter by relation type and file extension.
- Cluster / collapse support.
- Guardrails to prevent runaway graphs.
Benchmarked for:
- 5,000 nodes smooth at interactive framerates.
- 10,000 nodes usable without freezing.
🎨 New Theme System
Switch themes instantly without restart.
Available themes:
- ☀ Light
- 🌙 Dark
- ⚡ Neon
- 🌸 Sakura
Theme system is token-based and consistent across:
- App surfaces
- Panels
- Graph rendering
- Status states
All themes meet readability and contrast standards.
🧭 User Experience Improvements
- First-run onboarding flow.
- Resizable panels.
- Collapsible layout for small windows.
- Keyboard shortcuts for search and linking.
- Undo/Redo for link operations.
- Clear system health indicators.
- Diagnostics panel with event logs.
🛠 Stability & Reliability
- DB integrity check at startup.
- Engine reconnect recovery.
- Watcher overflow fallback rescan.
- Permission error isolation (non-fatal).
- Safe export/backup from UI.
- No file content ever uploaded.
🧪 Performance & Benchmarks
v1.0.0 includes measurable benchmarks:
Engine
- 10k file index under ~2s (SSD typical).
- 50k edges insert under ~3s.
- Backlink query p95 < 5–10ms typical.
Desktop
- Time-to-interactive under ~3–3.5s for 5k node graph.
- Theme switching p95 < 80ms.
- No memory leak under 60s stress graph test.
All performance tests run in CI on Linux.
🔐 Privacy
Nodeveil runs fully local.
- No cloud.
- No telemetry.
- No file content processing beyond metadata.
- No background network communication.
📦 Installation
Prebuilt official binaries are available for:
- Windows (.exe installer)
- macOS (.dmg)
- Linux (.AppImage)
You may also build from source (see README).
📜 License Model
Nodeveil uses a source-available license:
- Official builds may be used for non-commercial purposes.
- If you distribute modified versions, you must publish the complete modified source.
- The “Nodeveil” name and branding are not automatically granted for forks.
See LICENSE file for full details.
⚠ Known Limitations
- Very large graphs (>10k nodes visible simultaneously) may require filter narrowing.
- Layout positions are not persisted across sessions (planned for future release).
- No collaboration or cloud sync (intentionally local-first).
- No file content rendering beyond lightweight previews.
🛣 Roadmap After 1.0.0
Planned directions:
- Optional layout persistence
- Advanced graph clustering
- Smarter navigation shortcuts
- Plugin SDK (carefully scoped)
- Optional paid convenience features
🙏 Thank You
Nodeveil 1.0.0 is the result of building a system that respects:
- Structure over chaos
- Determinism over magic
- Local ownership over cloud dependency
This is just the foundation.