Skip to content

docs: add configuration, troubleshooting, and themes reference#4

Merged
marcus merged 1 commit intomainfrom
docs/backfill-config-troubleshooting-themes
Feb 5, 2026
Merged

docs: add configuration, troubleshooting, and themes reference#4
marcus merged 1 commit intomainfrom
docs/backfill-config-troubleshooting-themes

Conversation

@marcus
Copy link
Owner

@marcus marcus commented Feb 5, 2026

Summary

  • Configuration guide (website/docs/guides/configuration.md): Covers .betamaxrc format, global config (~/.config/betamax/config), preset system, config precedence chain (CLI > @set > .betamaxrc > global > preset > defaults), all available config keys with examples
  • Troubleshooting guide (website/docs/guides/troubleshooting.md): Common errors with exact error messages, dependency installation for macOS/Linux, validation errors with line numbers, @source import issues (circular/depth limit), tmux session cleanup, signal handling, platform notes, truecolor support
  • Themes reference (website/docs/themes.md): All 31 built-in themes organized by family (Catppuccin, Gruvbox, Tokyo Night, Solarized, Rose Pine, etc.) with bar/padding/margin hex colors, usage via CLI/keys files/config, and override instructions

Test plan

  • Docusaurus build passes (npm run build in website/)
  • Verify pages render correctly in browser (npm run serve)
  • Check internal links resolve (See Also sections)
  • Confirm sidebar auto-generates new entries in correct positions

🤖 Generated with Claude Code

Fill the three biggest documentation gaps identified by cross-referencing
source code features against existing docs: config file system with
precedence rules, troubleshooting guide for common errors and platform
notes, and complete theme reference with all 31 built-in themes.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@marcus marcus merged commit 4b75c97 into main Feb 5, 2026
1 check passed
@marcus marcus deleted the docs/backfill-config-troubleshooting-themes branch February 5, 2026 16:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant