hueman-cli 0.2.0__py3-none-any.whl

hueman/templates/qutebrowser_theme.py.j2

@@ -0,0 +1,78 @@
+# Generado por hueman — no editar a mano, se sobreescribe en cada `hueman set`.
+"""Theme 'current' — generado por hueman desde la paleta activa (sección polybar)"""
+
+theme_colors = {
+    'completion_category_bg':            "{{ background }}",
+    'completion_category_border_bottom': "{{ background }}",
+    'completion_category_border_top':    "{{ background }}",
+    'completion_category_fg':            "{{ primary }}",
+    'completion_even_bg':                "{{ background }}",
+    'completion_odd_bg':                 "{{ background_alt }}",
+    'completion_fg':                     "{{ foreground }}",
+    'completion_selected_bg':            "{{ background_alt }}",
+    'completion_selected_border_bottom': "{{ background_alt }}",
+    'completion_selected_border_top':    "{{ background_alt }}",
+    'completion_selected_fg':            "{{ secondary }}",
+    'completion_match_fg':               "{{ secondary }}",
+    'completion_scrollbar_bg':           "{{ background }}",
+    'completion_scrollbar_fg':           "{{ primary }}",
+    'downloads_bar_bg':                  "{{ background }}",
+    'downloads_error_bg':                "{{ alert }}",
+    'downloads_error_fg':                "{{ foreground }}",
+    'downloads_stop_bg':                 "{{ success }}",
+    'downloads_system_bg':               'none',
+    'hints_bg':                          "{{ primary }}",
+    'hints_fg':                          "{{ foreground }}",
+    'hints_match_fg':                    "{{ secondary }}",
+    'keyhint_bg':                        "{{ background }}",
+    'keyhint_fg':                        "{{ foreground }}",
+    'keyhint_suffix_fg':                 "{{ warning }}",
+    'messages_error_bg':                 "{{ alert }}",
+    'messages_error_border':             "{{ alert }}",
+    'messages_error_fg':                 "{{ foreground }}",
+    'messages_info_bg':                  "{{ muted }}",
+    'messages_info_border':              "{{ muted }}",
+    'messages_info_fg':                  "{{ foreground }}",
+    'messages_warning_bg':               "{{ warning }}",
+    'messages_warning_border':           "{{ warning }}",
+    'messages_warning_fg':               "{{ background }}",
+    'prompts_bg':                        "{{ background }}",
+    'prompts_border':                    "1px solid {{ primary }}",
+    'prompts_fg':                        "{{ foreground }}",
+    'prompts_selected_bg':               "{{ background_alt }}",
+    'statusbar_caret_bg':                "{{ primary }}",
+    'statusbar_caret_fg':                "{{ background }}",
+    'statusbar_caret_selection_bg':      "{{ primary }}",
+    'statusbar_caret_selection_fg':      "{{ background }}",
+    'statusbar_command_bg':              "{{ background }}",
+    'statusbar_command_fg':              "{{ foreground }}",
+    'statusbar_command_private_bg':      "{{ background }}",
+    'statusbar_command_private_fg':      "{{ foreground }}",
+    'statusbar_insert_bg':               "{{ success }}",
+    'statusbar_insert_fg':               "{{ background }}",
+    'statusbar_normal_bg':               "{{ background }}",
+    'statusbar_normal_fg':               "{{ foreground }}",
+    'statusbar_passthrough_bg':          "{{ secondary }}",
+    'statusbar_passthrough_fg':          "{{ background }}",
+    'statusbar_private_bg':              "{{ background_alt }}",
+    'statusbar_private_fg':              "{{ foreground }}",
+    'statusbar_progress_bg':             "{{ primary }}",
+    'statusbar_url_error_fg':            "{{ alert }}",
+    'statusbar_url_fg':                  "{{ foreground }}",
+    'statusbar_url_hover_fg':            "{{ secondary }}",
+    'statusbar_url_success_http_fg':     "{{ foreground }}",
+    'statusbar_url_success_https_fg':    "{{ success }}",
+    'statusbar_url_warn_fg':             "{{ warning }}",
+    'tabs_bar_bg':                       "{{ background }}",
+    'tabs_even_bg':                      "{{ background_alt }}",
+    'tabs_even_fg':                      "{{ foreground }}",
+    'tabs_odd_bg':                       "{{ background_alt }}",
+    'tabs_odd_fg':                       "{{ foreground }}",
+    'tabs_indicator_error':              "{{ alert }}",
+    'tabs_indicator_system':             'none',
+    'tabs_selected_even_bg':             "{{ background }}",
+    'tabs_selected_even_fg':             "{{ primary }}",
+    'tabs_selected_odd_bg':              "{{ background }}",
+    'tabs_selected_odd_fg':              "{{ primary }}",
+    'webpage_bg':                        "{{ background }}",
+}

hueman/templates/rofi_theme.rasi.j2

@@ -0,0 +1,132 @@
+/* Generado por hueman — no editar a mano, se sobreescribe en cada `hueman set`. */
+* {
+    bg:           {{ background }};
+    bg-alt:       {{ background_alt }};
+    fg:           {{ foreground }};
+    accent:       {{ primary }};
+    accent-alt:   {{ secondary }};
+    accent-text:     {{ primary | contrast }};
+    accent-alt-text: {{ secondary | contrast }};
+}
+
+window {
+    background-color: @bg;
+    border:           2px;
+    border-color:     @accent;
+    padding:          14px;
+    border-radius:    20px;
+}
+
+mainbox {
+    background-color: @bg;
+    border: 0px;
+    padding: 0px;
+    spacing: 10px;
+}
+
+message {
+    background-color: @bg-alt;
+    text-color: @fg;
+    border-radius: 12px;
+    padding: 8px;
+}
+
+textbox {
+    background-color: @bg;
+    text-color: @fg;
+}
+
+error-message {
+    background-color: @bg-alt;
+    text-color: @accent;
+    border-radius: 12px;
+    padding: 10px;
+}
+
+inputbar {
+    background-color: @bg-alt;
+    text-color: @fg;
+    padding: 10px 14px;
+    border-radius: 14px;
+    border: 1px;
+    border-color: @accent;
+}
+
+entry {
+    background-color: transparent;
+    text-color: @fg;
+    placeholder-color: @bg-alt;
+}
+
+prompt {
+    background-color: transparent;
+    text-color: @accent-alt;
+}
+
+case-indicator {
+    background-color: transparent;
+    text-color: @fg;
+}
+
+listview {
+    background-color: @bg;
+    lines: 10;
+    padding: 8px 0px;
+    spacing: 4px;
+    scrollbar: true;
+    scrollbar-width: 4px;
+    fixed-height: 0;
+}
+
+scrollbar {
+    background-color: @bg-alt;
+    handle-color: @accent;
+    border-radius: 8px;
+}
+
+mode-switcher {
+    background-color: @bg-alt;
+    text-color: @fg;
+    border-radius: 12px;
+    spacing: 4px;
+}
+
+button {
+    background-color: @bg-alt;
+    text-color: @fg;
+    border-radius: 10px;
+    padding: 6px;
+}
+
+button selected {
+    background-color: @accent;
+    text-color: @accent-text;
+    border-radius: 10px;
+}
+
+element {
+    background-color: @bg;
+    text-color: @fg;
+    padding: 8px 10px;
+    border-radius: 12px;
+}
+
+element-icon {
+    background-color: transparent;
+    size: 1.2em;
+}
+
+element-text {
+    background-color: transparent;
+    text-color: inherit;
+}
+
+element selected {
+    background-color: @accent;
+    text-color: @accent-text;
+    border-radius: 12px;
+}
+
+element-text selected {
+    text-color: inherit;
+}

hueman/templates/sshub_theme.toml.j2

@@ -0,0 +1,49 @@
+# Generado por hueman — no editar a mano, se sobreescribe en cada `hueman set`.
+# SSHub usa el tema `current` configurado en ~/.config/sshub/config.toml.
+schema_version = 1
+extends = "default"
+name = "Auto"
+description = "Tema generado por hueman desde la paleta {{ theme_name }}"
+
+[palette]
+background = "{{ background }}"
+background_alt = "{{ background_alt }}"
+foreground = "{{ foreground }}"
+primary = "{{ primary }}"
+secondary = "{{ secondary }}"
+alert = "{{ alert }}"
+success = "{{ success }}"
+warning = "{{ warning }}"
+muted = "{{ muted }}"
+
+[semantic]
+background = "palette.background"
+canvas = "palette.background"
+surface = "palette.background_alt"
+surface_raised = "palette.background_alt"
+
+border = "palette.muted"
+border_focus = "palette.primary"
+border_popup = "palette.secondary"
+
+text = "palette.foreground"
+text_bright = "palette.foreground"
+text_highlight = "palette.foreground"
+text_muted = "palette.muted"
+text_dim = "palette.muted"
+text_inverse = "palette.background"
+
+accent = "palette.primary"
+selection_bg = "palette.primary"
+selection_fg = "palette.background"
+
+success = "palette.success"
+warning = "palette.warning"
+error = "palette.alert"
+info = "palette.secondary"
+connecting = "palette.primary"
+exited = "palette.alert"
+unknown = "palette.muted"
+
+pty_background = "palette.background"
+pty_foreground = "palette.foreground"

hueman/templates/starship_block.toml.j2

@@ -0,0 +1,11 @@
+# --- Bloque gestionado por hueman: no editar a mano ---
+[palettes.dotfiles]
+background = "{{ background }}"
+background_alt = "{{ background_alt }}"
+foreground = "{{ foreground }}"
+primary = "{{ primary }}"
+secondary = "{{ secondary }}"
+alert = "{{ alert }}"
+success = "{{ success }}"
+warning = "{{ warning }}"
+muted = "{{ muted }}"

hueman/templates/termux_colors.properties.j2

@@ -0,0 +1,20 @@
+# Generado por hueman - no editar a mano, se sobreescribe en cada `hueman set`.
+foreground={{ foreground }}
+background={{ background }}
+cursor={{ cursor }}
+color0={{ color0 }}
+color1={{ color1 }}
+color2={{ color2 }}
+color3={{ color3 }}
+color4={{ color4 }}
+color5={{ color5 }}
+color6={{ color6 }}
+color7={{ color7 }}
+color8={{ color8 }}
+color9={{ color9 }}
+color10={{ color10 }}
+color11={{ color11 }}
+color12={{ color12 }}
+color13={{ color13 }}
+color14={{ color14 }}
+color15={{ color15 }}

hueman/templates/tmux.conf.j2

@@ -0,0 +1,33 @@
+# Generado por hueman — no editar a mano, se sobreescribe en cada `hueman set`.
+set -g status-style "bg={{ status_bg }},fg={{ status_fg }}"
+set -g pane-border-style "fg={{ pane_border_fg }}"
+set -g pane-active-border-style "fg={{ pane_active_border_fg }}"
+set -g message-style "bg={{ message_bg | default(status_bg) }},fg={{ message_fg | default(status_fg) }}"
+set -g message-command-style "bg={{ message_bg | default(status_bg) }},fg={{ message_fg | default(status_fg) }}"
+set -g mode-style "bg={{ mode_bg | default(pane_active_border_fg) }},fg={{ mode_fg | default(status_bg) }}"
+
+set -g status-left-length 50
+set -g status-right-length 120
+
+set -g status-left "\
+#[fg={{ segment_session_fg }},bg={{ segment_session_bg }},bold] 🖳 #S \
+#[fg={{ segment_session_bg }},bg={{ status_bg }}] "
+
+set -g status-right "\
+#[fg={{ separator_fg }}]│\
+#[fg={{ segment_time_fg }}] 󰃰 %H:%M \
+#[fg={{ separator_fg }}]│\
+#[fg={{ segment_date_fg }}] 󰃶 %d-%b \
+#[fg={{ separator_fg }}]│\
+#[fg={{ segment_user_fg }}]  #(whoami) \
+#[fg={{ separator_fg }}]│\
+#[fg={{ segment_battery_fg }}] #(~/.battery) \
+#[fg={{ separator_fg }}]│\
+#{?window_zoomed_flag,#[fg={{ segment_alert_fg }}] zoom ,}"
+
+setw -g window-status-format "#[fg={{ window_inactive_fg }},bg={{ status_bg }}] #I #[fg={{ segment_session_bg }}]#W "
+setw -g window-status-current-format "#[fg={{ status_bg }},bg={{ segment_session_bg }},bold] #I #W "
+
+setw -g monitor-activity off
+set -g visual-activity off
+setw -g monitor-bell off

hueman/templates/tuicr_theme.toml.j2

@@ -0,0 +1,51 @@
+# Generado por hueman — no editar a mano, se sobreescribe en cada `hueman set`.
+# Activar con `theme = "current"` en ~/.config/tuicr/config.toml o `tuicr --theme current`.
+panel_bg = "{{ background }}"
+bg_highlight = "{{ background_alt }}"
+fg_primary = "{{ foreground }}"
+fg_secondary = "{{ muted }}"
+fg_dim = "{{ muted }}"
+
+diff_add = "{{ success }}"
+diff_add_bg = "{{ background_alt }}"
+diff_del = "{{ alert }}"
+diff_del_bg = "{{ background_alt }}"
+diff_context = "{{ foreground }}"
+diff_hunk_header = "{{ secondary }}"
+expanded_context_fg = "{{ muted }}"
+
+syntax_add_bg = "{{ background_alt }}"
+syntax_del_bg = "{{ background_alt }}"
+
+file_added = "{{ success }}"
+file_modified = "{{ warning }}"
+file_deleted = "{{ alert }}"
+file_renamed = "{{ secondary }}"
+
+reviewed = "{{ success }}"
+pending = "{{ warning }}"
+
+comment_note = "{{ secondary }}"
+comment_suggestion = "{{ primary }}"
+comment_issue = "{{ alert }}"
+comment_praise = "{{ success }}"
+
+border_focused = "{{ primary }}"
+border_unfocused = "{{ background_alt }}"
+status_bar_bg = "{{ background_alt }}"
+cursor_color = "{{ primary }}"
+cursor_line_bg = "{{ background_alt }}"
+branch_name = "{{ secondary }}"
+help_indicator = "{{ muted }}"
+
+message_info_fg = "{{ primary | contrast }}"
+message_info_bg = "{{ primary }}"
+message_warning_fg = "{{ warning | contrast }}"
+message_warning_bg = "{{ warning }}"
+message_error_fg = "{{ alert | contrast }}"
+message_error_bg = "{{ alert }}"
+update_badge_fg = "{{ warning | contrast }}"
+update_badge_bg = "{{ warning }}"
+
+mode_fg = "{{ primary | contrast }}"
+mode_bg = "{{ primary }}"

hueman/templates/wezterm_colors.lua.j2

@@ -0,0 +1,14 @@
+config.colors = {
+	foreground = "{{ foreground }}",
+	background = "{{ background }}",
+
+	cursor_bg = "{{ cursor }}",
+	cursor_fg = "{{ cursor_text_color }}",
+	cursor_border = "{{ cursor }}",
+
+	selection_fg = "{{ selection_foreground }}",
+	selection_bg = "{{ selection_background }}",
+
+	ansi = { "{{ color0 }}", "{{ color1 }}", "{{ color2 }}", "{{ color3 }}", "{{ color4 }}", "{{ color5 }}", "{{ color6 }}", "{{ color7 }}" },
+	brights = { "{{ color8 }}", "{{ color9 }}", "{{ color10 }}", "{{ color11 }}", "{{ color12 }}", "{{ color13 }}", "{{ color14 }}", "{{ color15 }}" },
+}

hueman/templates/windhawk_taskbar.json.j2

@@ -0,0 +1,4 @@
+{
+  "fill": "{{ background }}",
+  "text": "{{ primary }}"
+}

hueman/templates/yazi_theme.toml.j2

@@ -0,0 +1,130 @@
+# Generado por hueman — no editar a mano, se sobreescribe en cada `hueman set`.
+# A TOML linter such as https://taplo.tamasfe.dev/ can use this schema to validate your config.
+# If you encounter any issues, please make an issue at https://github.com/yazi-rs/schemas.
+
+[mgr]
+cwd = { fg = "{{ primary }}" }
+
+# Hovered
+hovered = { fg = "{{ background }}", bg = "{{ secondary }}" }
+preview_hovered = { underline = true }
+
+# Find
+find_keyword = { fg = "{{ warning }}", italic = true }
+find_position = { fg = "{{ secondary }}", bg = "reset", italic = true }
+
+# Marker
+marker_selected = { fg = "{{ success }}", bg = "{{ success }}" }
+marker_copied = { fg = "{{ warning }}", bg = "{{ warning }}" }
+marker_cut = { fg = "{{ alert }}", bg = "{{ alert }}" }
+
+# Tab
+tab_active = { fg = "{{ background }}", bg = "{{ secondary }}" }
+tab_inactive = { fg = "{{ foreground }}", bg = "{{ background_alt }}" }
+tab_width = 1
+
+# Border
+border_symbol = "│"
+border_style = { fg = "{{ muted }}" }
+
+# Highlighting
+syntect_theme = ""
+
+[status]
+separator_open = ""
+separator_close = ""
+separator_style = { fg = "{{ muted }}", bg = "{{ muted }}" }
+
+# Mode
+mode_normal = { fg = "{{ background }}", bg = "{{ secondary }}", bold = true }
+mode_select = { fg = "{{ background }}", bg = "{{ success }}", bold = true }
+mode_unset = { fg = "{{ background }}", bg = "{{ warning }}", bold = true }
+
+# Progress
+progress_label = { fg = "{{ foreground }}", bold = true }
+progress_normal = { fg = "{{ secondary }}", bg = "{{ background }}" }
+progress_error = { fg = "{{ alert }}", bg = "{{ background }}" }
+
+# Permissions
+permissions_t = { fg = "{{ success }}" }
+permissions_r = { fg = "{{ warning }}" }
+permissions_w = { fg = "{{ alert }}" }
+permissions_x = { fg = "{{ primary }}" }
+permissions_s = { fg = "{{ muted }}" }
+
+[input]
+border = { fg = "{{ secondary }}" }
+title = { fg = "{{ foreground }}" }
+value = { fg = "{{ warning }}" }
+selected = { reversed = true }
+
+[select]
+border = { fg = "{{ secondary }}" }
+active = { fg = "{{ secondary }}" }
+inactive = { fg = "{{ muted }}" }
+
+[tasks]
+border = { fg = "{{ secondary }}" }
+title = { fg = "{{ foreground }}" }
+hovered = { underline = true }
+
+[which]
+mask = { bg = "{{ background }}" }
+cand = { fg = "{{ primary }}" }
+rest = { fg = "{{ muted }}" }
+desc = { fg = "{{ secondary }}" }
+separator = "  "
+separator_style = { fg = "{{ muted }}" }
+
+[help]
+on = { fg = "{{ secondary }}" }
+exec = { fg = "{{ primary }}" }
+desc = { fg = "{{ muted }}" }
+hovered = { bg = "{{ background_alt }}", bold = true }
+footer = { fg = "{{ background }}", bg = "{{ foreground }}" }
+
+[notify]
+title_info = { fg = "{{ success }}" }
+title_warn = { fg = "{{ warning }}" }
+title_error = { fg = "{{ alert }}" }
+
+# : file, 1: symlink, 2: hardlink, 3: orphaned
+[filetype]
+
+rules = [
+	# Images
+	{ mime = "image/*", fg = "{{ primary }}" },
+
+	# Videos
+	{ mime = "video/*", fg = "{{ warning }}" },
+	{ mime = "audio/*", fg = "{{ warning }}" },
+
+	# Archives
+	{ mime = "application/zip", fg = "{{ secondary }}" },
+	{ mime = "application/gzip", fg = "{{ secondary }}" },
+	{ mime = "application/x-tar", fg = "{{ secondary }}" },
+	{ mime = "application/x-bzip", fg = "{{ secondary }}" },
+	{ mime = "application/x-bzip2", fg = "{{ secondary }}" },
+	{ mime = "application/x-7z-compressed", fg = "{{ secondary }}" },
+	{ mime = "application/x-rar", fg = "{{ secondary }}" },
+	{ mime = "application/xz", fg = "{{ secondary }}" },
+
+	# Documents
+	{ mime = "application/doc", fg = "{{ success }}" },
+	{ mime = "application/pdf", fg = "{{ success }}" },
+	{ mime = "application/rtf", fg = "{{ success }}" },
+	{ mime = "application/vnd.*", fg = "{{ success }}" },
+
+	# Text
+	{ mime = "text/*", fg = "{{ success }}" },
+
+	# Empty files
+	{ mime = "inode/x-empty", fg = "{{ alert }}" },
+
+	# Special files
+	{ url = "*", is = "orphan", bg = "{{ alert }}" },
+	{ url = "*", is = "exec", fg = "{{ primary }}" },
+
+	# Fallback
+	{ url = "*/", fg = "{{ primary }}" }
+]

hueman/templates/zen_theme.json.j2

@@ -0,0 +1,11 @@
+{
+  "name": "{{ theme_name }}",
+  "background": "{{ background }}",
+  "background_alt": "{{ background_alt }}",
+  "foreground": "{{ foreground }}",
+  "primary": "{{ primary }}",
+  "success": "{{ success }}",
+  "warning": "{{ warning }}",
+  "alert": "{{ alert }}",
+  "muted": "{{ muted }}"
+}

hueman_cli-0.2.0.dist-info/METADATA

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: hueman-cli
+Version: 0.2.0
+Summary: Centralized theme manager: one YAML palette feeds Jinja2 templates that generate each tool's config.
+Author: 4DRIAN0RTIZ
+License-Expression: MIT
+Project-URL: Homepage, https://hueman.cuevaneander.tech
+Project-URL: Source, https://github.com/NeanderTeam/hueman
+Project-URL: Issues, https://github.com/NeanderTeam/hueman/issues
+Keywords: theme,colors,palette,dotfiles,jinja2,terminal,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Desktop Environment
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Jinja2>=3.1.6
+Requires-Dist: PyYAML>=6.0.1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Dynamic: license-file
+
+# hueman
+
+Gestor centralizado de temas: una **paleta de color (YAML)** alimenta
+**templates Jinja2** que generan la configuración real de tus herramientas
+(kitty, tmux, nvim, starship, Windows Terminal, lo que declares en tu propio
+config). Sin dependencias de ningún gestor de dotfiles: todo el mapeo de rutas
+de salida vive en un `hueman.config.yaml` propio, fuera de este repo.
+
+## Quickstart
+
+```sh
+pipx install hueman-cli                               # o: pip install hueman-cli
+hueman init                                           # escribe un config de ejemplo en ~/.config/hueman/config.yaml
+# ajusta tus targets en ese archivo, luego:
+hueman set <paleta> --dry-run
+hueman set <paleta>
+```
+
+Desde el código fuente (requiere Python >= 3.9):
+
+```sh
+git clone https://github.com/NeanderTeam/hueman.git
+cd hueman && pip install -e .
+```
+
+Actualizar: `pipx upgrade hueman-cli` (o `pip install -U hueman-cli`).
+Desinstalar: `pipx uninstall hueman-cli` (o `pip uninstall hueman-cli`); tu config
+y los archivos generados no se borran (detalle en la
+[guía de instalación](https://hueman.cuevaneander.tech/?p=install)).
+
+Otros comandos: `init` (config de ejemplo), `list` (paletas), `status` (tema activo) y `sync` (estado
+compartido entre máquinas).
+
+## Ideas centrales
+
+- Una paleta, muchos targets; el mapeo de salidas es declarativo.
+- Templates y paletas empaquetados son defaults; los directorios custom ganan.
+- `overwrite` para archivos generados enteros, `patch` para bloques dentro de
+  configs editadas a mano.
+- `reload` por target y `post_apply` global, best-effort, con política
+  `warn` / `error`.
+- Sync opcional de la paleta activa entre máquinas (`state_sync`).
+- Agregar una tool nueva es un template + un target, no un cambio al motor.
+
+## Herramientas empaquetadas
+
+`hueman/palettes/` y `hueman/templates/` traen 25 paletas estéticas genéricas y templates
+para las herramientas más comunes (kitty, tmux, polybar, nvim/nightfox, dunst,
+bspwm, yazi, qutebrowser, rofi, fzf, atuin, oh-my-posh, wezterm, starship,
+Termux). Para targets idiosincráticos usa `template_dirs` en tu config en vez
+de pedir que se agreguen aquí.
+
+## Documentación
+
+Documentación completa: **[hueman.cuevaneander.tech](https://hueman.cuevaneander.tech)**
+
+Para verla en local (las fuentes están en `website/`):
+
+```sh
+python3 -m http.server 8765 --directory website
+```
+
+y abre `http://localhost:8765`.
+
+## Soporte
+
+¿Un bug o una idea? Abre un issue en
+[github.com/NeanderTeam/hueman/issues](https://github.com/NeanderTeam/hueman/issues).
+
+## Estructura del repo
+
+| Ruta | Contenido |
+|---|---|
+| `hueman/cli.py` | CLI y orquestación (comando `hueman`) |
+| `hueman/engine/` | Config, paletas, targets, render, reload, estado compartido |
+| `hueman/palettes/`, `hueman/templates/` | Paletas YAML y plantillas Jinja2 empaquetadas |
+| `hueman/data/hueman.config.example.yaml` | Ejemplo comentado de config externa (lo escribe `hueman init`) |
+| `tests/` | Suite de tests |
+| `website/` | Sitio de documentación |
+
+El repo es autocontenido: nada dentro importa código fuera de sí mismo, salvo
+el config externo que cada usuario provee. Un repo de dotfiles solo necesita
+tener `hueman` instalado y su propio `hueman.config.yaml`.
+
+## Licencia
+
+MIT, ver [LICENSE](LICENSE).