LearnNewsExamplesServices
Frontmatter
id9255
titleCreate Backend ("Fat Client") Guide for DevIndex
stateClosed
labels
documentationenhancementai
assigneestobiu
createdAtFeb 22, 2026, 6:22 PM
updatedAtFeb 22, 2026, 6:27 PM
githubUrlhttps://github.com/neomjs/neo/issues/9255
authortobiu
commentsCount1
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtFeb 22, 2026, 6:27 PM

Create Backend ("Fat Client") Guide for DevIndex

Closed v12.0.0/archive-v12-0-0-chunk-4 documentationenhancementai
tobiu
tobiu commented on Feb 22, 2026, 6:22 PM

Objective: Replace the dummy "Architecture" guide in the DevIndex data factory learning path with a new "Backend" guide. This guide explains the "Fat Client" twist of the DevIndex application—specifically that it lacks a traditional backend server and instead relies on streaming a static users.jsonl file.

Tasks:

  • Create learn/guides/devindex/Backend.md.
  • Explain the "Fat Client" architecture and the pragmatic reasons for it (FOSS, GitHub Pages hosting limitations).
  • Describe the hyper-optimized NDJSON data format.
  • Explain the streaming architecture using Neo.data.proxy.Stream, ReadableStream, and progressiveChunkSize.
  • Document "Turbo Mode" (autoInitRecords: false) and "Soft Hydration" for memory-efficient sorting/filtering.
  • Detail the zero-overhead virtual fields feature using Neo.data.RecordFactory.
  • Update learn/guides/devindex/tree.json to link the new guide.
tobiu
tobiu Feb 22, 2026, 6:27 PM

Input from Gemini 3 Pro:

✦ I have completed the creation of the Backend.md guide for DevIndex.

Key additions:

  • Explained the "Fat Client" architecture and how the users.jsonl file acts as the backend.
  • Detailed the pragmatic FOSS and GitHub Pages hosting constraints.
  • Documented the streaming architecture using Neo.data.proxy.Stream.
  • Clarified the "Turbo Mode" (autoInitRecords: false) for memory-efficient client-side sorting and filtering.
  • Highlighted the zero-overhead virtual fields feature using Neo.data.RecordFactory.
  • Updated tree.json to link the new guide and replace the "Architecture" dummy.

The changes have been successfully committed and pushed to the remote repository. Closing this issue.