\n \n \n\n\n```\n\n\n## Icons\n\nkempo-ui ships a small set of icons used internally by its components. The `` component can also serve icons from your own directory, so you can add project-specific icons alongside the built-in ones.\n\n### Interactive picker (for humans)\n\nRun a single command, type to filter, arrow keys to navigate, Enter to select:\n\n```bash\nnpx kempo-icon\n```\n\n### Finding an icon (for scripts/LLMs)\n\nSearch the full Material Symbols library by name or tag:\n\n```bash\nnpx kempo-listicons \n```\n\n```bash\nnpx kempo-listicons chevron\n# → chevron_right\n# chevron_left\n# keyboard_arrow_right\n# ...\n```\n\n### Downloading an icon\n\n```bash\nnpx kempo-geticon [custom_name] [--dir ] [-y]\n```\n\nBy default icons are saved to `icons/` in your project root. Use `--dir` to point to your own assets directory:\n\n```bash\n# Save to icons/ (default)\nnpx kempo-geticon format_bold\n\n# Save to a custom directory\nnpx kempo-geticon format_bold --dir src/assets/icons\n\n# Rename on download\nnpx kempo-geticon content_copy copy\n\n# Auto-accept directional icon prompt\nnpx kempo-geticon chevron_left -y\n```\n\n**Directional icons:** Material Symbols has separate icons for each direction (`chevron_left`, `chevron_right`, etc.). kempo-ui only stores the right-facing version and uses the `direction` attribute to rotate it, so you only need one file per icon. If you pass a non-right directional name, the script will prompt you to download the right-facing variant instead and save it under the base name.\n\n### Configuring icon directories\n\nTell kempo-ui where to look for icons in your page config. It checks directories in order and uses the first match, so your icons override the built-in ones:\n\n```html\n\n```\n\n### Using icons in markup\n\n```html\n\n\n\n```\n\n| `direction` | Rotation |\n|---|---|\n| *(omitted)* | 0° — right |\n| `down` | 90° |\n| `left` | 180° |\n| `up` | 270° |\n\n---\n\n## Documentation\n\n **Full Documentation**: [https://dustinpoissant.github.io/kempo-ui/](https://dustinpoissant.github.io/kempo-ui/)\n\nThe documentation includes:\n- Component API references\n- Interactive examples\n- Usage guides\n- Accessibility information\n- Customization options\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/dustinpoissant/kempo-ui.git\ncd kempo-ui\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm run docs\n\n# Run tests\nnpm test\n\n# Build for production\nnpm run build\n```\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details on:\n\n- Setting up your development environment\n- Code style and conventions\n- Testing guidelines\n- Pull request process\n\n## License\n\nThis work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 2.0 Generic License](https://creativecommons.org/licenses/by-nc-sa/2.0/) - see the [LICENSE.md](LICENSE.md) file for details.\n\nBuilt using [Lit](https://lit.dev/)\n","readmeFilename":"README.md"}