\n \n\n[](http://commitizen.github.io/cz-cli/)  \n\n\n\n\n> [!IMPORTANT] \n> This repository, and the apps, libraries, and tools contained within, is still in it's initial development phase. As a result, bugs and issues are expected with it's usage. When the main development phase completes, a proper release will be performed, the packages will be available through NPM (and other distributions), and this message will be removed. However, in the meantime, please feel free to report any issues you may come across.\n\n\n\n\n
\nBe sure to ⭐ this repository on GitHub so you can keep up to date on any daily progress!\n
\n\n \n\n\n\n\n\n\n# Razorwind - Ghostty Theme Generator\n\n**Razorwind - Ghostty Theme Generator** creates [Ghostty](https://ghostty.org/) terminal theme files from design tokens. Color layout follows [Dracula for Ghostty](https://draculatheme.com/ghostty) (`palette`, `background`, `foreground`, cursor, selection).\n\n## Installing\n\nUsing [pnpm](http://pnpm.io):\n\n```bash\npnpm add -D @razorwind/ghostty\n```\n\n\n Using npm\n\n```bash\nnpm install -D @razorwind/ghostty\n```\n\n\n\n\n Using yarn\n\n```bash\nyarn add -D @razorwind/ghostty\n```\n\n\n\n## Usage\n\n```ts\nimport { defineConfig } from \"@razorwind/core\";\nimport ghostty, { flattenTokens } from \"@razorwind/ghostty\";\n\nexport default defineConfig({\n plugins: [\n ghostty({\n mapTheme: tokens => {\n const flat = flattenTokens(tokens);\n const color = (path: string) =>\n flat.find(t => t.path === path)?.cssValue ?? \"#282a36\";\n\n return {\n name: \"my-theme\",\n background: color(\"color.bg\"),\n foreground: color(\"color.fg\"),\n cursorColor: color(\"color.fg\"),\n cursorText: color(\"color.bg\"),\n selectionBackground: color(\"color.selection\"),\n selectionForeground: color(\"color.fg\"),\n palette: {\n 0: color(\"color.ansi.black\"),\n 1: color(\"color.ansi.red\"),\n 2: color(\"color.ansi.green\"),\n 3: color(\"color.ansi.yellow\"),\n 4: color(\"color.ansi.blue\"),\n 5: color(\"color.ansi.magenta\"),\n 6: color(\"color.ansi.cyan\"),\n 7: color(\"color.ansi.white\")\n }\n };\n }\n })\n ]\n});\n```\n\nGenerated files (under `ghostty-themes/` by default):\n\n- `{theme-name}` — Ghostty theme config (no file extension) from `mapTheme`\n- `INSTALL.md` — copy into `~/.config/ghostty/themes/`, set `theme =`, reload\n\nActivate like [Dracula Ghostty](https://draculatheme.com/ghostty):\n\n```sh\nmkdir -p ~/.config/ghostty/themes\ncp ghostty-themes/my-theme ~/.config/ghostty/themes/\n# in ~/.config/ghostty/config:\ntheme = my-theme\n```\n\n### Options\n\n| Option | Default | Description |\n| -------------- | ------------------ | ------------------------------------------------- |\n| `mapTheme` | _(required)_ | `(tokens) =>` theme, theme array, or theme record |\n| `outputPath` | `\"ghostty-themes\"` | Output directory for theme files |\n| `installGuide` | _(generated)_ | Override body for generated `INSTALL.md` |\n\n`mapTheme` return shapes: a single `GhosttyTheme`, an array, or a `Record`. Each theme needs a `name`. Map token colors into `palette` (0–15), `background`, `foreground`, `cursorColor`, `cursorText`, `selectionForeground`, `selectionBackground`, or pass extra Ghostty options via `config`.\n\n## Development\n\n### Building\n\nRun `nx build ghostty` to build the library.\n\n### Running unit tests\n\nRun `nx test ghostty` to execute the unit tests via [Vitest](https://vitest.dev/).\n\n\n\n\n\n\n## Storm Workspaces\n\nStorm workspaces are built using\nNx, a set of extensible dev tools\nfor monorepos, which helps you develop like Google, Facebook, and Microsoft.\nBuilding on top of Nx, the Open System provides a set of tools and patterns that\nhelp you scale your monorepo to many teams while keeping the codebase\nmaintainable.\n\n
\n \n\n## Roadmap\n\nSee the [open issues](https://github.com/storm-software/razorwind/issues) for\na list of proposed features (and known issues).\n\n- [Top Feature Requests](https://github.com/storm-software/razorwind/issues?q=label%3Aenhancement+is%3Aopen+sort%3Areactions-%2B1-desc)\n (Add your votes using the 👍 reaction)\n- [Top Bugs](https://github.com/storm-software/razorwind/issues?q=is%3Aissue+is%3Aopen+label%3Abug+sort%3Areactions-%2B1-desc)\n (Add your votes using the 👍 reaction)\n- [Newest Bugs](https://github.com/storm-software/razorwind/issues?q=is%3Aopen+is%3Aissue+label%3Abug)\n\n
\n \n\n## Support\n\nReach out to the maintainer at one of the following places:\n\n- [Contact](https://stormsoftware.com/contact)\n- [GitHub discussions](https://github.com/storm-software/razorwind/discussions)\n- \n\n
\n \n\n## License\n\nThis project is licensed under the **Apache License 2.0**. Feel free to edit and\ndistribute this template as you like.\n\nSee [LICENSE](LICENSE) for more information.\n\n
\n \n\n## Changelog\n\nThis project adheres to\n[Semantic Versioning](https://semver.org/spec/v2.0.0.html). Every release, along\nwith the migration instructions, is documented in the [CHANGELOG](CHANGELOG.md)\nfile\n\n
\n \n\n## Contributing\n\nFirst off, thanks for taking the time to contribute! Contributions are what\nmakes the open-source community such an amazing place to learn, inspire, and\ncreate. Any contributions you make will benefit everybody else and are **greatly\nappreciated**.\n\nPlease try to create bug reports that are:\n\n- _Reproducible._ Include steps to reproduce the problem.\n- _Specific._ Include as much detail as possible: which version, what\n environment, etc.\n- _Unique._ Do not duplicate existing opened issues.\n- _Scoped to a Single Bug._ One bug per report.\n\nPlease adhere to this project's [code of conduct](.github/CODE_OF_CONDUCT.md).\n\nYou can use\n[markdownlint-cli](https://github.com/storm-software/razorwind/markdownlint-cli)\nto check for common markdown style inconsistency.\n\n
\n\n\n\nThis project follows the\n[all-contributors](https://allcontributors.org/docs/en/emoji-key)\nspecification. Contributions of any kind welcome!\n\n
\n \n\nStorm Software is an open source software development organization and creator\nof Acidic, StormStack and StormCloud.\n\nOur mission is to make software development more accessible. Our ideal future is\none where anyone can create software without years of prior development\nexperience serving as a barrier to entry. We hope to achieve this via LLMs,\nGenerative AI, and intuitive, high-level data modeling/programming languages.\n\nJoin us on [Discord](https://discord.gg/MQ6YVzakM5) to chat with the team,\nreceive release notifications, ask questions, and get involved.\n\nIf this sounds interesting, and you would like to help us in creating the next\ngeneration of development tools, please reach out on our\n[website](https://stormsoftware.com/contact) or join our\n[Slack channel](https://join.slack.com/t/storm-software/shared_invite/zt-2gsmk04hs-i6yhK_r6urq0dkZYAwq2pA)!\n\n \n\n
![\"Razorwind\"](\"https://public.storm-cdn.com/razorwind/media/banner-1280x427-dark.gif\")
\n![\"Patrick](\"https://avatars.githubusercontent.com/u/99053093?v=4?s=100\")
![\"Tyler](\"https://avatars.githubusercontent.com/u/7265547?v=4?s=100\")
![\"Stormie\"/](\"https://avatars.githubusercontent.com/u/149802440?v=4?s=100\")
![\"All](\"https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg\"){kind=logo}
\n Add your contributions\n \n ![\"Storm](\"https://public.storm-cdn.com/storm-software/media/banner-1280x320-dark.webp\")
\n![\"Storm](\"https://public.storm-cdn.com/storm-software/icons/circle-dark.webp\"){kind=icon}
![\"Visit](\"https://public.storm-cdn.com/misc/text/visit-us-dark.png\")