BrainSync - Personal Knowledge Management
PROJECT OVERVIEW & OPERATIONAL CONTEXT
BrainSync is a high-performance personal knowledge management web application engineered to overcome cognitive fragmentation and rigid folder hierarchies through associative thought networking. Grounded in Clean Architecture and Domain-Driven Design, the platform cleanly decouples core domain parsers and business use cases from infrastructure and presentation concerns. The backend is built with Fastify and Prisma ORM atop PostgreSQL 16, utilizing native GIN trigram indexes (pg_trgm) to achieve sub-millisecond full-text and fuzzy search across extensive note vaults. The frontend utilizes Next.js 16 (App Router) and React 19 as a secure Backend-for-Frontend, where Server Components and Server Actions orchestrate data retrieval without exposing database internals to client browsers. Real-time bi-directional linking ([[Title]]), debounced auto-saving (1500ms), and an interactive Three.js 3D galaxy graph engine provide a seamless, locked 60 FPS knowledge exploration experience.
PROBLEM STATEMENT & SYSTEM CONSTRAINTS
Rendering dense, interactive 3D knowledge graphs with hundreds of interconnected nodes and synapsing edges presented significant GPU memory overhead and browser main-thread contention. Complex force-directed spatial simulations and high-frequency DOM repaints during real-time split-screen Markdown editing caused noticeable frame drops. Additionally, recalculating bi-directional link graphs, resolving dangling ghost links, and synchronizing Markdown checkbox states across multiple note entities demanded atomic database mutations without triggering thread blocking or race conditions.
- Eliminate main-thread blocking during graph exploration by optimizing Three.js scene instances, BufferGeometry line buffers, and physics alpha decay cooling.
- Deliver sub-millisecond full-text and fuzzy search retrieval across note titles, tags, and content using PostgreSQL GIN trigram indexes (pg_trgm).
- Achieve atomic bi-directional link synchronization and unresolved ghost link resolution within isolated transactional repository boundaries.
- Provide a distraction-free, zero-latency Markdown editing experience featuring synchronized live GFM preview and 1500ms debounced auto-saving.
- Aggregate vault-wide Markdown checklist items into a real-time GTD dashboard with bi-directional synchronization back to source Markdown files.
- Ensure full data portability through streaming ZIP archive export and batch Markdown import pipelines.
3D Galaxy Knowledge Graph Engine
Interactive Three.js WebGL celestial sphere featuring high-DPI billboard text sprites, shared geometry line buffers, and physics cooling to preserve 60 FPS performance.
Bi-Directional Wiki-Link Network
Associative note interlinking using [[Title]] syntax with real-time autocompletion, context snippet extraction, and dynamic backlinks computation.
Trigram Fuzzy Omnibar Search
Global modal search palette (Cmd/Ctrl + K) leveraging PostgreSQL GIN trigram indexes to execute instant typo-tolerant searches across titles, content, and tags.
Split Markdown Editor with Live Preview
Three-way toggleable interface (Edit, Split, Preview) supporting GitHub Flavored Markdown, code syntax highlighting, and debounced 1500ms background auto-saving.
Dual-Layer Tag Taxonomy
Hybrid classification engine combining structured metadata tags with automated regex extraction of inline #hashtags and vault-wide frequency counters.
Integrated GTD Task Dashboard
Vault-wide aggregation of all - [ ] checklist items into a centralized task console featuring note grouping, completion metrics, and two-way Markdown state synchronization.
Vault Portability & Backup Engine
Streaming full-vault export generating standardized ZIP archives of raw Markdown files alongside batch import pipelines for Markdown files and archives.
Next.js 16 App Router & React 19 BFF + Three.js 3D WebGL galaxy renderer + Fastify Clean Architecture core + PostgreSQL 16 pg_trgm trigram search + Prisma ORM relational graph persistence
Omnibar Keyboard Trigger & Input Dispatch
User triggers Cmd/Ctrl+K shortcut, opening modal palette and issuing debounced query to Fastify search endpoint.
Trigram Index Matching & Ranking
PostgreSQL executes parallel GIN index scans across Note_title_trgm_idx and Note_content_trgm_idx using pg_trgm similarity scoring.
Markdown Ingestion & Lexical Parsing
Domain regex parsers extract wiki-link targets [[...]], inline #hashtags, and task checklist items - [ ] into pure domain entities.
Transactional Persistence & Link Synchronization
Prisma executes atomic database transaction updating note content, recalculating forward NoteLink edges, and re-indexing NoteTag junctions.
Spatial Physics Cooling & WebGL Scene Assembly
Three.js updates node coordinates, scales spheres by connection degree, updates shared BufferGeometry line buffers, and decays simulation alpha.
Bi-Directional Task & Backlink Projection
Server Actions project updated task states and incoming backlinks to Next.js React Server Components with zero client bundle overhead.
SYSTEM EVALUATION & EMPIRICAL VALIDATION
VERIFIED_TELEMETRYDuring comprehensive performance profiling and stress-testing across production-grade Docker containers and local environments, BrainSync sustained locked 60 FPS rendering in the Three.js 3D galaxy view across 160+ interconnected synapses, driven by shared geometry buffers and physics alpha decay cooling. The Fastify backend, coupled with PostgreSQL 16 and Prisma ORM, achieved median search query latencies under 5ms (with p99 latencies under 12ms) via native GIN trigram indexes (pg_trgm) across multi-thousand-word Markdown notes. The 1500ms debounced auto-save mechanism eliminated UI thread contention while maintaining 100% data integrity through transactional ACID database operations. Furthermore, the Vitest test runner verified 62 passed tests across 15 unit and integration test suites in 2.10 seconds, validating domain regex parsing, bi-directional link synchronization, graph projection algorithms, and Fastify REST routes with zero defects.
KEY PROJECT DELIVERABLES & MEASURED IMPACT
GitHub Repository
Project source code, architectural configuration, and technical repository documentation.
Technical Documentation & Spec
Primary architectural specification: PRO-33 // WEB-09 (Next.js 16, React 19, TypeScript 5.9, Three.js 0.186).
Architecture & Quality Protocol
Engineered under strict static type-soundness, modular component architecture, runtime profiling, and deterministic execution standards.
Nabungin - Personal Finance Tracker
Full-stack personal finance platform engineered with Next.js 16, React 19, Express 5, and Prisma 7 on PostgreSQL 16, featuring a BigInt minor-unit ledger, multi-account portfolio reconciliation, period-based budget enforcement, automated recurring transaction scheduling, and interactive Recharts cashflow analytics.
Aksaraya - Digital Library Management
Full-stack digital library management and e-reading platform built with Laravel 13, Tailwind CSS v4, and Alpine.js, combining multi-faceted catalog search, in-browser PDF e-reader progress synchronization, automated circulation lifecycle tracking, barcode scanning, and multi-channel notification alerts.