From 092be51157faaa8d84b7ed68484884503c6c9633 Mon Sep 17 00:00:00 2001 From: Fielding Johnston Date: Thu, 2 Jul 2026 11:47:37 -0500 Subject: [PATCH 1/2] docs(palette): correct stale quiet-accent role comments Five of the eight base24 slot comments described roles the templates don't actually use (base12 said strings; strings are base17, etc.). Align the comments with the real assignments in the VS Code template and the README palette table. No hex changes. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01Xan5eRiAXvcnAVvXHejdTz --- palette.toml | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/palette.toml b/palette.toml index 45cd715..705ebc9 100644 --- a/palette.toml +++ b/palette.toml @@ -27,10 +27,10 @@ base0F = "#bbff00" # lime (RESERVED - human intent marker !!) [base24] # Quiet accent variants - for syntax, UI state (less urgent than diagnostics) base10 = "#c8518f" # quiet red (keywords) -base11 = "#d68c6f" # quiet orange (secondary) -base12 = "#dfb683" # quiet yellow (strings) -base13 = "#61b186" # quiet green (functions) +base11 = "#d68c6f" # quiet orange (decorators, events) +base12 = "#dfb683" # quiet yellow (constants, numbers) +base13 = "#61b186" # quiet green (diff added, CSS classes) base14 = "#91cbcd" # quiet cyan (types, declarations) -base15 = "#5e84b6" # quiet blue (hints) -base16 = "#8f72e3" # quiet purple (constants) -base17 = "#d2fc91" # quiet lime +base15 = "#5e84b6" # quiet blue (functions, hints) +base16 = "#8f72e3" # quiet purple (parameters, labels) +base17 = "#d2fc91" # quiet lime (strings) From ce84fa9a01f83b0190eb4b659c3373be4eebe07c Mon Sep 17 00:00:00 2001 From: Fielding Johnston Date: Thu, 2 Jul 2026 11:47:37 -0500 Subject: [PATCH 2/2] docs: marketplace-first install, add Neovim/Vim/Zed sections MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The README still told people to build the VS Code extension from source with a version pinned at 1.0.0, while the extension has been on the Marketplace and Open VSX since January. Lead with the one-line install instead. The first-party Neovim plugin, vanilla Vim colorscheme, and Zed extension shipped in v1.5/v1.6 but the README never mentioned them ('Vim / Neovim — via tinty' was the only trace). Add install sections for all three — the lazy.nvim snippet is headless-verified — and update the app table and site app cards to match. Also switch the marker example to lead with the sigils rather than the legacy TODO/NOTE aliases, and align the base13 role in the palette table with actual usage (diff added, CSS classes). README.md regenerated via make build; make check passes. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01Xan5eRiAXvcnAVvXHejdTz --- README.md | 50 +++++++++++++++++++++++++++------- templates/README.md.tmpl | 50 +++++++++++++++++++++++++++------- templates/site/index.html.tmpl | 3 +- 3 files changed, 82 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index a00e676..14cb4bc 100644 --- a/README.md +++ b/README.md @@ -87,7 +87,7 @@ Human++ uses a cool charcoal grayscale with warm cream text and a full Base24 pa | base10 | `#c8518f` | Keywords | | base11 | `#d68c6f` | Decorators | | base12 | `#dfb683` | Constants | -| base13 | `#61b186` | CSS classes | +| base13 | `#61b186` | Diff added, CSS classes | | base14 | `#91cbcd` | Types | | base15 | `#5e84b6` | Functions | | base16 | `#8f72e3` | Parameters | @@ -110,11 +110,11 @@ Use punctuation markers in comments to flag human judgment: // !! Critical: don't change without talking to Sarah if (legacyMode) { - // TODO: Not sure this handles the edge case + // ?? Not sure this handles the edge case return transformLegacy(data); } -// NOTE: See utils.ts for the transform logic +// >> See utils.ts for the transform logic return transform(data); ``` @@ -130,22 +130,51 @@ return transform(data); ### VS Code / Cursor (Recommended) -The VS Code extension includes the full theme plus **marker highlighting** and **inline diagnostics**: +The extension includes the full theme plus **marker highlighting** and **inline diagnostics**: ```bash -# Build and install from source -cd packages/vscode-extension -npm install && npx @vscode/vsce package -code --install-extension human-plus-plus-1.0.0.vsix +code --install-extension fielding.human-plus-plus ``` -Or download `human-plus-plus-*.vsix` from [Releases](https://github.com/fielding/human-plus-plus/releases). +Or search "Human++" in the Extensions panel. Published on the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=fielding.human-plus-plus) and [Open VSX](https://open-vsx.org/extension/fielding/human-plus-plus) (Cursor, VSCodium). A `.vsix` is also attached to each [Release](https://github.com/fielding/human-plus-plus/releases). **Features:** - Color theme with quiet syntax + loud diagnostics - Marker highlighting (`!!`, `??`, `>>`) with colored backgrounds - Inline diagnostic badges for errors/warnings +### Neovim + +The first-party plugin lives in `packages/neovim-plugin` (colorscheme + marker highlighting + inline diagnostics, Neovim 0.9+). With [lazy.nvim](https://github.com/folke/lazy.nvim): + +```lua +{ + "fielding/human-plus-plus", + lazy = false, + priority = 1000, + config = function(plugin) + vim.opt.rtp:prepend(plugin.dir .. "/packages/neovim-plugin") + vim.cmd.colorscheme("humanplusplus") + require("human-plus-plus").setup() + end, +} +``` + +`colorscheme humanplusplus` gives you the theme; `setup()` turns on markers and inline diagnostics. Options mirror the VS Code extension settings. + +### Vim + +A vanilla colorscheme (plus a lightline theme) lives in `packages/vim-plugin`. Add it to your runtimepath, then: + +```vim +colorscheme humanplusplus +let g:lightline = { 'colorscheme': 'humanplusplus' } +``` + +### Zed + +The theme lives in `packages/zed-extension`. Until it lands in the Zed extension registry, install it as a dev extension: run `zed: install dev extension` from the command palette and point it at that directory. + ### Shell Tools (eza, fzf, etc.) Add one line to your `.zshrc` or `.bashrc`: @@ -183,7 +212,8 @@ make apply # Apply to installed apps | Ghostty | `dist/ghostty/config` | | [delta][91] | `dist/delta/config.gitconfig` | | git | `dist/git/colors.gitconfig` | -| Vim / Neovim | via [tinty][90] | +| Vim / Neovim | `packages/vim-plugin`, `packages/neovim-plugin` (or via [tinty][90]) | +| Zed | `packages/zed-extension` | | Sketchybar | `dist/sketchybar/colors.sh` | | JankyBorders | `dist/borders/bordersrc` | | skhd | `dist/skhd/modes.sh` | diff --git a/templates/README.md.tmpl b/templates/README.md.tmpl index 5737bab..b5cb714 100644 --- a/templates/README.md.tmpl +++ b/templates/README.md.tmpl @@ -87,7 +87,7 @@ Human++ uses a cool charcoal grayscale with warm cream text and a full Base24 pa | base10 | `{{base10}}` | Keywords | | base11 | `{{base11}}` | Decorators | | base12 | `{{base12}}` | Constants | -| base13 | `{{base13}}` | CSS classes | +| base13 | `{{base13}}` | Diff added, CSS classes | | base14 | `{{base14}}` | Types | | base15 | `{{base15}}` | Functions | | base16 | `{{base16}}` | Parameters | @@ -110,11 +110,11 @@ Use punctuation markers in comments to flag human judgment: // !! Critical: don't change without talking to Sarah if (legacyMode) { - // TODO: Not sure this handles the edge case + // ?? Not sure this handles the edge case return transformLegacy(data); } -// NOTE: See utils.ts for the transform logic +// >> See utils.ts for the transform logic return transform(data); ``` @@ -130,22 +130,51 @@ return transform(data); ### VS Code / Cursor (Recommended) -The VS Code extension includes the full theme plus **marker highlighting** and **inline diagnostics**: +The extension includes the full theme plus **marker highlighting** and **inline diagnostics**: ```bash -# Build and install from source -cd packages/vscode-extension -npm install && npx @vscode/vsce package -code --install-extension human-plus-plus-1.0.0.vsix +code --install-extension fielding.human-plus-plus ``` -Or download `human-plus-plus-*.vsix` from [Releases](https://github.com/fielding/human-plus-plus/releases). +Or search "Human++" in the Extensions panel. Published on the [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=fielding.human-plus-plus) and [Open VSX](https://open-vsx.org/extension/fielding/human-plus-plus) (Cursor, VSCodium). A `.vsix` is also attached to each [Release](https://github.com/fielding/human-plus-plus/releases). **Features:** - Color theme with quiet syntax + loud diagnostics - Marker highlighting (`!!`, `??`, `>>`) with colored backgrounds - Inline diagnostic badges for errors/warnings +### Neovim + +The first-party plugin lives in `packages/neovim-plugin` (colorscheme + marker highlighting + inline diagnostics, Neovim 0.9+). With [lazy.nvim](https://github.com/folke/lazy.nvim): + +```lua +{ + "fielding/human-plus-plus", + lazy = false, + priority = 1000, + config = function(plugin) + vim.opt.rtp:prepend(plugin.dir .. "/packages/neovim-plugin") + vim.cmd.colorscheme("humanplusplus") + require("human-plus-plus").setup() + end, +} +``` + +`colorscheme humanplusplus` gives you the theme; `setup()` turns on markers and inline diagnostics. Options mirror the VS Code extension settings. + +### Vim + +A vanilla colorscheme (plus a lightline theme) lives in `packages/vim-plugin`. Add it to your runtimepath, then: + +```vim +colorscheme humanplusplus +let g:lightline = { 'colorscheme': 'humanplusplus' } +``` + +### Zed + +The theme lives in `packages/zed-extension`. Until it lands in the Zed extension registry, install it as a dev extension: run `zed: install dev extension` from the command palette and point it at that directory. + ### Shell Tools (eza, fzf, etc.) Add one line to your `.zshrc` or `.bashrc`: @@ -183,7 +212,8 @@ make apply # Apply to installed apps | Ghostty | `dist/ghostty/config` | | [delta][91] | `dist/delta/config.gitconfig` | | git | `dist/git/colors.gitconfig` | -| Vim / Neovim | via [tinty][90] | +| Vim / Neovim | `packages/vim-plugin`, `packages/neovim-plugin` (or via [tinty][90]) | +| Zed | `packages/zed-extension` | | Sketchybar | `dist/sketchybar/colors.sh` | | JankyBorders | `dist/borders/bordersrc` | | skhd | `dist/skhd/modes.sh` | diff --git a/templates/site/index.html.tmpl b/templates/site/index.html.tmpl index 81ae910..3379a6b 100644 --- a/templates/site/index.html.tmpl +++ b/templates/site/index.html.tmpl @@ -708,7 +708,8 @@ pub fn validate_token(token: &str) -> Result<Claims, AuthError> {

Ghostty

ghostty/config

-

Vim/Neovim

via tinty

+

Vim/Neovim

first-party plugins

+

Zed

zed-extension

eza

eza/colors.sh

fzf

fzf/colors.sh

Sketchybar

sketchybar/colors.sh