Updates docs

Author: timonweb

CLAUDE.md

@@ -63,6 +63,9 @@ python manage.py tailwind install
 # Start Tailwind development server (watches for changes)
 python manage.py tailwind start
 
+# Start both Django server and Tailwind watcher simultaneously
+python manage.py tailwind dev
+
 # Build production CSS
 python manage.py tailwind build
 ```
@@ -73,8 +76,9 @@ python manage.py tailwind build
 
 - **Management Command** (`src/tailwind/management/commands/tailwind.py`):
   - Main entry point for all Tailwind operations
-  - Handles `init`, `install`, `build`, `start`, `check-updates`, `update` commands
+  - Handles `init`, `install`, `build`, `start`, `dev`, `check-updates`, `update` commands
   - Uses cookiecutter templates for app initialization
+  - `dev` command runs Django server and Tailwind watcher simultaneously using Honcho
 
 - **NPM Integration** (`src/tailwind/npm.py`):
   - Wrapper around npm commands

README.md

@@ -9,6 +9,7 @@ This project aims to provide a comfortable way of using the *Tailwind CSS* frame
 * 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;
 * Supports the latest *Tailwind CSS* `v4.x`;
+* Start both *Tailwind CSS* and *Django* development servers with a single command;
 
 ## Requirements
 Python 3.10 or newer with Django >= 4.2.20 or newer.

docs/installation.md

@@ -125,14 +125,21 @@
     ]
     ```
 
-12. Finally, you should be able to use *Tailwind CSS* classes in HTML. Start the development server by running the
-    following command in your terminal:
+12. Finally, you should be able to use *Tailwind CSS* classes in HTML. You have two options to start development:
+
+    **Option 1 (Recommended):** Start both Django and Tailwind development servers simultaneously:
+
+    ```bash
+    python manage.py tailwind dev
+    ```
+
+    **Option 2:** Start only the Tailwind watcher (you'll need to run `python manage.py runserver` separately):
 
     ```bash
     python manage.py tailwind start
     ```
 
-    Check out the [Usage](./usage.md) section for information about the production mode.
+    Check out the [Usage](./usage.md) section for more details and information about the production mode.
 
 ## Optional configurations
 

docs/usage.md

@@ -2,19 +2,63 @@
 
 ## Running in Development Mode
 
-To start Django Tailwind in development mode, run the following command in a terminal:
+### Option 1: Combined Development Server (Recommended)
+
+To start both Django server and Tailwind watcher simultaneously, run:
+
+```bash
+python manage.py tailwind dev
+```
+
+This will start both processes using Honcho and provide a seamless development experience. Use `CTRL + C` to terminate both processes.
+
+### Option 2: Separate Processes
+
+To start only the Tailwind watcher in development mode, run the following command in a terminal:
 
 ```bash
 python manage.py tailwind start
 ```
 
 This will start a long-running process that watches files for changes. Use `CTRL + C` to terminate the process.
 
+**Note:** When using the separate process approach, you'll need to run `python manage.py runserver` in another terminal to start the Django development server.
+
+## How Development Mode Works
+
 Several things happen behind the scenes:
 
 1. The stylesheet is updated every time you add or remove a CSS class in a Django template.
 2. The `django-browser-reload` watches for changes in HTML and CSS files. When a Django template or CSS file is updated, the browser refreshes automatically, providing a smooth development experience without needing to reload the page manually.
 
+## Customizing the Development Setup
+
+### Procfile.tailwind Configuration
+
+When you run `python manage.py tailwind dev` for the first time, a `Procfile.tailwind` file is automatically created in your project root with the following default content:
+
+```
+django: python manage.py runserver
+tailwind: python manage.py tailwind start
+```
+
+This file defines the processes that Honcho will run simultaneously. Each line follows the format: `process_name: command_to_run`.
+
+### Customization Examples
+
+You can edit `Procfile.tailwind` to customize your development commands:
+
+```
+django: python manage.py runserver 0.0.0.0:8080
+tailwind: python manage.py tailwind start
+```
+
+### Process Management
+
+- **Starting processes:** `python manage.py tailwind dev` starts all processes defined in the Procfile
+- **Stopping processes:** Press `Ctrl+C` to stop all processes gracefully
+- **Process output:** Each process is color-coded in the terminal for easy identification
+
 ## Building for Production
 
 To create a production build of your theme, run: