diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index 76c6713..5ed4d8b 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -668,3 +668,21 @@ each step. Screenshot links open in a new tab, without a sentence telling readers to click them. The copyable example must retain its literal Markdown symbols and line breaks, rather than rendering headings or lists inside the code block. + +## Lead the homepage with the writing experience + +On 2026-10-13, the creator asked to reconsider the homepage feature order +and wording for positioning and conversion. Address people who already +use a terminal and want a place to write: lead with focus and automatic +saving, then privacy, versions, familiar controls, and portable Markdown. +Use six short benefit-led descriptions, with concrete behavior supporting +each. Leave shortcut details and sorting options to the guide and README. +The hero still identifies writui as a terminal writing app; its supporting +line explains focus, autosave, and local encryption. Keep the demo caption +as the invitation to try a writing session, and make free/open-source status +explicit. Preserve the early-stage backup and password-recovery caveats. + +The creator also rejected a promotion plan that waited two weeks for a +directory listing before attempting another placement. Prepare suitable +opportunities concurrently and progress approved recruitment continuously; +human response time must not block research, preparation, or improvements. diff --git a/docs/PLAN.md b/docs/PLAN.md index 32a7458..f444eda 100644 --- a/docs/PLAN.md +++ b/docs/PLAN.md @@ -13,10 +13,13 @@ file is the source of truth for what's next. ## Next up Alongside development, focus promotion on regular users and useful feedback. -The first experiment is an illustrated "Try a five-minute writing session" -blog post, linked in the site's demo caption and from the README, with a short -GitHub feedback form. It guides people through using their regular vault. -Learn where new writers get stuck and whether they return on another day. +The illustrated "Try a five-minute writing session" guide and GitHub +feedback form landed in PR #24. The guide is linked from the demo caption +and README and uses the reader's regular vault. Next, sharpen the homepage +around the writing experience and actively recruit people to try a session. +Prepare suitable community placements together; do not wait two weeks for +a directory listing before doing more outreach. Learn where new writers +get stuck and whether they return on another day. Keep promotion work in separate PRs from the app milestones below. The site is on Cloudflare Workers: writui.com serves it (and diff --git a/docs/SPEC.md b/docs/SPEC.md index 2c9d3c6..2d2d56f 100644 --- a/docs/SPEC.md +++ b/docs/SPEC.md @@ -759,6 +759,12 @@ in [DECISIONS.md](DECISIONS.md); the build order lives in [PLAN.md](PLAN.md). the browser allows copying; it says "Copied" for a moment). The landing page is kept up to date with each new feature (see AGENTS.md). "Changelog" in the menu links to the GitHub releases page. +- Homepage copy leads with focused Markdown writing and automatic saving. + Six short feature descriptions cover focus, resuming a post, local + encryption, named versions, familiar controls, and Markdown portability, + in that order. Detailed shortcuts and sorting options belong in the + guide and README. Keep the free/open-source status and early-stage + backup/password caveats visible. - "Try a five-minute writing session" is the demo recording's clickable, centered caption. It opens a blog post with screenshots, guiding readers through diff --git a/site/content/_index.md b/site/content/_index.md index 37709c8..a950e37 100644 --- a/site/content/_index.md +++ b/site/content/_index.md @@ -1,29 +1,19 @@ +++ +++ -- **Private.** All your posts live in one file, encrypted with your - password. Without the password nobody can read them. Ctrl+O locks it - when you step away, and unlocking takes you back where you were. -- **Plain markdown.** Each post starts with a `# Title`, and it stays plain - markdown on screen, formatted as you type: headings and bold in bold, - italics in italics, code in green, with the markdown symbols faded. -- **Versions.** Save a named version whenever you like, look back through - them, and bring an old one back. -- **Mouse and keyboard.** Click, scroll, select and press buttons with the - mouse, or use shortcuts. While writing, Ctrl+K opens a menu of - everything you can do. -- **Fits your terminal.** It uses your terminal's own colours and font, and - works in any modern terminal: Alacritty, Ghostty, iTerm2, and others. -- **Finds anything.** Type to search the full text of every post, front - matter and all, and sort the list by when posts were updated or created, - or by title, either way round. -- **Gets out of the way.** A single centred column of text. The word count - and shortcuts show up while you hold Ctrl, and it opens where you left - off. -- **Takes your writing anywhere.** Copy a post as markdown, or export it as - a file with front matter for your blog. Import a markdown or text file to - edit it here and export it back. +- **Just you and your words.** One calm column, in your terminal's colours + and font. Markdown formats as you type, with its marks still visible. +- **Pick up where you left off.** Your writing saves automatically. Reopen + a post and your cursor is right where you left it. +- **Keep your writing private.** Your posts stay on your computer in a + password-encrypted vault. Lock it when you step away. +- **Try another draft. Keep the first.** Save a named version before you + make changes. Read or restore it whenever you want. +- **Use the controls you know.** Click, scroll and select, or use keyboard + shortcuts. Search your posts or find a command in the menu. +- **Take your words with you.** Import Markdown or text files. Copy or + export your writing as Markdown, ready for your blog or another editor. -writui is early, and built in the open, a small piece at a time. It's -usable for writing now, but keep a copy of anything you can't afford to -lose. And there is no way to recover a forgotten password. +Free and [open source](https://github.com/aakashns/writui). Early, but usable +for daily writing. Keep a backup of anything you can't afford to lose; +forgotten passwords cannot be recovered. diff --git a/site/templates/index.html b/site/templates/index.html index 7d394b7..f9b0f75 100644 --- a/site/templates/index.html +++ b/site/templates/index.html @@ -11,7 +11,7 @@ {% block content %}

A writing app for the terminal.

-

No nonsense. Markdown. Local. Encrypted.

+

A quiet place to write Markdown. Saved automatically, encrypted on your computer.