feat(download): auto .gitignore in managed .django_tailwind_cli/ dir

The downloaded CLI binary and auto-generated source.css should never
end up in the user's repo, but that puts the burden on every project
to remember a manual `.gitignore` entry. Drop a single-line `*`
.gitignore into the managed directory on first use. Git's own rules
then ignore everything in the folder including the .gitignore itself,
so `git add .` silently skips the whole thing with zero user action.

Gated on TAILWIND_CLI_PATH being unset — we only manage the default
path. Existing .gitignore files are preserved so a user who went out
of their way to customize things isn't surprised.

Author: oliverandrich

CHANGELOG.md

@@ -13,6 +13,7 @@
 
 ### 🛠️ Developer Experience
 - **Gitignore cleanup**: Trimmed `.gitignore` to project-relevant entries only
+- **Managed `.django_tailwind_cli/` is now git-ignored by default**: On first use the directory gets a `.gitignore` containing `*`, so the downloaded CLI binary and the auto-generated `source.css` are silently skipped by `git add .` without any project-level `.gitignore` tweak from the user. Existing `.gitignore` files in that directory are preserved. No-op when `TAILWIND_CLI_PATH` points at a custom location.
 
 ### 🐛 Bug Fixes
 - **Tox matrix**: Django 4.2/5.2/6.0 factors in `tox.ini` were ignored because `uv sync --locked` reinstalled Django from `uv.lock` after tox's `deps`. The matrix now excludes Django from the sync and installs the factor-specific version via `commands_pre`, so `just test-all` actually covers all supported Django versions.

src/django_tailwind_cli/management/commands/tailwind.py

@@ -1225,6 +1225,29 @@ def _setup_tailwind_environment_with_verbose(*, verbose: bool = False) -> None:
         typer.secho("⚙️  Setting up Tailwind environment...", fg=typer.colors.CYAN)
     _download_cli_with_verbose(verbose=verbose)
     _create_standard_config_with_verbose(verbose=verbose)
+    _ensure_default_gitignore()
+
+
+def _ensure_default_gitignore() -> None:
+    """Drop a single-star .gitignore into the managed `.django_tailwind_cli/` dir.
+
+    The pattern ``*`` ignores every file in the directory — including the
+    .gitignore itself — so ``git add .`` silently skips the whole folder
+    without the user having to touch their project-level .gitignore.
+
+    Only acts when ``TAILWIND_CLI_PATH`` is unset (default mode). Custom
+    paths are left alone: we don't own them and a stray .gitignore there
+    could conflict with whatever the user is doing.
+    """
+    if getattr(settings, "TAILWIND_CLI_PATH", None):
+        return
+    default_dir = Path(settings.BASE_DIR) / ".django_tailwind_cli"
+    if not default_dir.exists():
+        return
+    gitignore = default_dir / ".gitignore"
+    if gitignore.exists():
+        return  # Respect whatever the user put there
+    gitignore.write_text("*\n")
 
 
 def _should_rebuild_css(src_css: Path, dist_css: Path) -> bool:

tests/test_management_commands.py

@@ -676,6 +676,66 @@ def mock_download(
         assert f'@source "{editable_app}";' in written
 
 
+class TestDefaultGitignore:
+    """Tests for _ensure_default_gitignore() — the auto .gitignore drop-in."""
+
+    def test_ensure_default_gitignore_creates_star_file(self, settings: LazySettings, tmp_path: Path):
+        """In default mode the helper writes '*\\n' into .django_tailwind_cli/.gitignore."""
+        from django_tailwind_cli.management.commands.tailwind import _ensure_default_gitignore
+
+        settings.BASE_DIR = tmp_path
+        # TAILWIND_CLI_PATH intentionally not set → default mode
+        default_dir = tmp_path / ".django_tailwind_cli"
+        default_dir.mkdir()
+
+        _ensure_default_gitignore()
+
+        gitignore = default_dir / ".gitignore"
+        assert gitignore.exists()
+        assert gitignore.read_text() == "*\n"
+
+    def test_ensure_default_gitignore_skipped_for_custom_path(self, settings: LazySettings, tmp_path: Path):
+        """With a custom TAILWIND_CLI_PATH, the helper is a no-op."""
+        from django_tailwind_cli.management.commands.tailwind import _ensure_default_gitignore
+
+        settings.BASE_DIR = tmp_path
+        settings.TAILWIND_CLI_PATH = str(tmp_path / "custom" / "tailwindcss")
+
+        # The default dir can still exist from a previous run — the helper
+        # should leave it alone when a custom path is active.
+        default_dir = tmp_path / ".django_tailwind_cli"
+        default_dir.mkdir()
+
+        _ensure_default_gitignore()
+
+        assert not (default_dir / ".gitignore").exists()
+
+    def test_ensure_default_gitignore_preserves_existing_file(self, settings: LazySettings, tmp_path: Path):
+        """If the user already wrote a .gitignore, we don't overwrite it."""
+        from django_tailwind_cli.management.commands.tailwind import _ensure_default_gitignore
+
+        settings.BASE_DIR = tmp_path
+        default_dir = tmp_path / ".django_tailwind_cli"
+        default_dir.mkdir()
+        existing = default_dir / ".gitignore"
+        existing.write_text("# hand-written\n*.log\n")
+
+        _ensure_default_gitignore()
+
+        assert existing.read_text() == "# hand-written\n*.log\n"
+
+    def test_ensure_default_gitignore_noop_when_dir_missing(self, settings: LazySettings, tmp_path: Path):
+        """If the managed dir was never created, the helper simply returns."""
+        from django_tailwind_cli.management.commands.tailwind import _ensure_default_gitignore
+
+        settings.BASE_DIR = tmp_path
+        # No default_dir created
+
+        _ensure_default_gitignore()  # must not raise
+
+        assert not (tmp_path / ".django_tailwind_cli").exists()
+
+
 # Configuration to run tests with appropriate markers
 pytestmark = [
     pytest.mark.filterwarnings("ignore::DeprecationWarning"),