Unreleased
- Added a standalone terminal Markdown reader (
nero view/nero FILE.md) for files outside Nero workspaces, including stdin support. PressBin the reader to open its browser preview. - Added a styled browser preview (
nero view --browser,nero browse) with optional frontmatter display and source-relative asset paths. - Added TUI
B,:browser, and:view-browseractions to open the selected note in the default browser without entering edit mode.
Maintenance updates
- Centralized user-level state under
~/.neroby default: config, backup keys, local backups, and theworkspaces/container. - Added
NERO_HOMEas an absolute-path override for relocating the complete application home andnero home [show|path]for inspecting active paths. - Reserved
~/.neroas an application-home directory rather than letting workspace discovery mistake its parent for a workspace. - New notes now get
titleanddatefrontmatter automatically; new daily notes also gettype: daily. Added research, task, journal, and math examples with metadata. - Normalized backup destination checks for paths containing
..and made the home-restore path assertion compare canonical paths across operating systems. - Restyled the docs site with Inter typography, a plain white page, a narrower header, and no displayed package-version badge.
- Added passphrase-encrypted full-home backups (
nero backup home create/verify/restore/recovery-test) for machine-to-machine recovery; config paths are rebased during restore. - Added Quick Start instructions for private GitHub version history and rclone-backed Mega backups.
Maintenance notes
- Added a configurable workspace home (default
~/.nero/workspaces) andnero workspace create <name>so new workspaces stay organized beneath one parent. - Added date-only
due: YYYY-MM-DDfrontmatter surfaced bynero today, with overdue items labeled and no separate task database. - Reworked the root README around real features, installation, a short quick start, common commands, and links to the documentation set.
- Added persistent user-level workspace configuration: set a default once, register named workspaces, switch defaults, and use
-w/--workspacefor one-command overrides. - Added regression coverage for workspace selection and due-date behavior, plus smoke coverage for commands run outside the workspace directory.
- Added
eand:editto the TUI; they release the terminal to$EDITOR, restore the TUI afterward, and reload the edited note. - Documented the npm-first Tauri CLI setup and added
tauri:dev,tauri:build, andtauri:infoscripts. - Fixed the smoke-test frontmatter writer and pointed encrypted remote-restore coverage at the actual
identity.txtkey path.
Initial release build and test fixes
Build/test fixes applied after the first user Cargo run:
Fixed TUI
Appinitialization to initialize its parseddocumentstate.Clear the current document and selected path when a search returns no matches; removed a stale reference to the deleted
bodyfield.Removed an unused Ratatui
Positionimport.Stream ZIP archives so encrypted backup output only needs
Write, notSeek.Index the string target of each structured
WikiLinkrather than binding the struct itself to SQLite.Convert a note’s relative path to the string query expected by
read_noteduringnero doctor, with a regression test for nested notes.Updated the TUI Markdown renderer test to parse its source into a
Documentbefore rendering.Corrected remote backup pull to call the static
Workspace::restore_*functions using associated-function syntax.Documentation is consolidated under
docs/, with dedicated usage, Markdown-format, development, GUI, security, recovery, backup, storage, CI, roadmap, and changelog guides.Source files include focused comments around filesystem boundaries, atomic writes, encryption, backup safety, indexing, Git argument validation, and Tauri/core boundaries.
This is the first stable Nero release. The final hardening pass tightened workspace boundaries, save/recovery safety, search/index reliability, and GUI rendering consistency.
Refused absolute/path-traversal note lookups and symlinked notes; indexing no longer follows workspace symlinks.
Note saves, new notes, daily notes, backup snapshots, encrypted backups, and backup identity files now use safer temporary-file replacement paths.
Local daily notes now use the machine’s local calendar date instead of UTC.
Search snippets handle Unicode case-folding without slicing invalid UTF-8 boundaries.
SQLite indexing now has a schema version, WAL mode, normal synchronous mode, and a busy timeout.
GUI split preview now uses the same Comrak renderer as normal reading mode.
Markdown rendering explicitly remains safe for raw HTML and dangerous links before content reaches the WebView.
Encrypted backup detection now inspects the age header instead of trusting the filename extension; encrypted recovery uses OS-managed temporary files.
Git branch arguments are rejected when they look like command-line options or contain whitespace.
Storage configuration writes now use the same atomic file replacement path as notes and keys.
Workspace filename/path lookup now respects native filesystem case semantics while keeping title matching friendly.
Heading fragments in
[[Note#Heading]]links now navigate to the matching heading in the desktop reader.The Rust toolchain is pinned to 1.90.0 and Node development to 24 for consistent local/CI environments.
Added Comrak-powered Markdown rendering with math support.
Added
[[wiki links]], backlinks, SQLite FTS5 search, file watching, and the Ratatui TUI.Added the Tauri desktop GUI with Markdown editing, split preview, KaTeX, image import, and context navigation.
Added portable ZIP backups with manifests, SHA-256 verification, safe restore, and recovery tests.
Added age-compatible X25519 encrypted backups and external key storage.
Added Git helpers for versioning, remotes, snapshots, push, and pull.
Added rclone-backed remote backup storage with named storage profiles.
Added GitHub Actions CI and tag-driven cross-platform release automation.
0.9.0
- Added age-compatible X25519 encrypted backup snapshots.
- Added
nero key generate,key show, andkey path. - Added streamed encrypted backup creation so ZIP plaintext is not loaded into memory.
- Added encrypted backup verification, restore, and
recovery-test. - Added Git helpers for init, status, snapshots, remotes, push, and pull.
- Added an explicit recovery guide and expanded the security model.
- Kept the private backup identity outside the workspace by default.
0.8.0
- Audited and hardened the core before adding remote storage features.
- Added portable local ZIP backups with a JSON manifest.
- Added SHA-256 integrity hashes for every backed-up file.
- Added backup inspection and verification.
- Added safe restore into a new or empty destination, with archive path traversal protection.
- Excluded
.nero/and.git/from backups. - Rejects symlinks in backup sources instead of following them outside the workspace.
- Streams file hashing instead of loading large assets into memory.
- Fixed Unicode-unsafe search preview slicing.
- Fixed image reference cleanup when Markdown image URLs contain fragments or query strings.
- Removed the placeholder GitHub repository URL from package metadata.
- Documented the planned age encryption and Git/rclone storage architecture.
0.7.0
- Added syntax-aware Markdown highlighting behind the real source textarea.
- Added synchronized source/preview scrolling in split mode.
- Added smart Enter behavior for unordered lists, ordered lists, tasks, and blockquotes.
- Added selection preservation across editor mode changes and saves.
- Added native image import through the Tauri dialog plugin.
- Added safe workspace image hydration and local image rendering in previews.
0.6.0
- Added embedded Markdown source editing to the desktop GUI.
- Added read, edit, and split source/preview modes.
- Added explicit save through the Rust document core.
- Added dirty-state protection and external-change handling.
- Added line numbers, Tab indentation, and simple bold/italic shortcuts.
- Added live preview for common Markdown while editing.
- Added
:edit,:save, and:splitcommands to the command palette.
0.5.0
- Added the first desktop GUI under
gui/. - Added a Tauri 2 shell backed directly by
nero-core. - Added native commands for note listing, reading, searching, backlinks, link resolution, note creation, daily notes, and reindexing.
- Added live Markdown change events from the Rust watcher to the frontend.
- Added a restrained three-column reading layout with notes, reader, and context/backlinks panes.
- Added a command/search palette.
- Added KaTeX rendering for Comrak’s annotated math nodes.
- Kept the GUI dependency-light: vanilla TypeScript/CSS, no frontend framework.
0.4.0
- Formalized the core
Documentmodel around the original Markdown source. - Added structured
WikiLinkmetadata with optional display labels. - Made internal-link resolution relative to the source note, then workspace path, title, and filename stem.
- Backlinks now resolve against current workspace identity instead of relying on cached string aliases.
- TUI Markdown rendering now consumes the core document model.
0.3.0
- Reworked
nero-tuiinto a full reading/navigation interface. - Added a keyboard-first command palette.
- Added backlinks, recent-note, and context side panels.
- Added live Markdown-file reload and index refresh.
- Added scrolling and page navigation for long notes.
- Added terminal Markdown presentation with task/list/heading/link styling.
- Added lightweight Unicode rendering for common LaTeX constructs in display math.
- Wired
nero tuidirectly to the TUI crate.
0.2.0
Nero’s document engine milestone.
- Added Comrak-backed Markdown and math rendering
- Added lightweight frontmatter extraction
- Added wiki-link and task metadata extraction
- Added SQLite FTS5 indexing
- Added incremental index refreshes
- Added indexed backlink lookup
- Added cross-platform Markdown file watching
- Added
render,reindex, andwatchcommands - Added the first Ratatui TUI reader shell
- Workspace-local application metadata lives under
.nero/.
Post-test build fixes
- Added the Tauri app icon source and generated PNG/ICO/ICNS variants required by development and desktop bundle builds.
- Declared the bundle icon set explicitly in
gui/src-tauri/tauri.conf.json. - Removed an unreachable
returnwarning in the non-mobile GUI startup error path while preserving the mobile return path.