Skip to content

smith-and-web/kindling

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

290 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Kindling

Kindling

Free, open-source writing software for plotters and outliners.
Bridge the gap between your story outline and your first draft.

Download · Features · Compare · Contributing

CI Status Version License Stars Platform


Kindling demo - scaffolded writing view

Why Kindling?

  • Your outline stays visible while you write. Scene beats appear as expandable prompts in your drafting space. No more switching between apps.
  • Import your existing work. Bring in projects from Plottr (.pltr), yWriter (.yw7), or Obsidian Longform — no starting from scratch.
  • No AI. No subscription. No cloud. Every word is yours. Your projects are local SQLite files. Works completely offline.
  • Free and open source. MIT licensed. Inspect the code, contribute, or fork it. Your tools should be as permanent as your writing.

Download

Get Kindling for free at kindlingwriter.com/download

Platform Download
macOS (Apple Silicon) Kindling_*_aarch64.dmg
macOS (Intel) Kindling_*_x64.dmg
Windows Kindling_*_x64-setup.msi
Linux Kindling_*_amd64.AppImage or .deb

Or grab the latest directly from the Releases page.

Features

Feature Description
Import from popular tools Plottr (.pltr), Markdown (.md), yWriter (.yw7), and Longform/Obsidian (index or vault)
Scaffolded writing view Scene beats appear as expandable prompts
Rich text prose editor Write with formatting, auto-save, and beat context
Export formats DOCX (Standard Manuscript Format), Markdown, Longform/Obsidian, and EPUB
Reference types Characters, locations, items, objectives, and organizations
Sync/reimport Preview and apply source changes while preserving prose
Distraction-free dark mode Easy on the eyes for long writing sessions
Local-first Your work stays on your machine in a SQLite database
Cross-platform macOS, Windows, and Linux support

See the full features overview on the website.

Tech Stack

From Source

Prerequisites:

# Clone the repository
git clone https://github.com/smith-and-web/kindling.git
cd kindling

# Install dependencies
npm install

# Run in development mode
npm run tauri dev

# Build for production
npm run tauri build

Roadmap

Track progress on the project board.

Phase Status Description
v0.1 - Foundation ✅ Complete Plottr import, basic UI, project structure
v0.2 - Outline View ✅ Complete Drag-and-drop reordering, create/delete scenes
v0.3 - Writing & Export ✅ Complete Prose editor, DOCX export with Standard Manuscript Format
v1.0 - Release ✅ Complete Additional importers, polish, performance, stability
v1.2 - Next 🔄 In Progress Sync/reimport UI, bug fixes, new features

See the milestones for detailed breakdowns.

Testing

Kindling maintains high test coverage standards to ensure code quality and prevent regressions.

Metric Minimum Current
Statements 95% 95%+
Branches 65% 65%+
Functions 98% 98%+
Lines 95% 95%+

CI will fail if coverage drops below these thresholds. New code must include appropriate tests.

# Frontend tests with coverage
npm test -- --coverage

# Rust tests
cd src-tauri && cargo test

# Run all checks (lint, format, types, tests)
npm run check:all

Contributing

Contributions are welcome! Please read the Contributing Guide before submitting a PR.

Looking for a place to start? Check out issues labeled good first issue.

Support

If Kindling is useful to you, consider supporting its development:

Sponsor on GitHub

Your sponsorship helps keep Kindling free and open source.

License

MIT — free for personal and commercial use.

Acknowledgments


Made with ☕ for writers who plan before they write.