Data Organization

MindSafe allows you to maintain completely different threat profiles or “identities” on a single device. The hierarchical structure is a key security feature. By separating data into isolated “Workbooks.”

MindSafe uses a three-tier organizational structure designed to balance logical flow with strict cryptographic isolation. This ensures that even if one area of your life is compromised, the others remain mathematically secure.

1. The Workbook (The Secure Perimeter)

The Workbook is the highest level of organization. Think of a Workbook as a completely independent “Vault” or “Account.”

• Total Isolation: Each Workbook exists as a separate, unique database file (.db) on your disk. There is no shared data between them.
• Independent Credentials: Every Workbook is protected by its own Master Password and its own unique set of Argon2id-derived encryption keys. You can have a “Work” Workbook with one password and a “Personal” Workbook with an entirely different one.
• Multi-Identity Support: You can create an unlimited number of Workbooks. If you are forced to reveal the password to one Workbook, the data in your other Workbooks remains invisible and inaccessible, as they are not logically linked in the file system.
• Hardware Portability: Because a Workbook is a self-contained encrypted file, you can move a specific Workbook (e.g., finances.db) to a hardware USB drive while keeping your journal.db on your local machine.

2. Notebooks (The Logical Folders)

Inside a single Workbook, you can create multiple Notebooks to categorize your information.

• Categorization: Notebooks act as high-level “Folders” or “Projects” within your secure perimeter.
• Structural Clarity: A Workbook can contain an unlimited number of Notebooks (e.g., “Project Alpha,” “Health Logs,” “Travel Plans”).
• Shared Security Boundary: All Notebooks within a specific Workbook share the same Master Key. Once you unlock the Workbook, you have access to all the Notebooks contained inside it.

3. Notes (The Atomic Data)

The Note is the final layer where your content resides.

• Markdown Support: Notes are written in Markdown, allowing for rich text formatting, lists, and code blocks while maintaining a clean, future-proof file format.
• Per-Note Encryption: As detailed in our Security documentation, every Note is individually encrypted with a unique random nonce. Even though they live within the same Notebook, the cipher text for two identical notes will look completely different.
• Version History: Every Note tracks its own evolution. You can roll back to previous versions of a specific note without affecting the rest of the Notebook or Workbook.

Organizational Summary Table