{"id":46009803,"url":"https://github.com/smith-and-web/kindling","last_synced_at":"2026-04-08T02:01:08.658Z","repository":{"id":332198518,"uuid":"1133030367","full_name":"smith-and-web/kindling","owner":"smith-and-web","description":"Spark your draft - Bridge the gap between outline and prose. A desktop writing app for fiction writers.","archived":false,"fork":false,"pushed_at":"2026-03-16T23:31:00.000Z","size":12094,"stargazers_count":14,"open_issues_count":35,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-17T04:35:27.450Z","etag":null,"topics":["creative-writing","desktop-application","fiction-writing","fiction-writing-organizer","nanowrimo","novel-writing","open-source","plotters","plottr","productivity","rust","rust-lang","scrivener-alternative","sveltekit","tauri-app","writing-app","writing-software","writing-tools"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/smith-and-web.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["smith-and-web"],"custom":null}},"created_at":"2026-01-12T19:34:09.000Z","updated_at":"2026-03-16T23:28:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/smith-and-web/kindling","commit_stats":null,"previous_names":["smith-and-web/kindling"],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/smith-and-web/kindling","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smith-and-web%2Fkindling","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smith-and-web%2Fkindling/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smith-and-web%2Fkindling/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smith-and-web%2Fkindling/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/smith-and-web","download_url":"https://codeload.github.com/smith-and-web/kindling/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/smith-and-web%2Fkindling/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31536473,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"online","status_checked_at":"2026-04-08T02:00:06.127Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["creative-writing","desktop-application","fiction-writing","fiction-writing-organizer","nanowrimo","novel-writing","open-source","plotters","plottr","productivity","rust","rust-lang","scrivener-alternative","sveltekit","tauri-app","writing-app","writing-software","writing-tools"],"created_at":"2026-03-01T00:00:40.974Z","updated_at":"2026-04-08T02:01:08.651Z","avatar_url":"https://github.com/smith-and-web.png","language":"Rust","funding_links":["https://github.com/sponsors/smith-and-web"],"categories":["Markdown Desktop Editors"],"sub_categories":["Universal"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\".github/assets/kindling-mark-color-512.png\" alt=\"Kindling\" width=\"128\" height=\"128\" /\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eKindling\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eFree, open-source writing software for plotters and outliners.\u003c/strong\u003e\u003cbr/\u003e\n  Bridge the gap between your story outline and your first draft.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://kindlingwriter.com/download/\"\u003eDownload\u003c/a\u003e ·\n  \u003ca href=\"https://kindlingwriter.com/features/\"\u003eFeatures\u003c/a\u003e ·\n  \u003ca href=\"https://kindlingwriter.com/compare/\"\u003eCompare\u003c/a\u003e ·\n  \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/smith-and-web/kindling/actions/workflows/ci.yml\"\u003e\n    \u003cimg src=\"https://github.com/smith-and-web/kindling/actions/workflows/ci.yml/badge.svg\" alt=\"CI Status\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/smith-and-web/kindling/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/smith-and-web/kindling?include_prereleases\u0026label=version\" alt=\"Version\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/smith-and-web/kindling/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/smith-and-web/kindling\" alt=\"License\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/smith-and-web/kindling/stargazers\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/smith-and-web/kindling?style=flat\" alt=\"Stars\" /\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platform-macOS%20%7C%20Windows%20%7C%20Linux-lightgrey\" alt=\"Platform\" /\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/assets/demo-1.gif\" alt=\"Kindling demo - scaffolded writing view\" width=\"800\" /\u003e\n\u003c/p\u003e\n\n## Why Kindling?\n\n- **Your outline stays visible while you write.** Scene beats appear as expandable prompts in your drafting space. No more switching between apps.\n- **Import your existing work.** Bring in projects from Scrivener (.scriv), Plottr (.pltr), yWriter (.yw7), Obsidian Longform, or Markdown — no starting from scratch.\n- **No AI. No subscription. No cloud.** Every word is yours. Your projects are local SQLite files. Works completely offline.\n- **Free and open source.** MIT licensed. Inspect the code, contribute, or fork it. Your tools should be as permanent as your writing.\n\n## Download\n\nGet Kindling for free at **[kindlingwriter.com/download](https://kindlingwriter.com/download/)**\n\n| Platform | Download |\n|----------|----------|\n| macOS (Universal) | `Kindling_*_universal.dmg` |\n| Windows | `Kindling_*_x64-setup.msi` |\n| Linux | `Kindling_*_amd64.AppImage` or `.deb` |\n\nOr grab the latest directly from the [Releases page](https://github.com/smith-and-web/kindling/releases).\n\n## Features\n\n| Feature | Description |\n|---------|-------------|\n| **Import from popular tools** | Scrivener 3 (`.scriv`), Plottr (`.pltr`), Markdown (`.md`), yWriter (`.yw7`), and Longform/Obsidian |\n| **Scaffolded writing view** | Scene beats appear as expandable prompts — or switch to full-page prose editing |\n| **Rich text prose editor** | Write with formatting, auto-save, word count, and beat context |\n| **Export formats** | Scrivener (`.scriv`), DOCX (Standard Manuscript Format), EPUB, Markdown, Longform/Obsidian, and Treatment (1-page \u0026 5-page) |\n| **Screenplay support** | Screenplay project type with sluglines, acts/sequences, and page count estimates |\n| **Reference auto-detection** | Characters and locations are auto-detected in your prose — no manual linking needed |\n| **Custom fields \u0026 tags** | Add typed custom fields (text, number, select, etc.) and hierarchical tags to any entity |\n| **Beat sheet templates** | Start from Hero's Journey, Save the Cat, Three-Act Structure, Story Circle, and more |\n| **Reference panel** | Characters, locations, items, objectives, and organizations — linked per scene |\n| **Sync/reimport** | Preview and apply source changes while preserving your prose |\n| **Light \u0026 dark themes** | System preference detection with manual override |\n| **Local-first** | Your work stays on your machine in a SQLite database |\n| **Cross-platform** | macOS, Windows, and Linux |\n\nSee the full [features overview](https://kindlingwriter.com/features/) on the website.\n\n## Tech Stack\n\n- **Frontend**: [Svelte 5](https://svelte.dev/) + [Tailwind CSS](https://tailwindcss.com/)\n- **Backend**: [Rust](https://www.rust-lang.org/) + [Tauri 2.x](https://tauri.app/)\n- **Database**: [SQLite](https://sqlite.org/) via rusqlite\n- **Parsers**: Native Rust parsers for Scrivener 3, Plottr, yWriter, Longform, and Markdown\n\n## From Source\n\n**Prerequisites:**\n- [Node.js](https://nodejs.org/) 20+\n- [Rust](https://rustup.rs/) (stable)\n- Platform dependencies: [Tauri prerequisites](https://tauri.app/start/prerequisites/)\n\n```bash\n# Clone the repository\ngit clone https://github.com/smith-and-web/kindling.git\ncd kindling\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run tauri dev\n\n# Build for production\nnpm run tauri build\n```\n\n## Roadmap\n\nTrack progress on the [project board](https://github.com/users/smith-and-web/projects/1).\n\n| Phase | Status | Description |\n|-------|--------|-------------|\n| **v0.1 - Foundation** | ✅ Complete | Plottr import, basic UI, project structure |\n| **v0.2 - Outline View** | ✅ Complete | Drag-and-drop reordering, create/delete scenes |\n| **v0.3 - Writing \u0026 Export** | ✅ Complete | Prose editor, DOCX export with Standard Manuscript Format |\n| **v1.0 - Release** | ✅ Complete | Additional importers, polish, performance, stability |\n| **v1.2 - Features** | ✅ Complete | Scrivener import/export, screenplay support, light theme, custom fields, tags, templates, auto-detection, EPUB, treatments |\n\nSee the [milestones](https://github.com/smith-and-web/kindling/milestones) for detailed breakdowns.\n\n## Testing\n\nKindling maintains high test coverage standards to ensure code quality and prevent regressions.\n\n| Metric | Minimum | Current |\n|--------|---------|---------|\n| Statements | 95% | 100% |\n| Branches | 65% | 100% |\n| Functions | 98% | 100% |\n| Lines | 95% | 100% |\n\n**CI will fail if coverage drops below these thresholds.** New code must include appropriate tests.\n\n```bash\n# Frontend tests with coverage\nnpm test -- --coverage\n\n# Rust tests\ncd src-tauri \u0026\u0026 cargo test\n\n# Run all checks (lint, format, types, tests)\nnpm run check:all\n```\n\n## Contributing\n\nContributions are welcome! Please read the [Contributing Guide](CONTRIBUTING.md) before submitting a PR.\n\n- 🐛 [Report bugs](https://github.com/smith-and-web/kindling/issues/new?template=bug_report.yml)\n- 💡 [Request features](https://github.com/smith-and-web/kindling/issues/new?template=feature_request.yml)\n- 💬 [GitHub Discussions](https://github.com/smith-and-web/kindling/discussions) — Questions and ideas\n- 🔥 [Discord](https://discord.gg/g7bkj4kY8w) — Chat with other writers and contributors\n\nLooking for a place to start? Check out issues labeled [`good first issue`](https://github.com/smith-and-web/kindling/labels/good%20first%20issue).\n\n## Support\n\nIf Kindling is useful to you, consider supporting its development:\n\n\u003ca href=\"https://github.com/sponsors/smith-and-web\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Sponsor-❤️-ea4aaa?style=for-the-badge\u0026logo=github-sponsors\" alt=\"Sponsor on GitHub\" /\u003e\n\u003c/a\u003e\n\nYour sponsorship helps keep Kindling free and open source.\n\n## License\n\n[MIT](LICENSE) — free for personal and commercial use.\n\n## Acknowledgments\n\n- Built with [Tauri](https://tauri.app/) and [Svelte](https://svelte.dev/)\n- Inspired by [Scrivener](https://www.literatureandlatte.com/scrivener/) and [Plottr](https://plottr.com/)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made with ☕ for writers who plan before they write.\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmith-and-web%2Fkindling","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsmith-and-web%2Fkindling","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsmith-and-web%2Fkindling/lists"}