Cosmic Notes App Documentation

Cosmic Notes Workspace

Cosmic Notes App is a distraction-free, local-first personal knowledge base and markdown editor. Built without heavy frameworks, it utilizes modern web standards (ES6 modules, CSS Custom Properties, and HTML5 Web Storage) to deliver lightning-fast typing, real-time preview, and total privacy.

# Clone the repository
git clone https://github.com/dev-hints/Notes-App.git
cd Notes-App

# Run locally in any web browser
open index.html

State Management Architecture

The application implements an unidirectional event pipeline with automatic debounce saving:

// Unidirectional Event Flow
User Keystroke 
   │
   ▼
[ Editor Input Handler ] ──> Debounced Update (300ms)
   │
   ├───> [ Markdown AST Parser ] ───> [ Live DOM Preview Window ]
   │
   ├───> [ Word / Char Metric Engine ] ───> [ Status Bar Display ]
   │
   └───> [ Storage Vault Manager ] ───> [ Browser LocalStorage ]

Markdown Syntax Specifications

Cosmic Notes supports GitHub Flavored Markdown (GFM) with extended cosmetic syntax:

LocalStorage JSON Schema

Notes are indexed by unique UUID timestamps within the client vault key:

{
  "cosmic_notes_version": "1.5.0",
  "notes": [
    {
      "id": "note_1724241000",
      "title": "Deep Space Theory",
      "content": "# Deep Space Theory\n\nResonance notes...",
      "tags": ["astronomy", "research"],
      "pinned": true,
      "colorTheme": "magenta",
      "createdAt": "2026-08-21T18:00:00Z",
      "updatedAt": "2026-08-21T18:14:00Z"
    }
  ]
}

Keyboard Shortcuts Reference

Backup & Portability

You can download a complete backup of your knowledge base anytime via the Export All JSON action. Restoring your workspace is as simple as uploading your cosmic-notes-backup.json file on any browser or machine.