Note: This software was developed with the assistant of AI. Certain parts of the code have been generated using LLMs. However, the software does not collect any data from the user. The software is open source and free to use. The software is licensed under the AGPL v3 license.

---

🌟 Why Chronicle?

Writing a novel shouldn't require juggling four separate paid subscriptions. Chronicle unifies the entire creative pipeline into one cohesive, distraction-free powerhouse:

• Replaces Scrivener with a fast, modern WYSIWYG chapter binder and dual-view author annotations.
• Replaces Vellum with publication-ready PDF typesetting and standard EPUB 3 exports.
• Replaces World Anvil with an integrated, private Worldbuilding Codex for character psychology and sensory locations.
• Replaces Plottr / Aeon Timeline with visual, multi-strand narrative timelines that prevent plot-hole collisions.
• Replaces paid TTS proofreaders with private, on-device Kokoro Text-to-Speech voice audio.

🛡️ 100% Local-First & Private

• Zero Telemetry: Chronicle collects no metrics, no trackers, and has no remote database.
• 100% GenAI-Free. No LLMs. No text generation. Built exclusively for human writers.
• No Cloud Lock-in: Your work is saved in the open .chronicle format (a standard ZIP archive containing plain JSON and raw XHTML).
• Optional Private Sync: Sync directly to your own self-hosted WebDAV server (Nextcloud, ownCloud, Fastmail) with end-to-end credential storage.

NOTE: The Website and web-app use SimpleAnalytics to check the number of visitor that are accessing the website. SimpleAnalytics is a privacy-focuse analytics platform. The desktop app doesn't use any analytics. No data related to the way the app is being used, the content that is being written or the user is being collected or stored anywhere.

---

🚀 Key Features

✍️ Distraction-Free Chapter Authoring

• Modern WYSIWYG Canvas: Pure, zero-jitter writing experience with customizable typography, margins, and line spacing.
• Chapter Binder & Splitter: Reorder chapters with drag-and-drop or split large scenes at cursor position in one click.
• Live Word Count & Goals: Track chapter lengths, overall manuscript progress, and daily word targets.

💬 Dual-View Author Comments

• Side-by-Side & Inline Highlighting: Select any passage to attach notes, plot questions, or revision reminders using a 6-color palette.
• Zero-Leakage Export Guarantee: All comments and annotations are automatically stripped upon publishing, guaranteeing clean, professional files.

⏳ Interactive Narrative Timeline Studio

• Multi-Strand Plotting: Track main plots, subplots, and character arcs simultaneously.
• Flexible Timescales: Zoom from granular hours and days to months and years.
• Visual Collision Lanes: Prevent continuity errors and impossible character overlaps before you finish your draft.

📖 Deep Worldbuilding Codex

• Character Dossiers: Document archetypes, character arcs, physical appearances, psychological traits, and backstory secrets.
• Sensory Location Dossiers: Capture sight, sound, smell, weather, history, hazards, and connected characters for every setting.

🎨 Built-In Book Cover Designer

• Craft typography-rich, custom book covers without leaving the app.
• Configure titles, subtitles, author credits, backgrounds, gradients, borders, and decorative emblems with high-resolution export.

🎙️ Offline Kokoro TTS Voices

• Listen to your chapters read aloud by state-of-the-art Kokoro TTS voice models running directly on your computer via WebGPU / WASM.
• Catch clunky phrasing, dialogue hitches, and typos without sending a single byte of your story to external servers.

🖨️ Publication-Grade Exporters

• Print PDF: Automated book formatting with mirror margins, running headers, drop caps, Roman numeral front matter, and proper chapter page breaks.
• Standard EPUB 3: Valid, reflowable EPUB files verified for Amazon Kobo, Kindle, and Apple Books.
• Shunn Manuscript Format (DOCX): Formats your manuscript strictly according to the industry-standard William Shunn format for literary agent and editor submissions.
• Chronicle Project (.chronicle): Comprehensive project backup preserving all drafts, codex dossiers, timelines, covers, and author comments in an open ZIP package.

---

💻 Cross-Platform & Downloads

Chronicle is available as both a native standalone desktop app (Windows & macOS) and an in-browser web app:

[!TIP] The desktop application does not need an installer or administrative rights. Get it on Gumroad for free or with an optional donation to support open-source software! Open it, and start writing immediately.

---

🛠️ Development & Building

Prerequisites

• Node.js (v18.0.0 or later)
• npm (v9 or later)
• Rust toolchain (required only if building the native Tauri desktop app)

1. Clone & Install Dependencies

git clone https://github.com/pazvanti/Chronicle.git
cd Chronicle
npm install

2. Development Mode

Run the in-browser development server with Hot Module Replacement (HMR):

npm run dev

Run the native desktop application in development mode:

npm run tauri:dev

3. Production Builds

Build the production web application into dist/:

npm run build

Compile the standalone native desktop application (outputs to src-tauri/target/release/):

npm run tauri:build

Compile universal Linux AppImage & packages (glibc 2.35+ compatibility for Ubuntu/Debian/Mint/Fedora via container):

npm run tauri:build:container

Compile the complete GitHub Pages suite (presentation site + online web app + desktop download binaries):

npm run build:docs:all

---

📂 Project Architecture

Chronicle/
├── docs/                     # GitHub Pages presentation site & live Web Studio
│   ├── app/                  # Compiled in-browser Chronicle Web Studio
│   ├── assets/               # High-res showcase screenshots & brand assets
│   ├── downloads/            # Staged standalone desktop binaries (Chronicle.exe)
│   ├── index.html            # Showcase landing page
│   ├── main.js               # Dynamic OS detector & interactive showcase logic
│   └── style.css             # Landing page modern design system
├── public/                   # Static web assets & icons
├── scripts/                  # Build & publishing automation
│   ├── build-docs.js         # Builds in-browser studio into docs/app/
│   ├── build-docs-all.js     # Full suite compiler (web app + desktop binaries)
│   └── build-tauri.js        # Tauri desktop builder (standalone executable staging)
├── src/                      # React + TypeScript core studio application
│   ├── components/
│   │   ├── Characters/       # Worldbuilding character dossiers & archetypes
│   │   ├── Comments/         # Dual-view author comments & highlight manager
│   │   ├── Cover/            # Graphic book cover studio
│   │   ├── Editor/           # Distraction-free chapter binder & WYSIWYG editor
│   │   ├── Export/           # PDF, EPUB 3, and Shunn manuscript exporters
│   │   ├── Locations/        # Worldbuilding location dossiers & atmosphere
│   │   ├── Reader/           # Reader simulation view
│   │   ├── Timeline/         # Narrative timeline studio & collision plotter
│   │   └── TTS/              # Kokoro AI neural audio proofreader
│   ├── services/             # Pure business logic (parsers, exporters, WebDAV)
│   └── themes/               # Signature ModernX and Luminous Glass themes
├── src-tauri/                # Tauri 2 (Rust) native desktop wrapper
│   ├── src/                  # Native Rust application entrypoints
│   ├── Cargo.toml            # Rust dependency definitions
│   └── tauri.conf.json       # Desktop application window & security configurations
└── package.json              # Project scripts & npm dependencies

---

📄 Open File Format (.chronicle)

Chronicle believes your stories belong to you forever. A .chronicle file is an unencrypted standard ZIP archive that can be opened by any archive utility (7-Zip, PeaZip, Archive Utility):

my-novel.chronicle (ZIP)
├── project.json              # Manuscript title, author, and version metadata
├── metadata.json             # EPUB 3 publishing metadata & Dublin Core fields
├── toc.json                  # Table of contents hierarchy
├── manifest.json             # Asset & media item manifest
├── spine.json                # Linear reading order
├── chapters/                 # Individual chapter files in structured JSON
├── writer/                   # Worldbuilding codex, timelines, characters, comments
└── assets/                   # Book cover, character portraits, and inline images

---

📜 License

Chronicle is proudly free, open-source software licensed under the GNU Affero General Public License v3 (AGPLv3).

You are free to use, modify, and redistribute this software in accordance with the terms of the GNU AGPLv3. See the LICENSE file for the full license text.

Note: You retain 100% intellectual property ownership and commercial rights over every book, manuscript, and story you produce using Chronicle.

---