quickscale-cli 0.65.0__tar.gz → 0.67.0__tar.gz

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: quickscale-cli
-Version: 0.65.0
+Version: 0.67.0
 Summary: Command-line interface for QuickScale Django project generator
 Home-page: https://github.com/Experto-AI/quickscale
 License: Apache-2.0
@@ -18,6 +18,6 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Dist: click (>=8.3.0,<9.0.0)
-Requires-Dist: quickscale-core (>=0.65.0,<0.66.0)
+Requires-Dist: quickscale-core (>=0.67.0,<0.68.0)
 Project-URL: Documentation, https://github.com/Experto-AI/quickscale/tree/main/docs
 Project-URL: Repository, https://github.com/Experto-AI/quickscale

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "quickscale-cli"
-version = "0.65.0"
+version = "0.67.0"
 description = "Command-line interface for QuickScale Django project generator"
 authors = ["Experto AI <victor@experto.ai>"]
 license = "Apache-2.0"
@@ -24,7 +24,7 @@ packages = [{include = "quickscale_cli", from = "src"}]
 [tool.poetry.dependencies]
 python = "^3.10"
 click = "^8.3.0"
-quickscale-core = "^0.65.0"
+quickscale-core = "^0.67.0"
 
 [tool.poetry.group.dev.dependencies]
 # Dev dependencies centralized in root pyproject.toml

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/src/quickscale_cli/_version.py

@@ -1,2 +1,2 @@
 # Auto-generated by scripts/version_tool.sh
-__version__ = "0.65.0"
+__version__ = "0.67.0"

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/src/quickscale_cli/commands/development_commands.py

@@ -1,8 +1,10 @@
 """Development lifecycle commands for QuickScale projects."""
 
+import json
 import re
 import subprocess
 import sys
+from pathlib import Path
 
 import click
 
@@ -42,6 +44,19 @@ def up(build: bool, no_cache: bool) -> None:
         click.echo("💡 Tip: Start Docker Desktop or the Docker daemon", err=True)
         sys.exit(1)
 
+    # Check if dependencies changed and suggest rebuild
+    if not build and _dependencies_changed_since_last_build():
+        click.secho(
+            "⚠️  Warning: Dependencies may have changed since last Docker build",
+            fg="yellow",
+            bold=True,
+        )
+        click.echo(
+            "   This can happen after embedding modules or updating dependencies.\n"
+            "   If you encounter import errors, rebuild the image:\n"
+        )
+        click.secho("   quickscale down && quickscale up --build\n", fg="cyan")
+
     # Check if required port is available BEFORE calling docker-compose
     port = get_port_from_env()
     if not is_port_available(port):
@@ -62,7 +77,12 @@ def up(build: bool, no_cache: bool) -> None:
 
     try:
         compose_cmd = get_docker_compose_command()
-        cmd = compose_cmd + ["up", "-d"]
+
+        # Use --progress plain during build for cleaner output without repetitive updates
+        if build or no_cache:
+            cmd = compose_cmd + ["--progress", "plain", "up", "-d"]
+        else:
+            cmd = compose_cmd + ["up", "-d"]
 
         if build or no_cache:
             cmd.append("--build")
@@ -71,10 +91,23 @@ def up(build: bool, no_cache: bool) -> None:
             cmd.append("--no-cache")
 
         click.echo("🚀 Starting Docker services...")
-        subprocess.run(cmd, check=True, capture_output=True, text=True)
+
+        # Show output during build operations for transparency
+        # Capture output for simple startups to keep it clean
+        if build or no_cache:
+            click.echo("📦 Building Docker images...")
+            click.echo("")  # Blank line for readability
+            subprocess.run(cmd, check=True, text=True)
+        else:
+            subprocess.run(cmd, check=True, capture_output=True, text=True)
+
         click.secho("✅ Services started successfully!", fg="green", bold=True)
         click.echo("💡 Tip: Use 'quickscale logs' to view service logs")
 
+        # Update build timestamp if build was performed
+        if build:
+            _update_last_build_timestamp()
+
     except subprocess.CalledProcessError as e:
         # Check for port conflict in error output
         # Docker error format: "Bind for 0.0.0.0:8000 failed: port is already allocated"
@@ -372,3 +405,76 @@ def ps() -> None:
             err=True,
         )
         sys.exit(1)
+
+
+def _get_build_state_file() -> Path:
+    """Get path to build state tracking file."""
+    return Path.cwd() / ".quickscale" / "build_state.json"
+
+
+def _dependencies_changed_since_last_build() -> bool:
+    """
+    Check if pyproject.toml or poetry.lock changed since last Docker build.
+
+    Returns
+    -------
+        True if dependencies may have changed, False otherwise
+    """
+    build_state_file = _get_build_state_file()
+    pyproject_file = Path.cwd() / "pyproject.toml"
+    poetry_lock_file = Path.cwd() / "poetry.lock"
+
+    # If build state file doesn't exist, we can't determine if changed
+    # (likely first time running, or old project)
+    if not build_state_file.exists():
+        return False
+
+    # If dependency files don't exist, something is wrong but don't warn
+    if not pyproject_file.exists() or not poetry_lock_file.exists():
+        return False
+
+    try:
+        with open(build_state_file) as f:
+            build_state = json.load(f)
+
+        last_pyproject_mtime: float = build_state.get("pyproject_mtime", 0)
+        last_poetry_lock_mtime: float = build_state.get("poetry_lock_mtime", 0)
+
+        current_pyproject_mtime = pyproject_file.stat().st_mtime
+        current_poetry_lock_mtime = poetry_lock_file.stat().st_mtime
+
+        # Return True if either file changed since last build
+        changed: bool = (
+            current_pyproject_mtime > last_pyproject_mtime
+            or current_poetry_lock_mtime > last_poetry_lock_mtime
+        )
+        return changed
+
+    except (json.JSONDecodeError, KeyError, OSError):
+        # If we can't read state, don't warn (fail safe)
+        return False
+
+
+def _update_last_build_timestamp() -> None:
+    """Update build state file with current dependency file timestamps."""
+    build_state_file = _get_build_state_file()
+    pyproject_file = Path.cwd() / "pyproject.toml"
+    poetry_lock_file = Path.cwd() / "poetry.lock"
+
+    # Ensure .quickscale directory exists
+    build_state_file.parent.mkdir(parents=True, exist_ok=True)
+
+    # Get current timestamps
+    pyproject_mtime = pyproject_file.stat().st_mtime if pyproject_file.exists() else 0
+    poetry_lock_mtime = (
+        poetry_lock_file.stat().st_mtime if poetry_lock_file.exists() else 0
+    )
+
+    # Write build state
+    build_state = {
+        "pyproject_mtime": pyproject_mtime,
+        "poetry_lock_mtime": poetry_lock_mtime,
+    }
+
+    with open(build_state_file, "w") as f:
+        json.dump(build_state, f, indent=2)

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/src/quickscale_cli/commands/module_commands.py

@@ -18,7 +18,7 @@ from quickscale_core.utils.git_utils import (
 )
 
 # Available modules
-AVAILABLE_MODULES = ["auth", "billing", "teams"]
+AVAILABLE_MODULES = ["auth", "billing", "teams", "blog", "listings"]
 
 
 def has_migrations_been_run() -> bool:
@@ -273,8 +273,277 @@ SITE_ID = 1
     click.echo(f"  • Authentication: {config['authentication_method']}")
 
 
+def configure_blog_module() -> dict[str, Any]:
+    """Interactive configuration for blog module"""
+    click.echo("\n⚙️  Configuring blog module...")
+    click.echo("The blog module will be configured with default settings.\n")
+
+    config = {
+        "posts_per_page": click.prompt(
+            "Posts per page",
+            type=int,
+            default=10,
+        ),
+        "enable_rss": click.confirm("Enable RSS feed?", default=True),
+    }
+
+    return config
+
+
+def apply_blog_configuration(project_path: Path, config: dict[str, Any]) -> None:
+    """Apply blog module configuration to project settings"""
+    # QuickScale uses settings/base.py and project_name/urls.py structure
+    settings_path = project_path / f"{project_path.name}" / "settings" / "base.py"
+    urls_path = project_path / f"{project_path.name}" / "urls.py"
+
+    if not settings_path.exists():
+        click.secho(
+            "⚠️  Warning: settings.py not found, skipping auto-configuration",
+            fg="yellow",
+        )
+        return
+
+    # Read settings.py
+    with open(settings_path) as f:
+        settings_content = f.read()
+
+    # Check if already configured
+    if "quickscale_modules_blog" in settings_content:
+        click.echo("ℹ️  Blog module already configured in settings.py")
+        return
+
+    # Add required apps to INSTALLED_APPS
+    installed_apps_addition = """
+# QuickScale Blog Module - Added by quickscale embed
+INSTALLED_APPS += [
+    "markdownx",  # Markdown editor with image upload
+    "quickscale_modules_blog",  # Blog module
+]
+
+# Blog Module Settings
+"""
+
+    installed_apps_addition += f"BLOG_POSTS_PER_PAGE = {config['posts_per_page']}\n"
+    installed_apps_addition += """MARKDOWNX_MARKDOWN_EXTENSIONS = [
+    "markdown.extensions.fenced_code",
+    "markdown.extensions.tables",
+    "markdown.extensions.toc",
+]
+MARKDOWNX_MEDIA_PATH = "blog/markdownx/"
+"""
+
+    # Append to settings.py
+    with open(settings_path, "a") as f:
+        f.write("\n" + installed_apps_addition)
+
+    click.secho("  ✅ Updated settings.py with blog configuration", fg="green")
+
+    # Update urls.py
+    if urls_path.exists():
+        with open(urls_path) as f:
+            urls_content = f.read()
+
+        if "quickscale_modules_blog" not in urls_content:
+            # Find urlpatterns and add blog URLs
+            if "urlpatterns = [" in urls_content:
+                urls_addition = (
+                    '    path("blog/", include("quickscale_modules_blog.urls")),\n'
+                )
+                if config["enable_rss"]:
+                    urls_addition += '    path("markdownx/", include("markdownx.urls")),  # Markdown editor upload\n'
+                urls_content = urls_content.replace(
+                    "urlpatterns = [", "urlpatterns = [\n" + urls_addition
+                )
+
+                with open(urls_path, "w") as f:
+                    f.write(urls_content)
+
+                click.secho("  ✅ Updated urls.py with blog URLs", fg="green")
+
+    # Show configuration summary
+    click.echo("\n📋 Configuration applied:")
+    click.echo(f"  • Posts per page: {config['posts_per_page']}")
+    click.echo(f"  • RSS feed: {'Enabled' if config['enable_rss'] else 'Disabled'}")
+
+
+def configure_listings_module() -> dict[str, Any]:
+    """Interactive configuration for listings module"""
+    click.echo("\n⚙️  Configuring listings module...")
+    click.echo(
+        "The listings module provides an abstract base model for marketplace listings.\n"
+    )
+
+    config = {
+        "listings_per_page": click.prompt(
+            "Listings per page",
+            type=int,
+            default=12,
+        ),
+    }
+
+    return config
+
+
+def apply_listings_configuration(project_path: Path, config: dict[str, Any]) -> None:
+    """Apply listings module configuration to project settings"""
+    import re
+
+    # QuickScale uses settings/base.py and project_name/urls.py structure
+    settings_path = project_path / f"{project_path.name}" / "settings" / "base.py"
+    urls_path = project_path / f"{project_path.name}" / "urls.py"
+    pyproject_path = project_path / "pyproject.toml"
+
+    if not settings_path.exists():
+        click.secho(
+            "⚠️  Warning: settings.py not found, skipping auto-configuration",
+            fg="yellow",
+        )
+        return
+
+    # Read settings.py
+    with open(settings_path) as f:
+        settings_content = f.read()
+
+    # Check if already configured
+    if "quickscale_modules_listings" in settings_content:
+        click.echo("ℹ️  Listings module already configured in settings.py")
+        return
+
+    # Add django-filter dependency to pyproject.toml
+    if pyproject_path.exists():
+        with open(pyproject_path) as f:
+            pyproject_content = f.read()
+
+        if "django-filter" not in pyproject_content:
+            # Read django-filter version from the embedded listings module
+            listings_pyproject_path = (
+                project_path / "modules" / "listings" / "pyproject.toml"
+            )
+
+            if not listings_pyproject_path.exists():
+                click.secho(
+                    "❌ Error: Listings module pyproject.toml not found. "
+                    "Cannot determine django-filter version requirement.",
+                    fg="red",
+                    err=True,
+                )
+                click.echo(f"Expected file: {listings_pyproject_path}", err=True)
+                click.echo(
+                    "This indicates the listings module was not embedded correctly.",
+                    err=True,
+                )
+                raise click.Abort()
+
+            # Extract django-filter version using regex
+            try:
+                with open(listings_pyproject_path) as f:
+                    listings_pyproject_content = f.read()
+
+                version_match = re.search(
+                    r'django-filter\s*=\s*["\']([^"\']+)["\']',
+                    listings_pyproject_content,
+                )
+                if not version_match:
+                    click.secho(
+                        "❌ Error: Cannot find django-filter version in listings "
+                        "module's pyproject.toml",
+                        fg="red",
+                        err=True,
+                    )
+                    click.echo(f"File: {listings_pyproject_path}", err=True)
+                    click.echo('Expected format: django-filter = "^x.x.x"', err=True)
+                    click.echo(
+                        "Please check the listings module's dependencies.", err=True
+                    )
+                    raise click.Abort()
+                django_filter_version = version_match.group(1)
+            except (FileNotFoundError, AttributeError) as e:
+                click.secho(
+                    f"❌ Error: Failed to parse django-filter version from listings "
+                    f"module: {e}",
+                    fg="red",
+                    err=True,
+                )
+                click.echo(f"File: {listings_pyproject_path}", err=True)
+                click.echo(
+                    "Please ensure the listings module is properly embedded and its "
+                    "pyproject.toml is valid.",
+                    err=True,
+                )
+                raise click.Abort()
+
+            # Try to add to [tool.poetry.dependencies] section
+            dependencies_pattern = r"(\[tool\.poetry\.dependencies\][^\[]*)"
+            match = re.search(dependencies_pattern, pyproject_content, re.DOTALL)
+            if match:
+                dependencies_section = match.group(1)
+                # Add django-filter after the python version line
+                updated_dependencies = re.sub(
+                    r'(python = "[^"]*")',
+                    rf'\1\ndjango-filter = "{django_filter_version}"',
+                    dependencies_section,
+                )
+                pyproject_content = pyproject_content.replace(
+                    dependencies_section, updated_dependencies
+                )
+
+                with open(pyproject_path, "w") as f:
+                    f.write(pyproject_content)
+
+                click.secho("  ✅ Added django-filter to pyproject.toml", fg="green")
+            else:
+                click.secho(
+                    "⚠️  Warning: Could not find [tool.poetry.dependencies] section in "
+                    "pyproject.toml",
+                    fg="yellow",
+                )
+
+    # Add required apps to INSTALLED_APPS
+    installed_apps_addition = """
+# QuickScale Listings Module - Added by quickscale embed
+INSTALLED_APPS += [
+    "django_filters",  # Filtering support
+    "quickscale_modules_listings",  # Listings module
+]
+
+# Listings Module Settings
+"""
+
+    installed_apps_addition += f"LISTINGS_PER_PAGE = {config['listings_per_page']}\n"
+
+    # Append to settings.py
+    with open(settings_path, "a") as f:
+        f.write("\n" + installed_apps_addition)
+
+    click.secho("  ✅ Updated settings.py with listings configuration", fg="green")
+
+    # Update urls.py
+    if urls_path.exists():
+        with open(urls_path) as f:
+            urls_content = f.read()
+
+        if "quickscale_modules_listings" not in urls_content:
+            # Find urlpatterns and add listings URLs
+            if "urlpatterns = [" in urls_content:
+                urls_addition = '    path("listings/", include("quickscale_modules_listings.urls")),\n'
+                urls_content = urls_content.replace(
+                    "urlpatterns = [", "urlpatterns = [\n" + urls_addition
+                )
+
+                with open(urls_path, "w") as f:
+                    f.write(urls_content)
+
+                click.secho("  ✅ Updated urls.py with listings URLs", fg="green")
+
+    # Show configuration summary
+    click.echo("\n📋 Configuration applied:")
+    click.echo(f"  • Listings per page: {config['listings_per_page']}")
+
+
 MODULE_CONFIGURATORS = {
     "auth": (configure_auth_module, apply_auth_configuration),
+    "blog": (configure_blog_module, apply_blog_configuration),
+    "listings": (configure_listings_module, apply_listings_configuration),
 }
 
 
@@ -298,16 +567,20 @@ def embed(module: str, remote: str) -> None:
     Examples:
       quickscale embed --module auth
       quickscale embed --module billing
+      quickscale embed --module blog
+      quickscale embed --module listings
 
     \b
-    Available modules (v0.62.0 placeholders):
-      - auth: Authentication with django-allauth (placeholder)
+    Available modules:
+      - auth: Authentication with django-allauth
       - billing: Stripe integration with dj-stripe (placeholder)
       - teams: Multi-tenancy and team management (placeholder)
+      - blog: Markdown-powered blog with categories, tags, and RSS
+      - listings: Generic listings with filtering for marketplace verticals
 
     \b
-    Note: In v0.62.0, modules contain only placeholder READMEs explaining
-    they're not yet implemented. Full implementations coming in v0.63.0+.
+    Note: Auth, blog, and listings modules are fully implemented.
+    Billing and teams modules contain placeholder READMEs.
     """
     try:
         # Validate git repository
@@ -420,37 +693,117 @@ def embed(module: str, remote: str) -> None:
             project_root = Path.cwd()
             applier(project_root, config)
 
-        # Install dependencies if pyproject.toml was modified
-        if module == "auth":
-            click.echo("📦 Installing dependencies...")
+        # Install dependencies for modules that need it
+        if module in ["auth", "blog", "listings"]:
+            click.echo("\n📦 Installing dependencies...")
             try:
                 import subprocess
 
-                # Install the auth module
-                subprocess.run(
-                    ["poetry", "add", "./modules/auth"],
+                project_root = Path.cwd()
+                module_path = project_root / "modules" / module
+
+                # Verify module was actually embedded
+                if not module_path.exists():
+                    click.secho(
+                        f"❌ Error: Module directory not found at {module_path}",
+                        fg="red",
+                        err=True,
+                    )
+                    click.echo(
+                        "   The git subtree add may have failed. Check the output above.",
+                        err=True,
+                    )
+                    raise click.Abort()
+
+                # Determine the correct path to add
+                # Sometimes the split branch might contain the full repo (e.g. during dev/testing)
+                # We need to find the actual module's pyproject.toml
+                target_path = module_path
+                nested_path = module_path / "quickscale_modules" / module
+
+                if nested_path.exists() and (nested_path / "pyproject.toml").exists():
+                    click.secho(
+                        f"⚠️  Warning: Detected full repository in {module} module path.",
+                        fg="yellow",
+                    )
+                    click.echo(
+                        f"   Using nested path: {nested_path.relative_to(project_root)}"
+                    )
+                    target_path = nested_path
+
+                # Install the module
+                click.echo(f"  • Installing {module} module...")
+                result = subprocess.run(
+                    ["poetry", "add", f"./{target_path.relative_to(project_root)}"],
                     cwd=project_root,
                     capture_output=True,
                     text=True,
-                    check=True,
                 )
-                click.secho("  ✅ Auth module installed successfully", fg="green")
+
+                if result.returncode != 0:
+                    click.secho(
+                        f"\n❌ Failed to install {module} module",
+                        fg="red",
+                        err=True,
+                        bold=True,
+                    )
+                    click.echo("\n📋 Error output (stderr):", err=True)
+                    click.echo(result.stderr, err=True)
+                    click.echo("\n📋 Standard output (stdout):", err=True)
+                    click.echo(result.stdout, err=True)
+
+                    click.echo("\n💡 To fix this manually:", err=True)
+                    click.echo(f"   1. cd {project_root}", err=True)
+                    click.echo(f"   2. poetry add ./modules/{module}", err=True)
+                    click.echo("   3. poetry install", err=True)
+                    click.echo("   4. poetry run python manage.py migrate", err=True)
+                    raise click.Abort()
+
+                click.secho(
+                    f"  ✅ {module.capitalize()} module installed successfully",
+                    fg="green",
+                )
 
                 # Install dependencies
-                subprocess.run(
+                click.echo("  • Installing all dependencies...")
+                result = subprocess.run(
                     ["poetry", "install"],
                     cwd=project_root,
                     capture_output=True,
                     text=True,
-                    check=True,
                 )
+
+                if result.returncode != 0:
+                    click.secho(
+                        "\n❌ Failed to install dependencies",
+                        fg="red",
+                        err=True,
+                        bold=True,
+                    )
+                    click.echo("\n📋 Error output (stderr):", err=True)
+                    click.echo(result.stderr, err=True)
+                    click.echo("\n📋 Standard output (stdout):", err=True)
+                    click.echo(result.stdout, err=True)
+
+                    click.echo("\n💡 To fix this manually:", err=True)
+                    click.echo(f"   1. cd {project_root}", err=True)
+                    click.echo("   2. poetry install", err=True)
+                    click.echo("   3. poetry run python manage.py migrate", err=True)
+                    raise click.Abort()
+
                 click.secho("  ✅ Dependencies installed successfully", fg="green")
+
             except subprocess.CalledProcessError as e:
                 click.secho(
-                    f"⚠️  Warning: Failed to install dependencies automatically: {e}",
-                    fg="yellow",
+                    f"\n❌ Unexpected error during dependency installation: {e}",
+                    fg="red",
+                    err=True,
+                )
+                click.echo(
+                    f"\n💡 Try running 'poetry install' manually in {project_root}",
+                    err=True,
                 )
-                click.echo("  💡 You may need to run 'poetry install' manually")
+                raise click.Abort()
 
         # Success message
         click.secho(
@@ -475,10 +828,96 @@ def embed(module: str, remote: str) -> None:
                 "  3. Create superuser (optional): poetry run python manage.py createsuperuser"
             )
             click.echo("  4. Start development server:")
-            click.echo("     • With Docker: quickscale up")
+            click.echo("")
+            click.secho(
+                "     ⚠️  IMPORTANT: Use --build flag with Docker",
+                fg="yellow",
+                bold=True,
+            )
+            click.secho(
+                "     • With Docker: quickscale down && quickscale up --build",
+                fg="cyan",
+                bold=True,
+            )
+            click.secho(
+                "       ^^^ --build is REQUIRED to install new dependencies",
+                fg="yellow",
+            )
+            click.echo("")
             click.echo("     • Without Docker: poetry run python manage.py runserver")
             click.echo("  5. Visit http://localhost:8000/accounts/login/")
-            click.echo("\n� Documentation: modules/auth/README.md")
+            click.echo("\n📖 Documentation: modules/auth/README.md")
+        elif module == "blog":
+            click.echo(f"  1. Review module code in modules/{module}/")
+            click.secho(
+                "  2. ⚠️  IMPORTANT: Run migrations (required before server start):",
+                fg="yellow",
+                bold=True,
+            )
+            click.secho(
+                "     poetry run python manage.py migrate", fg="cyan", bold=True
+            )
+            click.echo(
+                "  3. Create superuser (optional): poetry run python manage.py createsuperuser"
+            )
+            click.echo("  4. Start development server:")
+            click.echo("")
+            click.secho(
+                "     ⚠️  IMPORTANT: Use --build flag with Docker",
+                fg="yellow",
+                bold=True,
+            )
+            click.secho(
+                "     • With Docker: quickscale down && quickscale up --build",
+                fg="cyan",
+                bold=True,
+            )
+            click.secho(
+                "       ^^^ --build is REQUIRED to install new dependencies",
+                fg="yellow",
+            )
+            click.echo("")
+            click.echo("     • Without Docker: poetry run python manage.py runserver")
+            click.echo("  5. Visit http://localhost:8000/admin/ to create blog posts")
+            click.echo("  6. View your blog at http://localhost:8000/blog/")
+            click.echo("  7. RSS feed available at http://localhost:8000/blog/feed/")
+            click.echo("\n📖 Documentation: modules/blog/README.md")
+        elif module == "listings":
+            click.echo(f"  1. Review module code in modules/{module}/")
+            click.secho(
+                "  2. ⚠️  IMPORTANT: Run migrations (required before server start):",
+                fg="yellow",
+                bold=True,
+            )
+            click.secho(
+                "     poetry run python manage.py migrate", fg="cyan", bold=True
+            )
+            click.echo(
+                "  3. Create superuser (optional): poetry run python manage.py createsuperuser"
+            )
+            click.echo("  4. Start development server:")
+            click.echo("")
+            click.secho(
+                "     ⚠️  IMPORTANT: Use --build flag with Docker",
+                fg="yellow",
+                bold=True,
+            )
+            click.secho(
+                "     • With Docker: quickscale down && quickscale up --build",
+                fg="cyan",
+                bold=True,
+            )
+            click.secho(
+                "       ^^^ --build is REQUIRED to install new dependencies",
+                fg="yellow",
+            )
+            click.echo("")
+            click.echo("     • Without Docker: poetry run python manage.py runserver")
+            click.echo(
+                "  5. Create a concrete model extending AbstractListing (see README)"
+            )
+            click.echo("  6. View listings at http://localhost:8000/listings/")
+            click.echo("\n📖 Documentation: modules/listings/README.md")
         else:
             click.echo(f"  1. Review the module code in modules/{module}/")
             click.echo(f"  2. Follow setup instructions in modules/{module}/README.md")

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/src/quickscale_cli/main.py

@@ -97,8 +97,8 @@ def init(project_name: str, theme: str) -> None:
     \b
     Available themes:
       showcase_html    Pure HTML + CSS (default, production-ready)
-      showcase_htmx    HTMX + Alpine.js (coming in v0.67.0)
-      showcase_react   React + TypeScript SPA (coming in v0.68.0)
+    showcase_htmx    HTMX + Alpine.js (coming in v0.70.0)
+    showcase_react   React + TypeScript SPA (coming in v0.71.0)
     """
     # Step 1: Check system dependencies BEFORE generation
     click.echo("🔍 Checking system dependencies...")
@@ -145,8 +145,8 @@ def init(project_name: str, theme: str) -> None:
             click.echo(
                 f"\n💡 The '{theme}' theme is planned for a future release:", err=True
             )
-            click.echo("   - showcase_htmx: Coming in v0.67.0", err=True)
-            click.echo("   - showcase_react: Coming in v0.68.0", err=True)
+            click.echo("   - showcase_htmx: Coming in v0.70.0", err=True)
+            click.echo("   - showcase_react: Coming in v0.71.0", err=True)
             click.echo("\n📖 For now, use the default 'showcase_html' theme", err=True)
             raise click.Abort()
 

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/src/quickscale_cli/utils/dependency_utils.py

@@ -1,10 +1,36 @@
 """System dependency checking utilities."""
 
+import os
 import shutil
 import subprocess
 from typing import NamedTuple
 
 
+SKIP_ENV_VAR = "QUICKSCALE_SKIP_DEPENDENCY_CHECKS"
+
+
+def _should_skip_dependency_checks() -> bool:
+    """Return True when dependency checks should be skipped."""
+
+    value = os.getenv(SKIP_ENV_VAR, "")
+    return value.strip().lower() in {"1", "true", "yes", "on"}
+
+
+def _skipped_dependency(
+    name: str, required: bool, purpose: str, version_env: str | None = None
+) -> "DependencyStatus":
+    """Create a dependency status representing a skipped check."""
+
+    version = os.getenv(version_env) if version_env else None
+    return DependencyStatus(
+        name=name,
+        installed=True,
+        version=version,
+        required=required,
+        purpose=purpose,
+    )
+
+
 class DependencyStatus(NamedTuple):
     """Status of a system dependency check."""
 
@@ -35,6 +61,14 @@ def check_python_version() -> DependencyStatus:
 
 def check_poetry_installed() -> DependencyStatus:
     """Check if Poetry is installed."""
+
+    if _should_skip_dependency_checks():
+        return _skipped_dependency(
+            name="Poetry",
+            required=True,
+            purpose="Dependency management for generated projects",
+            version_env="QUICKSCALE_MOCK_POETRY_VERSION",
+        )
     try:
         result = subprocess.run(
             ["poetry", "--version"],
@@ -66,6 +100,14 @@ def check_poetry_installed() -> DependencyStatus:
 
 def check_git_installed() -> DependencyStatus:
     """Check if Git is installed."""
+
+    if _should_skip_dependency_checks():
+        return _skipped_dependency(
+            name="Git",
+            required=False,
+            purpose="Version control and module management (quickscale embed/update)",
+            version_env="QUICKSCALE_MOCK_GIT_VERSION",
+        )
     git_path = shutil.which("git")
 
     if git_path:
@@ -105,7 +147,15 @@ def check_git_installed() -> DependencyStatus:
 
 
 def check_docker_installed() -> DependencyStatus:
-    """Check if Docker is installed."""
+    """Check if Docker and Docker Compose are installed."""
+
+    if _should_skip_dependency_checks():
+        return _skipped_dependency(
+            name="Docker",
+            required=False,
+            purpose="Containerized development (quickscale up/down)",
+            version_env="QUICKSCALE_MOCK_DOCKER_VERSION",
+        )
     docker_path = shutil.which("docker")
 
     if docker_path:
@@ -122,6 +172,47 @@ def check_docker_installed() -> DependencyStatus:
             parts = version_str.split()
             version = parts[2].rstrip(",") if len(parts) >= 3 else None
 
+            # Also check for Docker Compose (either v2 plugin or v1 standalone)
+            compose_available = False
+            try:
+                # Try docker compose v2 (plugin)
+                subprocess.run(
+                    ["docker", "compose", "version"],
+                    capture_output=True,
+                    check=True,
+                    timeout=2,
+                )
+                compose_available = True
+            except (
+                subprocess.SubprocessError,
+                FileNotFoundError,
+                subprocess.TimeoutExpired,
+            ):
+                # Try docker-compose v1 (standalone)
+                try:
+                    subprocess.run(
+                        ["docker-compose", "--version"],
+                        capture_output=True,
+                        check=True,
+                        timeout=2,
+                    )
+                    compose_available = True
+                except (
+                    subprocess.SubprocessError,
+                    FileNotFoundError,
+                    subprocess.TimeoutExpired,
+                ):
+                    pass
+
+            if not compose_available:
+                return DependencyStatus(
+                    name="Docker",
+                    installed=False,
+                    version=version,
+                    required=False,
+                    purpose="Containerized development (quickscale up/down) - Docker Compose not found",
+                )
+
             return DependencyStatus(
                 name="Docker",
                 installed=True,
@@ -147,6 +238,14 @@ def check_docker_installed() -> DependencyStatus:
 
 def check_postgresql_installed() -> DependencyStatus:
     """Check if PostgreSQL client is installed."""
+
+    if _should_skip_dependency_checks():
+        return _skipped_dependency(
+            name="PostgreSQL",
+            required=False,
+            purpose="Database server (required for production, Docker provides for dev)",
+            version_env="QUICKSCALE_MOCK_POSTGRES_VERSION",
+        )
     psql_path = shutil.which("psql")
 
     if psql_path:

{quickscale_cli-0.65.0 → quickscale_cli-0.67.0}/src/quickscale_cli/utils/docker_utils.py

@@ -28,16 +28,20 @@ def find_docker_compose() -> Path | None:
 
 
 def get_docker_compose_command() -> list[str]:
-    """Get the appropriate docker compose command."""
-    # Try docker-compose first, fall back to docker compose
+    """Get the appropriate docker compose command.
+
+    Tries 'docker compose' (v2 plugin) first, falls back to 'docker-compose' (v1 standalone).
+    Both are fully supported.
+    """
+    # Try docker compose first (v2 plugin)
     try:
         subprocess.run(
-            ["docker-compose", "--version"], capture_output=True, check=True, timeout=2
+            ["docker", "compose", "version"], capture_output=True, check=True, timeout=2
         )
-        return ["docker-compose"]
-    except (subprocess.SubprocessError, FileNotFoundError, subprocess.TimeoutExpired):
-        # Fall back to docker compose (newer Docker versions)
         return ["docker", "compose"]
+    except (subprocess.SubprocessError, FileNotFoundError, subprocess.TimeoutExpired):
+        # Fall back to docker-compose (v1 standalone)
+        return ["docker-compose"]
 
 
 def get_container_status(container_name: str) -> str | None: