sharp-notes

byDheeraj

# ✅ COMPLETE MASTER PROMPT ### Notion × Apple Notes Hybrid (Text + Handwriting on Same Page) ## 🎯 Product Goal Build a **world-class notes application** that combines **Notion-style inline rich text** with **Apple Notes-style handwriting**, where **text and handwriting coexist on the SAME infinite page**. The app must feel natural on **mobile, iPad, stylus, keyboard, and web**, with no mode confusion. --- ## 🧠 Core Editor Architecture (NON-NEGOTIABLE) ### Single Note = Single Page * Each note is **one continuous, infinite vertical page** * There is **no fixed page height** during editing * The page automatically expands as the user types or writes * Pages exist **ONLY during export or print**, not while editing --- ## ✍️ Text System (Notion-Style) ### Inline Rich Text ONLY * Text must be **inline rich text**, NOT canvas text boxes * Keyboard input should **never create draggable or floating text containers** * Text flows naturally line by line in document order ### Text Features * Paragraphs * Headings (H1–H4) * Bullet lists * Numbered lists * Todo / checkbox lists * Inline formatting: * Bold * Italic * Underline * Strikethrough * Highlight * Markdown shortcuts: * `#` → heading * `-` → bullet list * `1.` → numbered list * `[]` → todo * Slash command menu (`/`) for blocks * Cursor-based formatting (format applies while typing) --- ## ✍️ Handwriting System (Apple Notes-Style) ### Ink Layer * Handwriting is drawn on a **transparent ink layer above text** * Ink is **not text** * Ink is **not in boxes** * Ink supports: * Pencil * Pen * Highlighter * Eraser * Lasso select * Pressure sensitivity (if stylus supports it) * Palm rejection ### Anchoring (VERY IMPORTANT) * Every ink stroke is **anchored to the page and nearby text** * When text reflows, scrolls, zooms, or font size changes: * Ink moves and scales correctly with it * Ink and text must always stay visually aligned --- ## 🧩 Text + Handwriting Relationship * Text and handwriting must appear as **ONE unified page** * User should never feel they are switching editors * Typing → creates text * Writing → creates ink * Both can exist between the same lines * Undo/redo must work across both systems --- ## 📜 Infinite Scroll Logic * The note has **no visible end** * When user reaches the bottom: * New vertical space is automatically added * Infinite scroll applies to: * Text * Ink * Templates * No “Add Page” button * No page numbers during editing --- ## 📄 Paper Templates (IMPORTANT) ### Template Behavior * Templates are **background patterns**, NOT fixed pages * Templates repeat infinitely as the note grows ### Supported Templates (minimum) 1. Blank 2. Ruled / Lined 3. Dotted 4. Grid 5. Cornell Notes 6. Checklist paper 7. Music staff 8. Dark paper ### Rules * Selecting a template does NOT limit page height * Template continues seamlessly while scrolling * Switching templates must NOT break existing text or ink --- ## 🧭 Input-Based Auto Switching (NO MANUAL MODES) | Input | Behavior | | ---------- | ------------- | | Keyboard | Inline typing | | Stylus | Handwriting | | Finger (1) | Scroll | | Finger (2) | Undo | | Finger (3) | Redo | User should never manually switch between text and handwriting modes. --- ## 🧰 Toolbar Rules ### Text Toolbar (when keyboard active) * Bold * Italic * Underline * List * Numbered list * Todo * Heading * Font size * Font family * Text color ### Ink Toolbar (when stylus active) * Pen * Pencil * Highlighter * Eraser * Lasso * Stroke size * Color picker ❌ NO “Create Text Box” button ❌ NO draggable text containers --- ## 📤 Export & Download System (CRITICAL) ### Export Formats * PDF (multi-page, paginated during export) * PNG / JPEG (single page snapshot) * Markdown (text only) * ZIP (entire notebook including ink as SVG/JSON) ### Export Rules * During export: * Infinite page is sliced into A4 / Letter pages * Text + ink are flattened together * Paper templates render correctly per page * During editing: * No page boundaries exist --- ## 🧠 Data Model (High Level) * One note document contains: * Rich text blocks (structured) * Ink strokes (anchored with position metadata) * Text and ink are saved together as part of the same note * Offline-first with sync support --- ## 🛑 What is STRICTLY FORBIDDEN * Canvas text boxes * Draggable text objects * Separate handwriting pages * Fixed page height during editing * Manual “switch to text mode” * Whiteboard-style behavior --- ## 🏁 Success Criteria The app should feel like: > “I’m writing on a real notebook where typing and handwriting just work together.” If the user ever sees: * An orange text boundary * A movable text box * Separate text/handwriting screens ❌ The implementation is WRONG. --- ## ✅ Final One-Line Guarantee > “The editor renders inline rich text and anchored handwriting on the same infinite page, with paper templates repeating seamlessly and page boundaries applied only during export.”