EasyEditor Manual

Complete reference for the EasyEditor Markdown ecosystem — including Tauri native desktop configs, cloud note synchronization, Git operations, and EasyAI persona writing agents.

Tauri & Web EasyGit Sync 8 AI Personas

Overview

EasyEditor is an advanced real-time Markdown editor tailored for professionals, technical writers, and software developers. With support for over 130+ features, it bridges the gap between quick note-taking, rich schema diagrams, and project-level code documentation.

Modern Editor

Live side-by-side Markdown render, Mermaid diagrams, PlantUML syntax, and KaTeX mathematical notation.

EasyNotes Sync

Cloud-connected drafts sidepanel supporting Google Drive, Dropbox, Box, and OneDrive with AES-256 encryption.

EasyAI Agents

Built-in AI personas that act as product analysts, diagram builders, code editors, or professional copywriters.

EasyGit Control

Direct Git GUI integration allowing developers to Clone, Stage, Commit, and Push changes from the editor toolbar.

Getting Started

EasyEditor fits into any environment, whether you want an offline desktop application, a cloud-connected web editor, or a light Docker instance.

1

Desktop Application (Tauri - Recommended)

Download the pre-compiled installer for your operating system. Tauri makes the application compile directly to machine code, using only ~20MB of RAM without the bloat of Chrome dependencies.

2

Docker Container

Spin up containerized instances instantly for your local team. Pull the official image from GitHub Container Registry: docker pull ghcr.io/gcclinux/easyeditor:latest and run with: docker run -d --name EASYEDITOR -p 3024:3024 --env-file .env.local ghcr.io/gcclinux/easyeditor:latest

3

Online Cloud App

Access the editor directly with zero install at easyeditor-cloud.web.app using any modern web browser.

Build from Source

For developers looking to extend features, add custom layouts, or build custom Tauri configurations.

Repository: https://github.com/gcclinux/easyeditor.git
1

Clone and Install Dependencies

Ensure Node.js (v18+) is installed, then run: git clone https://github.com/gcclinux/easyeditor.git && cd easyeditor && npm install

2

Run Local Server

For standard web access, spin up the dev server: npm run server (runs on http://localhost:3024)

3

Run Tauri Desktop Mode

Ensure Rust and the build workloads are installed on your OS, then boot the Tauri development environment: npm run app

The Four Pillars

The EasyEditor ecosystem splits key operations into distinct tools that function seamlessly within a unified interface.

Pillar 1: EasyEditor (The Foundation)

Core Writing Workspace

Handles the live compilation of Markdown markup, applying custom themes (light/dark/minimalist), and compiling inline mathematics or diagram structures using GFM rules.

Pillar 2: EasyNotes (The Bridge)

Cloud Sync & Draft Management

Keeps drafts stored in an offline-first cache on your local device. Provides options to map your document directory to remote cloud services (Google Drive, Dropbox, Box) with automated conflict resolution.

Pillar 3: EasyAI (The Accelerator)

Contextual AI Assistant

An interactive helper pane driven by dedicated AI personas. By reading active workspace files, it generates diagrams, fixes code errors, and rewrites copy without leaving your editing flow.

Pillar 4: EasyGit (The Backbone)

Native Workspace Versioning

An in-app Git wrapper. Users can stage, commit, and push updates directly to GitHub/GitLab, keeping documentation closely coupled with active development codebases.

Ecosystem Workflow

The typical workflow starts from a simple draft idea and finishes with a version-controlled production document deployed to static hosting.

1

Initiation (Drafting)

Open a document based on one of the library templates (e.g. AWS Multi-Region architecture, study logs, Daily Journals). Save it to EasyNotes to guarantee real-time cloud backup.

2

Augmentation (AI Support)

Select sections of your text and use EasyAI personas. Request code bug checking, rewrite sections to meet formal guidelines, or generate Mermaid flowchart structures.

3

Collaboration (Versioning)

Stage, commit, and push the documents directly into your project's repository using EasyGit, maintaining code and manual files side-by-side.

4

Finalization (Deployment)

Export the formatted manual to PDF or HTML, or let your CI pipeline automatically sync it with corporate knowledge bases (like Spotify Backstage or GitLab Wiki).

Transfer MD

Copy Markdown files between your local filesystem and cloud providers (such as Google Drive, Dropbox, Box, or OneDrive)—or even directly between two cloud providers—using the Transfer MD feature in EasyEditor.

1

Step 1: Open the Transfer MD Modal

In the top toolbar, click the Extra button (represented by the magic sparkles ✨ icon). In the modal that pops up, click on Transfer MD ("Copy MD files between local and cloud").

2

Step 2: Choose Your Source and Target

The Transfer MD window has two sections:

  • Source (Left Side): Select Local Folder to open a directory picker and choose a folder on your computer, OR select a connected cloud provider (Google Drive, Dropbox, OneDrive, or Box).
  • Target (Right Side): Select Local Folder to pick a destination folder on your machine, OR select your target cloud provider (Google Drive, Dropbox, etc.).
Note: To transfer to/from a cloud service, ensure that provider is connected/authenticated in EasyEditor.
3

Step 3: Start the Transfer

Click the Start Transfer button at the bottom right. EasyEditor will process the files and display real-time progress.

Key Features of Transfer MD

Feature

Smart Skip

Uses SHA-256 checksums and file size validation to skip files that already exist identically at the target location.

Feature

Safe Renaming

If a file with the same name exists but has different content, EasyEditor renames the incoming file with a timestamp (e.g., filename_2026-07-27_123456.md) to prevent accidental overwrites.

Feature

Summary Report

Shows a detailed breakdown of uploaded, skipped, renamed, and any errored files once complete.

Document Import (MD, Word & PDF)

Convert external Markdown URLs, Microsoft Word (.docx) documents, and PDF files (.pdf) directly into GFM-compliant Markdown using the Extra utilities menu.

Quick Access: Click the Extra button (represented by the magic sparkles ✨ icon) in the top toolbar to access all document import features.

Available Import Methods

Import Type 1

Import MD (Remote Markdown URL)

Fetch raw Markdown directly from any public web address or raw GitHub repository URL into your active editor canvas.

How to use:
  1. Click Extra ✨ → Import MD in the top toolbar.
  2. Enter the document's HTTP or HTTPS web URL (e.g., https://raw.githubusercontent.com/.../README.md).
  3. Click Import or press Enter to load the text into the editor workspace.
Import Type 2

Import Docx (Microsoft Word to Markdown)

Convert .docx documents into structured Markdown markup with automatic table formatting and embedded image blob handling.

How to use:
  1. Click Extra ✨ → Import Docx in the top toolbar.
  2. Select a .docx file from your computer using the native file picker.
  3. EasyEditor parses headers, paragraphs, lists, bold/italic inline text, and tables into clean GFM Markdown.
Import Type 3

Import PDF (PDF Document to Markdown with OCR)

Convert .pdf documents into formatted Markdown using positional font analysis and automatic OCR fallback for scanned pages.

How to use:
  1. Click Extra ✨ → Import PDF in the top toolbar.
  2. Select a .pdf file using the file browser dialog.
  3. EasyEditor extracts font hierarchy, headings, and lists. For scanned or image-based PDFs, built-in Optical Character Recognition (OCR) automatically extracts readable text.
Performance Note: Multi-page PDFs (>200 pages) or large image-heavy Word files process in the background with progress toasts to ensure the UI stays smooth and responsive.

EasyNotes & Multi-Library Cloud Integration

EasyNotes is your central document management hub. Configure multiple offline Local Libraries, connect your preferred cloud storage accounts (Google Drive, Dropbox, Box, and OneDrive), seamlessly switch between views, and organize notes across physical folders and cloud vaults.

Quick Access: Click the EasyNotes button (represented by the sticky note 📝 icon) in the top toolbar to open the sidebar.

Supported Storage Destinations

Local Libraries

Link one or multiple local folders directly on disk. Reads & saves real .md files instantly (Tauri Desktop & Web File System Access API).

Google Drive

Sync notes directly to your Google Drive App Folder with automated OAuth token handling.

Dropbox

Store Markdown notes securely in your dedicated Dropbox application directory.

Box

Enterprise cloud note synchronization integrated directly with Box Storage.

OneDrive

Sync documents seamlessly with Microsoft OneDrive using MSAL / OAuth authentication.

1. Configuring Local Libraries (Multi-Folder Linkage)

EasyEditor allows you to attach multiple distinct local folders (e.g., Personal Notes, Work Vault, Samba Share) as persistent Local Libraries.

1

Click "+ Add Library" or "New Library"

In the EasyNotes sidebar under the Local Libraries section, click + Add Library (or the 📁 New Library button) to launch the setup modal.

2

Enter Custom Library Name & Pick Folder

Enter an optional custom display name for your library (or leave blank to automatically use the folder name), then click Select Folder.

3

One-Time Authorization & Disk Sync

In desktop mode (Tauri), filesystem access is immediate. In browser mode, EasyEditor utilizes the Web File System Access API (showDirectoryPicker) to request one-time read/write access. Writable handles are cached securely in IndexedDB so notes save directly to real physical .md files on disk.

Empty Folders Supported: You can link fresh, empty directories as a Local Library. EasyEditor registers the empty library immediately in your sidebar and dropdowns, ready for your first note.

2. Switching Views: Cloud vs. Local & Provider Filter Pills

Top Section Toggle

Section Switcher (Both / Cloud Only / Local Only)

Use the three icon buttons at the top right of the EasyNotes sidebar header to toggle your workspace view:

  • ☁️📁 Both (All): Displays all connected cloud accounts and all configured local libraries simultaneously.
  • ☁️ Cloud Only: Filters out local libraries and displays connected cloud services (Google Drive, Dropbox, Box, OneDrive).
  • 📁 Local Only: Filters out cloud accounts and displays your active local library folders.
Filter Pills

Individual Provider & Library Pills

Under the Notes list header, quick filter pills allow you to filter documents with a single click. Every local library (e.g., 📁 Samba, 📁 Coding) gets its own pill alongside cloud providers (📋 All, ☁️ Google Drive, etc.). Each note item in the list clearly displays its exact source library attribution (e.g. Coding • 2KB or Google Drive • 5KB).

3. Creating New Notes in a Specific Cloud or Local Library

1

Click "+ New Note"

Click the + New Note button in the sidebar actions section to bring up the Create New Note dialog.

2

Enter Note Title

Type a descriptive title for your document (e.g., Meeting Notes or Project Proposal).

3

Select Target Library / Cloud Destination

In the Cloud Provider / Destination dropdown menu, choose the target location where the note should reside:

  • Select a connected cloud account (e.g., ☁️ Google Drive, ☁️ Dropbox) to store it in the cloud.
  • Select a specific local library folder (e.g., 📁 Personal Notes, 📁 EMPTY) to save it directly into that local directory on disk.
4

Click Create

Click Create or press Enter. EasyEditor creates the Markdown file at the target destination, updates note metadata, and loads the new document directly into your editor.

4. Opening, Saving & Exporting Documents

Opening Notes

Open a Library or Cloud Document

Click any note item in the sidebar list. EasyEditor loads the content from its local folder or cloud origin into the editor canvas and displays an active context badge in the top bar.

Direct Saving

File → Save (Ctrl+S)

Pressing Ctrl+S or clicking File → Save writes all updates back to the document's original destination—whether that is a physical Local Library folder on disk or a connected cloud drive.

Save As Destination

File → Save As

Select File → Save As to change the document's target location. Choose any connected cloud provider or specific Local Library folder, enter a note title, and immediately set your editor context to the newly created location.

Export Option

Exports → Save to Cloud / Local

Export your current document to a target cloud account or local folder without modifying your current active workspace context.

Offline-First Resilience: All note metadata and web library contents are backed up in an IndexedDB cache (`EasyEditorDB`). If network connection is interrupted, offline editing remains fully operational.

Language Selection & Custom Localization

EasyEditor features full internationalization (i18n) support. Switch between built-in languages, download the English translation template, or translate and import custom languages into your workspace.

Quick Access: Navigate to File → Languages → Select Language in the top menu bar to open the Language Selector window.

Language Features

Feature 1

Selecting Built-in Languages

Choose from pre-packaged translations (English, German, Spanish, Portuguese-Brazil, Polish, Dutch, and more). Clicking any language card immediately updates all editor menus, toolbars, dialogs, tooltips, and system toasts into that language.

Feature 2

Downloading the English Template

Want to translate EasyEditor into your native language? Click the Template badge (download icon) on the English language card inside the selector modal. This downloads easyeditor_template_en.json—the authoritative master translation schema containing all string keys.

Feature 3

Creating & Importing Custom Languages

Users can translate the downloaded English JSON template into any language and import it into EasyEditor without waiting for software releases.

Step-by-Step Custom Language Setup:
  1. Open the downloaded easyeditor_template_en.json file in any text editor or code tool.
  2. Translate the string values into your target language, keeping key names unchanged.
  3. In EasyEditor, go to File → Languages → Select Language and click the + Import Language button.
  4. Fill in the Language Code (e.g. fr for French, it for Italian), enter the Display Name (e.g. Français), and paste your translated JSON content into the text area.
  5. Click Import Language. EasyEditor validates the JSON, registers your new language, and activates it immediately.
Persistent Localizations: Imported custom languages are saved to application local storage and remain available across browser refreshes and application restarts.

Encrypted Documents (.sstp)

Protect sensitive notes and private Markdown files using EasyEditor's native .sstp (Secure Text Package) encrypted document format powered by AES-256-CBC encryption.

Password Security: Passwords must be at least 8 characters long. EasyEditor uses client-side zero-knowledge encryption—passwords are never stored on any server. If you lose your password, the encrypted document cannot be recovered.

Opening & Exporting Encrypted Files

Menu Action 1

File → Open Encrypted .sstp file

Open and decrypt an existing .sstp secure package back into editable Markdown text.

How to Open:
  1. In the top menu, select File → Open Encrypted .sstp file (or click Open & Save → Open Encrypted).
  2. Select your .sstp file from the system file picker dialog.
  3. When the password prompt appears, enter the password used during encryption.
  4. Click Decrypt (or press Enter). EasyEditor decrypts the binary payload and loads the GFM Markdown directly into the canvas.
Menu Action 2

Exports → Export Encrypted .sstp file

Encrypt your active editor document into a password-protected binary .sstp file.

How to Export:
  1. With a document open in the editor, navigate to Exports → Export Encrypted .sstp file (or File → Open & Save → Save Encrypted).
  2. Enter a strong encryption passphrase (minimum 8 characters) in the password prompt.
  3. Confirm the password. EasyEditor encrypts the active text using AES-256-CBC with PBKDF2 key derivation.
  4. Save the generated .sstp file to your local computer or cloud drive.

Technical Security Specifications

Crypto Architecture

AES-256-CBC + PBKDF2 Encryption

Each .sstp file starts with a magic header signature (SSTP02), followed by a 128-bit random salt, a 128-bit initialization vector (IV), and the AES-256-CBC encrypted payload. Encryption keys are derived using PBKDF2 with 10,000 iterations to prevent brute-force attacks. Full backward compatibility is maintained for legacy DES-ECB files.

Workspace View Modes (Split View, Edit & Preview)

Customize your editing environment by toggling between side-by-side editing, full-screen code focus, and full-screen styled preview directly from the main top menu bar.

Quick Access: Click the View Mode toggle button (represented by the exchange arrows ⇄ icon and displaying Split View, Edit Mode, or Preview Mode) directly on the main top menu bar.

The 3 View Modes Explained

View Mode 1

Split View (Side-by-Side)

The default side-by-side layout. Displays the raw Markdown editor canvas on the left and the live rendered HTML preview pane on the right. Any keystroke in the editor instantly updates the styled preview.

View Mode 2

Edit Mode (Full Editor Focus)

Maximizes the Markdown text editor canvas to 100% full width, completely hiding the HTML preview pane. Ideal when writing long-form prose, complex code blocks, or when editing on smaller screens.

View Mode 3

Preview Mode (Full Document Reader)

Maximizes the live rendered GFM HTML preview pane to 100% full width, hiding the raw editor canvas. Perfect for reading finished documents, reviewing rendered diagrams/tables, or presenting formatted notes cleanly.

How to Switch View Modes

Cyclic View Mode Button

Clicking the View Mode button on the main menu bar cycles continuously through all three modes in order:
Split View → Edit Mode → Preview Mode → Split View

Theme Selection & Custom Styling

Personalize EasyEditor's appearance with built-in color schemes, or download the master CSS theme template to build, import, and share your own custom themes.

Quick Access: Select File → Select Theme (or click File → Open & Save → Select Theme) in the top menu to open the Theme Selector window.

Theme Options & Capabilities

Feature 1

Selecting Built-in Themes

Choose from standard curated themes: Default (purple/gray dark mode), Ocean Blue, Sunset Orange, Jade Green, Dark High Contrast, or Black & White (clean 3px borders). Selecting a theme immediately updates the active palette across the editor, menus, preview, and modals.

Feature 2

Downloading the CSS Theme Template

To design your own color theme, click the Template badge (download icon) on the Default theme card inside the Theme Selector window. This downloads easyeditor_template_theme.css containing all master :root CSS variables (backgrounds, text, accents, card borders, and font definitions).

Feature 3

Creating & Importing Custom CSS Themes

Users can build custom themes by tweaking CSS variables and importing them into EasyEditor with zero build configuration.

Step-by-Step Custom Theme Setup:
  1. Open the downloaded easyeditor_template_theme.css file in any code or text editor.
  2. Modify color variables (such as --bg-primary, --text-primary, --primary, --card-bg, --card-border).
  3. In EasyEditor, open File → Select Theme and click the + Import Theme button.
  4. Either click Upload CSS File to select your .css file, or enter a Theme Name, description, and paste your CSS code.
  5. Click Import Theme. EasyEditor validates the CSS variables, registers your theme, adds a customizable card to the modal, and activates it instantly.
Theme Management: Custom themes are stored locally in app memory. You can delete any user-created theme anytime using the trash bin icon on its theme card.

Templates & Insert Library Reference

EasyEditor provides an extensive set of built-in templates, formatting options, diagram generators, tables, footnotes, and math/symbol palettes to accelerate your documentation workflow.

1. Headers & Formatting Options

Headers (H1 - H6)

Insert markdown headings from Level 1 to 6:
# Heading 1 ... ###### Heading 6

Text Formatting

Bold (**text**), Italic (*text*), Strikethrough (~~text~~), Highlight (==text==).

Code & Quotes

Inline code (`code`), fenced code blocks with syntax highlighting (```js ... ```), and blockquotes (> Quote).

Lists & Tasks

Bulleted lists (- Item), numbered lists (1. Item), and interactive checkable task lists (- [ ] Task).

2. Insert Elements, Callouts & Images

Insert Options

Divider, Timestamp, Page Break & Links

Insert horizontal rules (---), date/timestamp markers (e.g. 2026-07-27 10:00:00), print page breaks (<div style="page-break-after: always;"></div>), and hyperlinks ([label](url)).

Alert Callouts

GitHub-Style Alert Callouts

Rich styled callouts: > [!NOTE] (Blue), > [!TIP] (Green), > [!IMPORTANT] (Purple), > [!WARNING] (Yellow/Orange), and > [!CAUTION] (Red).

Images & Captions

Images & Base64 Embedding

Insert standard web image links (![Alt](url)), embed local images as Base64 data strings for standalone offline files, or add styled image captions and center alignment wrappers.

3. Tables & Footnotes

Table Generator

Interactive Table Modal & Markdown Tables

Use the Table Generator dialog to specify grid dimensions (rows & columns). Generates clean GFM tables with column alignment headers (e.g., | Header 1 | Header 2 |).

Footnotes

Footnote References & Definitions

Insert inline footnote references like [^1] or [^note], and define the bottom reference anywhere in your document using [^1]: Detailed footnote description.

4. Document Templates Library

Access pre-built Markdown document layouts via Insert → Templates (or toolbar copy template icon):

Daily Journal

Structured daily log with mood tracker, key priorities, gratitude journal, and habit check-ins.

Meeting Notes

Agenda breakdown, attendee list, discussion items, decision log, and actionable task assignments.

Project Plan

Milestone timelines, scope overview, deliverable tables, risks & mitigations, and resource matrix.

Study Notes

Cornell note-taking structure with key concepts, main summaries, and review questions.

Travel Log

Itinerary planning, daily activity logs, budget tracking, location bookmarks, and packing checklist.

Workout Log

Fitness tracking with sets, reps, weights, cardio duration, and recovery notes.

Bug Report

Software defect report template with environment info, steps to reproduce, expected vs actual behavior, and severity.

ASCII Architecture Diagram

Structured text-based ASCII box architecture diagram for terminal and plain text documentation.

AWS Multi-Region Postgres

Cloud infrastructure architecture template for multi-region database replication on AWS.

DevOps Patching Runbook

Production server patching runbook with pre-checks, execution steps, verification, and rollback plans.

KaTeX Math Formula Guide

Comprehensive mathematical formulas, calculus equations, matrices, and LaTeX examples.

Jira / User Stories

Jira Feature Story, Jira Design Story, and Generic Agile User Story templates with acceptance criteria.

5. Mermaid & UML Diagram Templates

Diagram Suite

Mermaid & PlantUML Diagram Types

EasyEditor renders interactive live diagrams directly in the preview pane. Supported diagram types include:

  • Flowcharts: Top-down (graph TD) and Left-to-Right (flowchart LR) process flows.
  • Sequence Diagrams: Message exchange flows between system components (sequenceDiagram).
  • Class Diagrams: Object-oriented class structures, attributes, and inheritance (classDiagram).
  • Gantt Charts: Project timeline schedules and task dependencies (gantt).
  • ER Diagrams: Database entity-relationship models (erDiagram).
  • User Journey: User experience path mapping (journey).
  • Git Graph: Branching and commit history visualizer (gitGraph).
  • Kanban & Timeline: Mermaid Kanban board and event timeline diagrams.
  • Advanced UML: Database Replication, LLM Model Training Pipeline, and Process of Elimination UML templates.

6. Tasks, Symbols & Icon Library

Task Manager

Interactive Task Builder modal allowing you to organize items with priority tags, categories, and checkboxes (- [ ] / - [x]).

Symbols & KaTeX Math

Insert Greek letters (α, β, γ, π), math operators (±, ∞, ∑, ∫, √), currency ($), and directional arrows (→, ←).

Emoji & Icon Palette

Built-in Emoji picker and UI icons to add visual emphasis to headers, callouts, and lists.

EasyGit Version Control

EasyGit is an integrated version control tool inside EasyEditor. Perform complete Git workflows—cloning, staging, committing, pushing, pulling, and branch tracking—without leaving your writing environment.

Quick Access: Click the Git button (represented by the branch icon) in the top toolbar to open the EasyGit Control Panel.

Core EasyGit Capabilities

1. Repository Management

Repository Action

Clone Repository

Clone remote Git repositories directly from GitHub, GitLab, Bitbucket, or custom servers by entering the HTTPS clone URL and target local workspace folder.

Repository Action

Open Repository

Open a local folder containing a .git repository. In web browsers, this triggers the File System Access API to grant directory-wide read/write permissions for native versioning.

Repository Action

Initialize Repository (git init)

Turn any untracked local document directory into a brand new local Git repository with a single click.

Repository Action

View Commit History

Inspect a visual chronological log of all workspace commits, including commit messages, author signatures, commit hashes, and timestamps.

2. Sync & Changes Workflow

Sync Action

Save & Stage (git add)

Save your active document and immediately stage it to the Git index for the upcoming commit.

Sync Action

Commit Changes

Open the commit modal to review staged files, write a structured commit message, and record a new commit snapshot.

Sync Action

Push & Pull

Push: Upload your local commits to remote origin branches.
Pull: Fetch and merge latest remote commits into your active local workspace.

Shortcut

One-Click Save, Commit & Push

A streamlined single-click shortcut that saves your active document, stages all changes, prompts for a commit message, and pushes to remote in one automated step.

3. Authentication & Credentials

Security

Setup / Clear Credentials

Securely save your Personal Access Tokens (PAT) or username/password for GitHub or GitLab authentication. You can clear saved tokens anytime with Clear Credentials.

Dual-Engine Architecture: In browser mode, EasyGit uses isomorphic-git over web APIs; in Tauri desktop mode, it utilizes native OS Git binaries for lightning-fast execution.

Browser Security & Git Integration

When running EasyEditor in a web browser, sandboxing rules place constraints on filesystem read operations.

Single File Access Constraint: When clicking File → Open Markdown, the browser's File System Access API only grants permission to read that individual file. The editor cannot scan parent folders to identify the presence of a .git repository directory.

How to Enable Browser Git Support

Instead of choosing an individual file, click File → Open Repository in your browser (supported in Chrome, Edge, and Opera). Select the folder containing your .git directory. When prompted, click "Allow" or "View files". EasyEditor will scan the root, list all workspace files, and activate all Git operations natively.

Web vs Desktop Features

Choose the correct application target depending on how heavily you use native file access or Git configurations.

Feature Electron / Tauri Desktop Web App (Open Repository) Web App (Open File)
File Editing ✅ Yes ✅ Yes ✅ Yes
Ctrl+S Saving ✅ Yes (Direct) ✅ Yes (API) ✅ Yes (API)
Git Repository Detection ✅ Automatic ✅ Yes (On Folder Open) ✅ Yes
Commit & Push GUI ✅ Yes ✅ Yes ✅ Yes
Direct OS Access ✅ Yes (Unrestricted) ⚠️ Sandbox Prompts ✅ Yes
Offline-first Mode ✅ Yes ✅ Yes (Service Worker) ✅ Yes (Service Worker)

EasyAI Writing Personas

EasyAI works by executing one of 8 target personas, translating instructions to precise output formats.

Button Persona & Goal Output Constraints Primary Source
📝 Markdown Markdown Specialist. Generates pure structured CommonMark. No HTML tags, no diagrams. Prompt Input
🔀 Mermaid Mermaid Architect. Renders graphs, flowcharts, sequence diagrams. Valid ```mermaid fenced blocks. Prompt Input
📋 User Story Agile Product Analyst. Produces standard Epic/Backlog formats. "As a... I want... So that..." + numbered stories. Prompt Input
📐 ASCII Diagram ASCII Designer. Generates terminal-safe visual schemas. Monospace characters only, max 80-cols. Prompt Input
🏗️ PlantUML PlantUML Specialist. Generates UML architecture definitions. Starts with @startuml, ends with @enduml. Prompt Input
📊 MD Table Table Builder. Outputs clean pipe-delimited data matrices. GFM alignment syntax (`:---`, `---:`). Prompt Input
🔧 Fix Code Code review agent. Pinpoints logic flaws and resolves warnings. Tagged blocks + numbered bug explanations. Editor File
✍️ Rewrite Copywriter. Adjusts prose tone, styling, or documentation length. Replaces original buffer content entirely. Editor File
Context vs Input: The first 6 personas use your prompt as the main instruction and treat editor content as background context. **Fix Code** and **Rewrite** are the opposite — they treat your editor content as the main input and use your prompt for direction.

EasyTeam — Encrypted Team Chat

EasyTeam is a privacy-first, ephemeral team communication feature. Two users can communicate in real time through a shared 6-character key. Messages are encrypted client-side using AES-256-CBC, and all data is permanently destroyed when the session ends.

How It Works

1

Create a Team

Click EasyTeam in the navigation bar, then click Create Team. A unique 6-character alphanumeric key is generated.

2

Share the Key

Share the key with your partner via any external channel. Use the Copy button for convenience.

3

Join & Chat

Your partner enters the key and clicks Join. The session becomes active immediately with real-time encrypted messaging and full Markdown support.

4

Insert to Editor

Click the Insert button on any received message to append its raw Markdown content directly into the editor panel.

5

End Session

Click End Chat to disconnect. When both participants leave, all data (messages, metadata, presence) is permanently deleted from the server.

Privacy by Design: Messages are encrypted on your device before transmission. The server only ever stores ciphertext. Rooms that go unused for 10 minutes are automatically cleaned up.
Markdown Aware: Messages support full Markdown rendering — tables, code blocks, lists, and more are displayed as formatted content. Use Shift+Enter to type multi-line messages.

Usage Analytics

EasyEditor includes optional, privacy-respecting usage analytics to help improve the application. Analytics tracks which features are used and how often, without collecting any document content or personal information.

Enable or Disable Analytics

1

Open Settings

Navigate to File → About in the main navigation bar.

2

Toggle Analytics

Find the Analytics toggle in the About panel. Switch it ON to enable usage tracking, or OFF to disable it completely.

What Is Tracked

Feature Usage

Anonymous Feature Metrics

Which features are opened (EasyTeam, EasyAI, EasyNotes, EasyGit), export formats used, templates selected, and session duration. All data is anonymous — no document content, filenames, or personal information is ever collected.

Opt-in Only: Analytics is disabled by default. You must explicitly enable it via File → About → Analytics. Your choice is stored locally and respected immediately.

Decision Flow Architecture

This diagram describes how the application determines execution capabilities when opening files based on user environment.

Execution Decision Logic Flow
                  User Action: Open File
                          │
                          ▼
                  ┌───────────────┐
                  │ Is Electron?  │
                  └───────┬───────┘
                          │
              ┌───────────┴───────────┐
              │                       │
             Yes                     No
              │                       │
              ▼                       ▼
  ┌─────────────────────┐   ┌──────────────────┐
  │  Use Electron IPC   │   │ Check Browser    │
  │  • Native Dialog    │   │ Capabilities     │
  │  • Full FS Access   │   └────────┬─────────┘
  │  • Git Integration  │            │
  └─────────┬───────────┘            │
            │              ┌─────────┴──────────┐
            │              │                    │
            │         Has FS API?          No FS API
            │              │                    │
            │             Yes                   │
            │              │                    ▼
            │              ▼          ┌──────────────────┐
            │    ┌──────────────────┐ │ Use File Input   │
            │    │ showOpenFile     │ │ • Browser Dialog │
            │    │ Picker()         │ │ • Limited Access │
            │    │ • Native Dialog  │ │ • Download Only  │
            │    │ • File Handle    │ └──────────────────┘
            │    │ • Persistent     │
            │    └────────┬─────────┘
            │             │
            ▼             ▼
  ┌────────────────────────────────────────────┐
  │          Load File Content into Editor     │
  └────────────────────────────────────────────┘

Quick Reference

At-a-glance limits and configuration locations for system diagnostics.

Max AI Reports

100 reports (FIFO)

Encryption Type

AES-256-CBC

AI Engine Compatibility

OpenAI, Ollama (Local)

Local AI Default Port

11434 (Ollama)

Tauri Config (Win)

%APPDATA%/com.easyeditor.editor/

Tauri Config (Linux)

~/.local/share/com.easyeditor.editor/

Sync Storage (Browser)

WebView localStorage

RAM Usage (Tauri)

~20 MB