feat(cli): scaffold spinner, shell completion docs, Spanish contributing

- Rich progress spinner around the scaffold phase on interactive TTYs
  only (disabled in CI/pipes/--json) (closes #269)
- docs/SHELL_COMPLETION.md: install + per-shell setup for the built-in
  Typer completion (closes #270)
- CONTRIBUTING.es.md: condensed Spanish onboarding translation,
  English stays source of truth (closes #265)

Author: ulises-jeremias

CONTRIBUTING.es.md

@@ -0,0 +1,41 @@
+# Contribuir a Create Awesome Python App (resumen en español)
+
+> El inglés es la fuente de verdad. Esta es una traducción condensada de las
+> secciones de incorporación de `CONTRIBUTING.md`.
+
+Gracias por contribuir. Sigue el
+[Código de Conducta](./.github/CODE_OF_CONDUCT.md).
+
+## Desarrollo local
+
+```bash
+git clone https://github.com/Create-Python-App/create-python-app.git
+cd create-python-app
+uv sync --group dev
+uv run pre-commit install
+make test
+make lint
+make typecheck
+```
+
+## Probar con fixtures (sin red)
+
+El CLI puede funcionar sin conexión con el catálogo de fixtures:
+
+```bash
+uv run create-awesome-python-app --fixture . --list-templates
+```
+
+## Pull requests
+
+1. Crea tu rama desde `main`.
+2. Cambios enfocados; enlaza el issue correspondiente.
+3. Usa [Conventional Commits](https://www.conventionalcommits.org/) (mensajes en inglés).
+4. Asegúrate de que pasen los tests, el lint (`ruff`) y los tipos (`pyright`).
+5. Completa la plantilla del PR (en inglés).
+
+## Dónde vive cada cosa
+
+- Motor del CLI: `packages/`.
+- Plantillas y extensiones: [`cpa-templates`](https://github.com/Create-Python-App/cpa-templates).
+- Documentación del sitio: [`website`](https://github.com/Create-Python-App/website).

docs/SHELL_COMPLETION.md

@@ -0,0 +1,36 @@
+# Shell completion
+
+`create-awesome-python-app` ships tab completion via Typer (bash, zsh, fish,
+PowerShell). Completion covers flags and the `cache` subcommands; catalog
+values (template slugs) are intentionally not completed yet.
+
+## Quick install
+
+```bash
+# Detect the current shell from $SHELL and install
+create-awesome-python-app --install-completion
+```
+
+Restart the shell (or `exec "$SHELL" -l`) so the new script loads.
+
+## Manual install per shell
+
+```bash
+# bash — append to ~/.bashrc
+create-awesome-python-app --show-completion >> ~/.bash_completion
+# zsh — needs compinit; save to a fpath entry
+create-awesome-python-app --show-completion > ~/.zfunc/_create-awesome-python-app
+# fish
+create-awesome-python-app --show-completion > ~/.config/fish/completions/create-awesome-python-app.fish
+# PowerShell — append to $PROFILE
+create-awesome-python-app --show-completion >> $PROFILE
+```
+
+If you see `Shell sh not supported`, export a real shell first
+(`export SHELL=/bin/bash`) — completion detection reads `$SHELL`.
+
+## uvx users
+
+Completion attaches to the shell, not the installer, so it works the same
+under `uvx create-awesome-python-app`. Run `--install-completion` once with
+any installed copy.

packages/create-awesome-python-app/src/create_awesome_python_app/cli.py

@@ -5,6 +5,7 @@
 import asyncio
 import os
 import sys
+from contextlib import contextmanager
 from pathlib import Path
 from typing import Any
 
@@ -166,6 +167,21 @@ def _in_ci() -> bool:
     return os.environ.get("CI", "").lower() in {"1", "true", "yes"}
 
 
+def _spinner_enabled(*, interactive: bool) -> bool:
+    """Progress spinner on interactive TTYs only (never CI/pipes/--json)."""
+    return bool(interactive) and sys.stderr.isatty() and not _in_ci()
+
+
+@contextmanager
+def _phase_status(message: str, *, enabled: bool):
+    """Rich status spinner on stderr while a long phase runs (no-op when disabled)."""
+    if not enabled:
+        yield
+        return
+    with console.status(f"[cyan]{message}[/cyan]", spinner="dots"):
+        yield
+
+
 def _template_config_path(source_subdir: str | None, root: Path) -> Path:
     cfg_path = root / "cpa.config.json"
     if not cfg_path.is_file() and source_subdir:
@@ -575,25 +591,27 @@ def scaffold(
             raise typer.Exit(1)
         console.print(f"[yellow]{msg}[/yellow]")
 
+    show_progress = _spinner_enabled(interactive=want_interactive)
     try:
-        asyncio.run(
-            create_python_app(
-                target_directory,
-                {
-                    "template": template,
-                    "addons": addons or [],
-                    "extend": extend or [],
-                    "install": not no_install,
-                    "force": force,
-                    "verbose": verbose,
-                    "offline": offline,
-                    "refresh": effective_refresh,
-                    "keep_on_failure": keep_on_failure,
-                    "cache_dir": str(cache_dir) if cache_dir else None,
-                    "set": set_map,
-                },
+        with _phase_status("Scaffolding project…", enabled=show_progress):
+            asyncio.run(
+                create_python_app(
+                    target_directory,
+                    {
+                        "template": template,
+                        "addons": addons or [],
+                        "extend": extend or [],
+                        "install": not no_install,
+                        "force": force,
+                        "verbose": verbose,
+                        "offline": offline,
+                        "refresh": effective_refresh,
+                        "keep_on_failure": keep_on_failure,
+                        "cache_dir": str(cache_dir) if cache_dir else None,
+                        "set": set_map,
+                    },
+                )
             )
-        )
     except NonEmptyTargetDirectoryError as err:
         # Safety net if the target fills up after the early check (e.g. during
         # a long interactive session).

packages/create-awesome-python-app/tests/test_spinner.py

@@ -0,0 +1,35 @@
+"""Tests for the scaffold progress spinner (#269)."""
+
+from __future__ import annotations
+
+import pytest
+from create_awesome_python_app.cli import _phase_status, _spinner_enabled
+
+
+def test_spinner_disabled_without_interactive(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr("sys.stderr.isatty", lambda: True)
+    monkeypatch.delenv("CI", raising=False)
+    assert _spinner_enabled(interactive=False) is False
+
+
+def test_spinner_disabled_in_ci(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr("sys.stderr.isatty", lambda: True)
+    monkeypatch.setenv("CI", "1")
+    assert _spinner_enabled(interactive=True) is False
+
+
+def test_spinner_disabled_without_tty(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr("sys.stderr.isatty", lambda: False)
+    monkeypatch.delenv("CI", raising=False)
+    assert _spinner_enabled(interactive=True) is False
+
+
+def test_spinner_enabled_on_interactive_tty(monkeypatch: pytest.MonkeyPatch) -> None:
+    monkeypatch.setattr("sys.stderr.isatty", lambda: True)
+    monkeypatch.delenv("CI", raising=False)
+    assert _spinner_enabled(interactive=True) is True
+
+
+def test_phase_status_noop_when_disabled() -> None:
+    with _phase_status("Working…", enabled=False):
+        pass