# Quyll

> Quyll is a sovereign, local-first desktop writing sanctuary and worldbuilding studio for novelists, authors, and storytellers.

## Overview

Quyll (pronounced like "quill") is a desktop application crafted for novelists, fiction writers, and worldbuilders who demand a focused, unified, and entirely private creative environment. Unlike traditional word processors or fragmented note-taking apps, Quyll unifies the entire long-form authoring pipeline—from drafting prose to managing interconnected lore, generating world maps, structuring narrative beats, and exporting clean manuscripts in universal formats.

Quyll runs 100% locally on the user's computer with an embedded SQLite database. Creative manuscripts, character sheets, and lore entries never touch external servers without explicit user instruction.

## Target Audience

- Novelists and fiction writers
- Worldbuilders and fantasy/sci-fi authors
- Screenwriters and game narrative designers
- Storytellers who prefer distraction-free, local-first software
- Authors seeking a modern, sovereign alternative to Scrivener, Campfire, or World Anvil

## Core Systems & Features

### 1. Studio & Manuscript Editor
- Distraction-free, typography-focused writing canvas powered by Lexical
- Live word counts, reading metrics, and session goals
- Offline Harper grammar verification and stylistic prose linter (detecting passive voice, clichés, weak verbs, pacing)
- Integrated inline references to world database entities with entity pills

### 2. Living World Database & Lore Codex
- Relational codex for Characters, Locations, Organizations, Species & Races, Items & Artefacts, and World Systems
- Custom character display templates and attribute engine
- Real-time bidirectional linking between manuscript prose and world entities

### 3. Procedural Map Forge
- Procedural fantasy cartography generator with customizable world seeds, elevation relief, landmass shapes, and sea levels
- Interactive settlement, landmark, and battle pins linked directly into your world lore

### 4. Narrative Outliner & Beat Architect
- Multi-act sequencing with beat cards for drafts, events, and lore notes
- Slide-out inspector drawers with real-time word counting and scene synopses

### 5. Creative Canvas & Moodboard
- Freeform spatial canvas for narrative connection graphs, character pinning, and aesthetic moodboards
- Curved vector connectors linking story arcs and Act 1 scene webs

### 6. Harper Grammar & Prose Style Linter
- Offline, privacy-first grammar verification powered by Harper engine
- Stylistic linting: passive voice detection, cliché warnings, weak verbs, pacing lulls, and integrated smart thesaurus

### 7. Universal Export & Portability
- Clean, standard DOCX exports for editors and agents
- Formatted PDF exports with zero vendor lock-in
- Standard local SQLite database archives

### 8. Multi-Device Incremental Cloud Sync & Zero-Loss Draft Protection
- **Incremental Sync Engine**: Fine-grained, record-level changelog synchronization (Schema v37, 29 tracked tables) powered by atomic SQLite triggers and encrypted cloud RPCs.
- **Local-First Speed**: Writers draft directly into local SQLite at zero latency; background workers synchronize changed chapters, characters, and notes only when connected.
- **Zero-Loss Draft Protection**: Prevents prose overwrites when concurrent offline edits occur. Authors inspect side-by-side visual word diffs and choose to keep local, keep remote, or preserve both versions cleanly.

### 9. Sovereignty & Cloud Backups
- **100% Local SQLite Storage**: All projects, prose, lore, and configurations are stored in standard local SQLite databases.
- **Zero Creative Telemetry**: Your writing stays on your device by default. Quyll never reads, transmits, or trains AI on user prose or creative data.
- **Opt-In Cloud Protection**: Authors can choose to back up and safeguard project archives to the encrypted Quyll Cloud Vault with full control.

### 10. Mobile Companion App (Roadmap)
- Upcoming companion app planned for iOS & Android (Q4 2026).
- Powered by the same offline SQLite engine for reading drafts, spontaneous mobile note-taking, and referencing the World Database codex on the go.

## Technical Specifications

- **Application Type**: Desktop Native Application (built with Tauri, Rust, and modern web technologies)
- **Supported Operating Systems**: Windows 10, Windows 11 (64-bit). macOS and Linux editions planned. Mobile companion app planned for iOS & Android (Q4 2026).
- **Current Version**: v0.7.1
- **License / Pricing**: Free desktop edition available; optional Quyll Pro ($5/mo or $50/yr) for encrypted multi-device cloud sync, automated backups, and mobile companion app access.

## Canonical Links

- Official Website: [https://quyll.app/](https://quyll.app/)
- Latest Desktop Releases: [https://github.com/kodejunkee/quyll-releases/releases/latest](https://github.com/kodejunkee/quyll-releases/releases/latest)
- Public GitHub Releases: [https://github.com/kodejunkee/quyll-releases](https://github.com/kodejunkee/quyll-releases)
- Privacy Policy: [https://quyll.app/privacy.html](https://quyll.app/privacy.html)
- Terms of Service: [https://quyll.app/terms.html](https://quyll.app/terms.html)
- Sitemap: [https://quyll.app/sitemap.xml](https://quyll.app/sitemap.xml)

## Key Concepts & Terminology

- **Sovereign**: Quyll's guiding philosophy that authors own their creative workspace and manuscript data completely, free from vendor lock-in, mandatory subscriptions, or cloud surveillance.
- **Local-First**: Complete functionality without internet connection; data persists locally by default.
- **World Database**: The structured entity system powering characters, places, and rules within a fictional universe.