Merge pull request #6 from TheNotelyApp/export_import

Export import

Author: oksbwn

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Create a report to help us improve Notely
+title: '[Bug] '
+labels: bug
+assignees: ''
+
+---
+
+### Description
+A clear and concise description of what the bug is.
+
+### Steps to Reproduce
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '...'
+3. Scroll down to '...'
+4. See error
+
+### Expected Behavior
+A clear and concise description of what you expected to happen.
+
+### Screenshots / Videos
+If applicable, add screenshots or recordings to help explain your problem.
+
+### System Info
+- App Version:
+- OS Platform:
+- Theme:
+- Browser/Electron Environment:
+
+### Additional Context
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea/enhancement for Notely
+title: '[Enhancement] '
+labels: enhancement
+assignees: ''
+
+---
+
+### Describe the Feature
+A clear and concise description of what the feature is and what problem it solves.
+
+### Proposed Solution
+Describe the solution or behavior you'd like to see.
+
+### Alternative Solutions Considered
+Describe any alternative solutions or features you've considered.
+
+### Additional Context
+Add any other context, mockup screenshots, or design thoughts here.

.github/pull_request_template.md

@@ -0,0 +1,19 @@
+### Description
+Provide a brief summary of the changes made, the goal of this pull request, and any relevant issue links (e.g. `Closes #123`).
+
+### Types of Changes
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to change)
+- [ ] Documentation update
+- [ ] Code refactoring / Styling update
+
+### Checklist
+- [ ] Code compiles and runs locally without errors.
+- [ ] Follows existing style and patterns of the codebase.
+- [ ] Added/updated tests to cover my changes.
+- [ ] All new and existing tests passed.
+- [ ] Documentation updated (if applicable).
+
+### Verification/Screenshots
+Provide verification steps, console output logs, or screenshots/videos of UI changes to demonstrate the fix/feature working.

CHANGELOG.md

@@ -8,7 +8,23 @@ All notable documentation and user-facing behavior changes are tracked in this f
 
 ### Added
 
-- Added `Ctrl+Tab` (next tab) and `Ctrl+Shift+Tab` (previous tab) shortcuts to navigate between open notes.
+- Added **Export / Import Note Package** feature (`File → Export / Import Note Package`).
+  - Exports a selection of notes — including all linked images, Excalidraw diagrams, Draw.io files, screenshots, and thumbnails — into a single encrypted `.note` bundle.
+  - Bundles are AES-256 encrypted and SHA-256 integrity-hashed; tampered files are detected on import.
+  - Import unpacks the bundle into the current workspace, restoring all assets and resolving filename collisions via embedded metadata.
+  - Default export path and filename (`{rootFolder}.note`) are pre-filled from the last-used export location.
+  - Dedicated **Export/Import modal** with a scrollable, compact note-selection list supporting Select All/Deselect All; fixed-height dialog that does not shift when switching between the Export and Import tabs.
+- Added `src/tests/utils/notePackage.test.js` — unit tests covering dependency scanning, path sanitization (leading-slash screenshot paths), crypto, and regex parsing.
+
+### Fixed
+
+- Fixed split-view scroll sync sluggishness and lock-fighting between the raw editor and the preview panel.
+  - Replaced the `activeScrollSource` string-based lock with a generation counter (`lockGen`) and an 80 ms timeout, preventing programmatic `scrollTop` changes from bouncing back into the opposite panel's sync handler.
+- Fixed `.note` export failing with `EPERM: operation not permitted, copyfile` when notes contained screenshots stored as `/media/images/…` paths; leading slashes are now stripped before OS path resolution.
+- Fixed `.note` export `mkdir` crash caused by absolute note file paths being passed to `path.join(stagingDir, absPath)`; paths are now normalised to workspace-relative via `path.relative(notesRoot, absolutePath)`.
+- Fixed destination directory not being created automatically when the user accepts the default export path without browsing.
+
+
 - Added a **Copy Link Path** context menu option to open tabs and landing items to easily copy workspace-relative paths.
 - Added support for custom action buttons (e.g. "Undo") inside notification toasts.
 - Added a **Copy | Navigate** hover popover for links in Markdown Previews, while preventing accidental direct click navigation.

README.md

@@ -67,6 +67,10 @@ Notely is built with Electron + React and is designed for project notes, meeting
 - Copy note link paths relative to the current workspace root from right-click context menus on tabs and dashboard document list items.
 - Dismiss notification toasts immediately with a close button, and undo/redo applied markdown quick fixes or validation suggestions.
 - Hover over links in Markdown Previews to display a transient popover containing Copy Link and Navigate options, while direct clicks on links are prevented to avoid accidental navigation.
+- **Export/Import Note Packages** (`.note` files) via **File → Export / Import Note Package** to share self-contained, encrypted bundles of notes with all linked media, Excalidraw diagrams, Draw.io files, and screenshots.
+  - Bundles are AES-256 encrypted and SHA-256 integrity-checked so recipients can trust authenticity.
+  - A dedicated **Export/Import modal** lets you select which notes to include, pre-fills the save path and filename from your last export location, and handles naming collisions on import automatically.
+  - Importing unpacks directly into the current workspace with full dependency restoration.
 
 ## Getting Started
 
@@ -201,6 +205,14 @@ Planned additions and improvements for upcoming iterations:
 - OCR-assisted alt text suggestions for inserted images.
 - Command palette automation macros for repeated authoring tasks.
 
+## Contributing and Reporting Issues
+
+We welcome feedback, bug reports, and feature requests!
+
+- **In-App Reporting:** Open **Help -> Report Bug / Feedback** (or search in the Command Palette) to access the built-in issue reporting form, which automatically collects system details and opens a pre-populated issue draft on GitHub.
+- **Manual Reports:** Go directly to our [GitHub Issues](https://github.com/TheNotelyApp/Notely/issues) page to open a new issue.
+- **Templates:** Use the pre-configured issue templates (Bug report or Feature request) when submitting reports. When opening a Pull Request, please follow the PR template checklist.
+
 ## License and ownership
 
 This repository is maintained for Notely use.

THIRD_PARTY_NOTICES.txt

@@ -1,10 +1,10 @@
 THIRD-PARTY SOFTWARE NOTICES AND INFORMATION
 
 Notely incorporates components from the projects listed below.
-This file was generated automatically on 2026-07-17 by
+This file was generated automatically on 2026-07-18 by
 scripts/generate-notices.cjs. Do not edit by hand.
 
-Total third-party packages: 390
+Total third-party packages: 392
 
 ================================================================================
 
@@ -9594,6 +9594,37 @@ Apache License
 
 --------------------------------------------------------------------------------
 
+pend@1.2.0
+License: MIT
+Author: Andrew Kelley <superjoe30@gmail.com>
+Homepage: git://github.com/andrewrk/node-pend.git
+
+The MIT License (Expat)
+
+Copyright (c) 2014 Andrew Kelley
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation files
+(the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software,
+and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+--------------------------------------------------------------------------------
+
 perfect-freehand@1.2.0
 License: MIT
 Author: Steve Ruiz
@@ -13058,6 +13089,35 @@ IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 --------------------------------------------------------------------------------
 
+yauzl@3.4.0
+License: MIT
+Author: Josh Wolfe <thejoshwolfe@gmail.com>
+Homepage: https://github.com/thejoshwolfe/yauzl
+
+The MIT License (MIT)
+
+Copyright (c) 2014 Josh Wolfe
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+--------------------------------------------------------------------------------
+
 yazl@3.3.1
 License: MIT
 Author: Josh Wolfe <thejoshwolfe@gmail.com>

docs/export-import.md

@@ -0,0 +1,64 @@
+# Export / Import Note Package
+
+Notely can package one or more notes — together with all their linked assets — into a single portable `.note` file that can be shared with other Notely users and imported directly into any workspace.
+
+## Opening the dialog
+
+Go to **File → Export / Import Note Package** (or use the app menu from the landing screen).
+
+The dialog has two tabs:
+
+| Tab | Purpose |
+|---|---|
+| **Export Package** | Bundle selected notes into a `.note` file |
+| **Import Package** | Unpack a `.note` file into the current workspace |
+
+## Exporting
+
+1. **Select notes** — the list shows every `.md` file in the current workspace. Use **Select All / Deselect All** or click individual rows. The list scrolls when the workspace is large.
+2. **Save location** — defaults to the last-used export path with the filename `{workspaceName}.note`. Click **Browse** to choose a different destination.
+3. **Password (Optional)** — set a password to restrict who can import the package. If set, a salted SHA-256 hash of the password is saved securely inside the encrypted metadata.
+4. Click **Export Package**.
+
+### What gets bundled
+
+| Asset type | Where it lives | Included |
+|---|---|---|
+| Markdown files | anywhere in the workspace | ✅ |
+| Images / screenshots | `media/images/` | ✅ |
+| Excalidraw diagrams | `.notes-app/excali-diagrams/` | ✅ |
+| Draw.io diagrams + thumbnails | `media/draw.io/` | ✅ |
+| Package metadata | `metadata.json` inside bundle | ✅ auto-generated |
+
+Assets that are locked, missing, or inaccessible at export time are silently skipped; the note itself is still exported.
+
+### Security
+
+- The bundle is **AES-256 encrypted** using a shared app-level key so it is not readable by generic ZIP tools.
+- Every file in the bundle is **SHA-256 hashed** and the hashes are stored in `metadata.json`. On import, Notely verifies each hash and rejects tampered packages.
+- If protected by a password, the manifest contains a salted `SHA-256` password signature. Unlocking verification occurs securely in memory during the import sequence before files are written.
+
+## Importing
+
+1. Switch to the **Import Package** tab.
+2. Click **Browse** and pick a `.note` file.
+3. Click **Import Package**.
+4. **Password Prompts**: If the package is password-protected, the app will display a password field. Enter the correct password and click **Import Package** again to proceed.
+
+Notely will:
+
+- Decrypt and verify the integrity of the bundle.
+- Authenticate the password if password protection was configured.
+- Copy notes into the workspace root (or appropriate subfolder).
+- Restore all media assets to their original relative paths.
+- Resolve filename collisions automatically so existing files are never overwritten.
+- Reload the workspace document list so imported notes appear immediately.
+
+## Troubleshooting
+
+| Symptom | Likely cause | Fix |
+|---|---|---|
+| "Export failed: EPERM" | Destination folder is inside an OneDrive-synced path being actively synced | Wait a moment and retry, or choose a local (non-OneDrive) folder |
+| "Import failed: integrity check" | The `.note` file was modified or corrupted in transit | Request a fresh export from the sender |
+| "Incorrect password" or prompt stays | The password supplied does not match the package hash | Confirm the password with the package creator |
+| Notes appear in workspace root instead of a subfolder | Package was exported from a flat workspace | Expected — the import mirrors the original layout |

docs/index.md

@@ -40,4 +40,7 @@ features:
   - icon: 🔄
     title: P2P Sync
     details: Sync notes across devices over your local network using encrypted peer-to-peer pairing — no cloud required.
+  - icon: 📦
+    title: Export / Import Note Packages
+    details: Bundle notes with all linked assets into an encrypted, integrity-checked `.note` file. Share with others and import directly into any Notely workspace.
 ---

electron/lib/core/appMenu.cjs

@@ -98,6 +98,10 @@ function buildAppMenuTemplate(win, context = {}) {
           accelerator: "CmdOrCtrl+Shift+E",
           click: () => sendMenuAction(win, "export-pdf")
         },
+        {
+          label: "Export/Import Note Package",
+          click: () => sendMenuAction(win, "open-export-import")
+        },
         { type: "separator" },
         {
           label: "Rename Note",
@@ -139,6 +143,11 @@ function buildAppMenuTemplate(win, context = {}) {
           submenu: openRecentSubmenu
         },
         { type: "separator" },
+        {
+          label: "Export/Import Note Package",
+          click: () => sendMenuAction(win, "open-export-import")
+        },
+        { type: "separator" },
         {
           label: `Move ${currentFolderLabel} to Removed`,
           accelerator: "CmdOrCtrl+Shift+Delete",
@@ -642,6 +651,11 @@ function buildAppMenuTemplate(win, context = {}) {
           click: () => sendMenuAction(win, "open-shortcuts")
         },
         { type: "separator" },
+        {
+          label: "Report Bug / Feedback",
+          click: () => sendMenuAction(win, "open-feedback")
+        },
+        { type: "separator" },
         {
           label: "Check for Updates",
           click: () => sendMenuAction(win, "check-for-updates")