Updates docs

Author: timonweb

README.md

@@ -13,14 +13,14 @@
 
 This project provides a convenient way to integrate the *Tailwind CSS* framework into a Django project.
 It creates a new Django app (named theme by default) that includes all the necessary files and configurations to get
-started with *Tailwind CSS* quickly.
+started with *Tailwind CSS* quickly and **without even needing to install `Node.js`** if you choose the standalone binary mode.
 
 ## Features
 
 * An opinionated *Tailwind CSS* setup that makes your life easier;
-* **Two installation modes:** standalone binary (no `Node.js` required) or npm-based (`Node.js` required);
+* **Two installation modes:** standalone binary (works without `Node.js`) or npm-based (`Node.js` required);
 * Hot reloading of CSS, configuration files, and *Django* templates. No more manual page refreshes!
-* Out of the box support for CSS imports, Sass-like variables, and nesting;
+* Out of the box support for CSS imports and nesting;
 * Supports the latest *Tailwind CSS* `v4.x`;
 * Start both *Tailwind CSS* and *Django* development servers with a single command;
 * An optional DaisyUI integration to spice up your Tailwind templates with pre-built components.
@@ -30,7 +30,7 @@ started with *Tailwind CSS* quickly.
 
 Python 3.11 or newer and Django 4.2.20 or newer.
 
-**Note:** Node.js is only required if you choose the npm-based installation. The standalone binary mode does not require Node.js.
+**Note:** `Node.js` is only required if you choose the npm-based installation. The standalone binary mode does not require Node.js.
 
 ## Documentation
 

docs/settings.md

@@ -10,9 +10,6 @@ python manage.py tailwind init
 ```
 Please refer to the [Installation](installation.md) section for more information on the installation process.
 
-## `TAILWIND_DEV_MODE` (deprecated)
-Determines whether the `browser-sync` snippet is added to the page via the `{% tailwind_css %}` tag. It is set to `False` by default. If you use a legacy pre-`3.1.0` configuration and rely on `browser-sync`, add `TAILWIND_DEV_MODE=True` to your `settings.py`.
-
 ## `NPM_BIN_PATH` (npm-based installation only)
 
 > **Note:** This setting only applies to npm-based installations. Skip if using the standalone binary mode.
@@ -79,6 +76,54 @@ After changing this setting, run `python manage.py tailwind install` to download
 
 Visit the [Tailwind CSS releases page](https://github.com/tailwindlabs/tailwindcss/releases) to see all available versions. Use the tag name (e.g., `v4.1.16`) as the value for this setting.
 
+## `TAILWIND_STANDALONE_START_COMMAND_ARGS`
+
+> **Note:** This setting only applies when using standalone binary mode.
+
+This setting defines the command-line arguments passed to the Tailwind CSS standalone binary when running in watch mode (via `python manage.py tailwind start`).
+
+The default value is:
+```python
+TAILWIND_STANDALONE_START_COMMAND_ARGS = (
+    "-i static_src/src/styles.css -o static/css/dist/styles.css --watch"
+)
+```
+
+You can customize this to use different input/output paths or add additional Tailwind CLI options:
+
+```python
+# settings.py
+TAILWIND_STANDALONE_START_COMMAND_ARGS = (
+    "-i theme/static_src/input.css -o theme/static/output.css --watch --minify"
+)
+```
+
+> **Note:** The output path automatically uses the value from `TAILWIND_CSS_PATH` in the default configuration. If you override this setting, ensure your paths are correct.
+
+## `TAILWIND_STANDALONE_BUILD_COMMAND_ARGS`
+
+> **Note:** This setting only applies when using standalone binary mode.
+
+This setting defines the command-line arguments passed to the Tailwind CSS standalone binary when building for production (via `python manage.py tailwind build`).
+
+The default value is:
+```python
+TAILWIND_STANDALONE_BUILD_COMMAND_ARGS = (
+    "-i static_src/src/styles.css -o static/css/dist/styles.css --minify"
+)
+```
+
+You can customize this to use different input/output paths or modify build options:
+
+```python
+# settings.py
+TAILWIND_STANDALONE_BUILD_COMMAND_ARGS = (
+    "-i theme/static_src/input.css -o theme/static/output.css --minify --optimize"
+)
+```
+
+> **Note:** The output path automatically uses the value from `TAILWIND_CSS_PATH` in the default configuration. If you override this setting, ensure your paths match your project structure.
+
 ## `TAILWIND_CSS_PATH`
 This defines the path to the generated *Tailwind CSS* stylesheet. If you created a theme app via the `python manage.py tailwind init` command, you likely don't need to change this value.
 
@@ -88,3 +133,6 @@ The default value is:
 ```python
 TAILWIND_CSS_PATH = "css/dist/styles.css"
 ```
+
+## `TAILWIND_DEV_MODE` (deprecated)
+Determines whether the `browser-sync` snippet is added to the page via the `{% tailwind_css %}` tag. It is set to `False` by default. If you use a legacy pre-`3.1.0` configuration and rely on `browser-sync`, add `TAILWIND_DEV_MODE=True` to your `settings.py`.

src/tailwind/__init__.py

@@ -4,12 +4,13 @@
 
 
 def get_config(setting_name):
+    tailwind_css_path = "css/dist/styles.css"
     return {
         "NPM_BIN_PATH": getattr(settings, "NPM_BIN_PATH", "npm"),
         # 'TAILWIND_DEV_MODE' is deprecated. Leaving it here
         # to support legacy browser-sync based configs.
         "TAILWIND_DEV_MODE": getattr(settings, "TAILWIND_DEV_MODE", False),
-        "TAILWIND_CSS_PATH": getattr(settings, "TAILWIND_CSS_PATH", "css/dist/styles.css"),
+        "TAILWIND_CSS_PATH": getattr(settings, "TAILWIND_CSS_PATH", tailwind_css_path),
         "TAILWIND_APP_NAME": getattr(settings, "TAILWIND_APP_NAME", None),
         "TAILWIND_USE_STANDALONE_BINARY": getattr(
             settings, "TAILWIND_USE_STANDALONE_BINARY", False
@@ -19,6 +20,14 @@ def get_config(setting_name):
             "TAILWIND_STANDALONE_BINARY_VERSION",
             os.environ.get("TAILWINDCSS_VERSION", "v4.1.16"),
         ),
-        "TAILWIND_STANDALONE_START_COMMAND_ARGS": "-i static_src/src/styles.css -o static/css/dist/styles.css --watch",
-        "TAILWIND_STANDALONE_BUILD_COMMAND_ARGS": "-i static_src/src/styles.css -o static/css/dist/styles.css --minify",
+        "TAILWIND_STANDALONE_START_COMMAND_ARGS": getattr(
+            settings,
+            "TAILWIND_STANDALONE_START_COMMAND_ARGS",
+            f"-i static_src/src/styles.css -o static/{tailwind_css_path} --watch",
+        ),
+        "TAILWIND_STANDALONE_BUILD_COMMAND_ARGS": getattr(
+            settings,
+            "TAILWIND_STANDALONE_BUILD_COMMAND_ARGS",
+            f"-i static_src/src/styles.css -o static/{tailwind_css_path} --minify",
+        ),
     }[setting_name]