Overview

[!NOTE] This tool is still under active development. Features may change and not everything on the roadmap is implemented yet. Feedback, ideas, and bug reports are welcome via the GitHub issue tracker.

Ghostty Config is a beautiful web-based configuration generator designed to make customizing your Ghostty terminal effortless. Rather than manually editing text files and worrying about formatting and syntax, Ghostty Config allows you to visually adjust settings, preview changes in real time and export a ready-to-use config.

Under the hood, every setting is driven by a typed schema derived directly from Ghostty's own config specification. The tool tracks only the values that differ from Ghostty's defaults, so the exported config stays minimal and easy to read. Settings are organized into categories that derive from Ghostty's config, and each one carries inline documentation, platform restrictions, and version metadata sourced from the schema.

This project is built with Svelte + TypeScript via Bun. It is automatically deployed with Cloudflare Workers so the hosted version is always up to date.

Try it now: ghostty.zerebos.com

Features

• Interactive settings editor: Tweak fonts, colors, cursor styles, transparency, blur, and much more across organized, categorized setting pages.
• Rich setting inputs: Purpose-built controls for every setting type, including sliders, linked number inputs, color pickers, and duration fields.
• Repeatable settings: Manage multi-value settings like font features with a dedicated list editor.
• Built-in themes: Hundreds of Ghostty color themes, automatically kept in sync with upstream.
• Font playground: Experiment with JetBrains Mono, Nerd Fonts, or any custom font and see the result live.
• Live previews: Instant visual demos for cursors, text selections, app icons, and color palettes as you edit.
• Interactive terminal preview: A DOM-based terminal you can type in that re-themes live as you tweak settings, so existing output (colors, prompt, ls results) updates in place without being torn down.
• Keybinding builder: Build and validate keybindings with an interactive trigger/action editor, including sequence, prefix, and chained-action support.
• Import & export: Paste, upload, copy, or download configs; only settings that differ from defaults are included in the output.
• Config sharing: Share configs with others via a shareable URL (falls back to clipboard copy for large configs).
• Help info: Detailed documentation shown inline for every individual setting.
• Indicators: Per-setting badges showing required platform (macOS, Linux, GTK) and minimum Ghostty version.
• Sidebar search: Instantly browse and jump to any setting, mirroring macOS native preferences UI.
• Reset to defaults: Restore any individual setting to its default value at any time.

Tech Stack

• Bun: A modern JavaScript and TypeScript runtime
• Svelte: UI framework for fast, reactive interfaces
• TypeScript: Strong typing for maintainable code
• Vite: Lightning‑fast bundler and dev server
• Cloudflare: CI/CD for automated deployment

Installation (Local Development)

Simply clone the repo and run locally:

git clone https://github.com/zerebos/ghostty-config.git
cd ghostty-config
bun install
bun run dev

Then open http://localhost:5173 in your browser when prompted.

Other useful commands:

bun run build    # production build (output under build/)
bun run preview  # serve the production build locally
bun run check    # Svelte + TypeScript type checking
bun run lint     # ESLint
bun run test     # Vitest unit tests

Deployment

The only automated deployment built-in is via Cloudflare Workers which automatically deploys to ghostty.zerebos.com on every push to the main branch. If you want to self-host, the static files will be available under build/ after following the steps above to build.

Roadmap

Completed

• Custom settings support
• Terminal preview
• Font playground
• Import & export
• Basic keybind settings
• Editable color pickers
• Update for Ghostty 1.1
• Update for Ghostty 1.2
• Update for Ghostty 1.3
• Update for Ghostty 1.4-nightly
• Icon customization
• Keybind builder and validation
• In-app help documentation
• Resetting individual settings
• Sidebar search like native
• Platform indicators
• Version indicators
• Shareable URLs
• Multi-entry setting support (settings like font-feature that repeat in the config)
• Custom schema-driven setting inputs (sliders, color pickers, durations, and more)
• Automatic theme sync from upstream iTerm2 Color Schemes
• Unified typed settings registry
• Interactive terminal preview with live re-theming
• Unit tests for import/export flows

Near-term

• Command palette builder (guided UI for command-palette-entry settings)
• Community presets for quick theme/workflow setup
• Unified color scheme across the app

Long-term

• Desktop version for direct config file integration
• Component testing

Contributing

See the CONTRIBUTING documentation for more info.

License

Licensed under the Apache‑2.0 License.

Star History

If you find Ghostty Config useful, please consider starring the repo to help others discover it!