From 09dbf069de83906cff03bbb380a08fb844893b75 Mon Sep 17 00:00:00 2001 From: Sindre Sorhus Date: Wed, 13 May 2026 14:41:56 +0700 Subject: [PATCH] Add FAQ about prompt corruption caused by missing UTF-8 locale Fixes #666 --- readme.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/readme.md b/readme.md index f2887df..61d2af2 100644 --- a/readme.md +++ b/readme.md @@ -261,7 +261,13 @@ See the [ZI wiki](https://wiki.zshell.dev/community/gallery/collection/themes#th ## FAQ -There are currently no FAQs. +### Prompt is corrupted when using tab completion + +If the prompt displays incorrectly during tab completion (ghost characters, misaligned cursor), your shell is likely missing a UTF-8 locale. Pure uses Unicode characters (like `❯`) that require UTF-8 to calculate display width correctly. Add this to your `.zshrc`: + +```sh +export LANG=en_US.UTF-8 +``` See [FAQ Archive](https://github.com/sindresorhus/pure/wiki/FAQ-Archive) for previous FAQs. -- 2.51.2