devctl 1.0.0__tar.gz → 1.2.1__tar.gz

{devctl-1.0.0 → devctl-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devctl
-Version: 1.0.0
+Version: 1.2.1
 Summary: Local development orchestrator for Spring Boot, Angular, and Vue.js
 Author: Youssef Fellah
 License: MIT License
@@ -37,6 +37,8 @@ Requires-Dist: requests>=2.31.0
 Requires-Dist: jinja2>=3.1.3
 Requires-Dist: rich>=13.7.0
 Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: textual>=0.80.0
+Requires-Dist: psutil>=5.9.0
 Dynamic: license-file
 
 # devctl
@@ -45,10 +47,11 @@ Dynamic: license-file
 orchestrate the development lifecycle for modern full-stack architectures. It
 provides a unified workflow for managing backends (Spring Boot, NestJS, Go,
 FastAPI), frontends (Angular, Vue, React, NextJS, Svelte), and their
-containerization.
+containerization across Linux, macOS, and Windows.
 
 ## Core Features
 
+-   **Cross-Platform Architecture**: Out-of-the-box support for Windows, Linux, and macOS utilizing a robust platform abstraction layer.
 -   **Multi-Stack Orchestration**: Launch databases, multiple microservices, and
     frontend dev servers with a single command. Includes real-time, prefixed log
     streaming.
@@ -58,9 +61,34 @@ containerization.
 -   **Instant Infrastructure**: Automatically generate optimized, multi-stage
     `Dockerfiles` and global `docker-compose-prod.yml` configurations by scanning
     your project tree.
+-   **Interactive Dashboard**: Real-time system monitoring (CPU/RAM/Disk) and service orchestration with side-by-side log streaming (`devctl tui`).
 -   **Security by Default**: Inject standardized JWT authentication and security
     configurations into new projects.
 
+## Interactive Dashboard (TUI)
+
+Launch the real-time terminal dashboard using `devctl tui`:
+
+### Dashboard & System Monitoring
+![Dashboard View](screenshots/tui_dashboard.png)
+
+### Real-Time Service Controls & Log Streaming
+![Services Control View](screenshots/tui_services_control.png)
+
+<details>
+<summary><b>View More TUI Views (Docker, Scaffolding, Project Init)</b></summary>
+
+#### Docker Tools
+![Docker Scaffolding](screenshots/tui_docker_tools.png)
+
+#### Vertical Resource Generator
+![Add Resource Generator](screenshots/tui_add_resource.png)
+
+#### Project Initializer
+![Init Project Generator](screenshots/tui_init_project.png)
+
+</details>
+
 ## Installation
 
 You can install `devctl` locally for development:
@@ -109,8 +137,10 @@ devctl run
 
 ## Documentation
 
-For a detailed reference of all available commands and their options, see the
-[Commands Reference](COMMANDS.md).
+*   For a detailed reference of all available commands and their options, see the
+    [Commands Reference](COMMANDS.md).
+*   For an overview of the internal code structures and process pipelines, see the
+    [Architecture Guide](ARCHITECTURE.md).
 
 ## Contributing
 

{devctl-1.0.0 → devctl-1.2.1}/README.md

@@ -4,10 +4,11 @@
 orchestrate the development lifecycle for modern full-stack architectures. It
 provides a unified workflow for managing backends (Spring Boot, NestJS, Go,
 FastAPI), frontends (Angular, Vue, React, NextJS, Svelte), and their
-containerization.
+containerization across Linux, macOS, and Windows.
 
 ## Core Features
 
+-   **Cross-Platform Architecture**: Out-of-the-box support for Windows, Linux, and macOS utilizing a robust platform abstraction layer.
 -   **Multi-Stack Orchestration**: Launch databases, multiple microservices, and
     frontend dev servers with a single command. Includes real-time, prefixed log
     streaming.
@@ -17,9 +18,34 @@ containerization.
 -   **Instant Infrastructure**: Automatically generate optimized, multi-stage
     `Dockerfiles` and global `docker-compose-prod.yml` configurations by scanning
     your project tree.
+-   **Interactive Dashboard**: Real-time system monitoring (CPU/RAM/Disk) and service orchestration with side-by-side log streaming (`devctl tui`).
 -   **Security by Default**: Inject standardized JWT authentication and security
     configurations into new projects.
 
+## Interactive Dashboard (TUI)
+
+Launch the real-time terminal dashboard using `devctl tui`:
+
+### Dashboard & System Monitoring
+![Dashboard View](screenshots/tui_dashboard.png)
+
+### Real-Time Service Controls & Log Streaming
+![Services Control View](screenshots/tui_services_control.png)
+
+<details>
+<summary><b>View More TUI Views (Docker, Scaffolding, Project Init)</b></summary>
+
+#### Docker Tools
+![Docker Scaffolding](screenshots/tui_docker_tools.png)
+
+#### Vertical Resource Generator
+![Add Resource Generator](screenshots/tui_add_resource.png)
+
+#### Project Initializer
+![Init Project Generator](screenshots/tui_init_project.png)
+
+</details>
+
 ## Installation
 
 You can install `devctl` locally for development:
@@ -68,8 +94,10 @@ devctl run
 
 ## Documentation
 
-For a detailed reference of all available commands and their options, see the
-[Commands Reference](COMMANDS.md).
+*   For a detailed reference of all available commands and their options, see the
+    [Commands Reference](COMMANDS.md).
+*   For an overview of the internal code structures and process pipelines, see the
+    [Architecture Guide](ARCHITECTURE.md).
 
 ## Contributing
 

{devctl-1.0.0 → devctl-1.2.1}/devctl/commands/add.py

@@ -8,17 +8,17 @@ import os
 
 import typer
 
-from devctl.generators.scaffold_angular import generate_angular_resource
-from devctl.generators.scaffold_django import generate_django_resource
-from devctl.generators.scaffold_fastapi import generate_fastapi_resource
-from devctl.generators.scaffold_go import generate_go_resource
-from devctl.generators.scaffold_nestjs import generate_nest_resource
-from devctl.generators.scaffold_nextjs import generate_nextjs_resource
-from devctl.generators.scaffold_nodejs import generate_nodejs_resource
-from devctl.generators.scaffold_react import generate_react_resource
-from devctl.generators.scaffold_spring import generate_spring_resource
-from devctl.generators.scaffold_svelte import generate_svelte_resource
-from devctl.generators.scaffold_vue import generate_vue_resource
+from devctl.generators.angular import generate_angular_resource
+from devctl.generators.django import generate_django_resource
+from devctl.generators.fastapi import generate_fastapi_resource
+from devctl.generators.go_fiber import generate_go_resource
+from devctl.generators.nestjs import generate_nest_resource
+from devctl.generators.nextjs import generate_nextjs_resource
+from devctl.generators.nodejs import generate_nodejs_resource
+from devctl.generators.react import generate_react_resource
+from devctl.generators.spring import generate_spring_resource
+from devctl.generators.svelte import generate_svelte_resource
+from devctl.generators.vue import generate_vue_resource
 from devctl.orchestrator.scanner import detect_environment
 from devctl.utils.dependencies import check_tool
 

{devctl-1.0.0 → devctl-1.2.1}/devctl/commands/deploy.py

@@ -2,7 +2,7 @@ from pathlib import Path
 
 import typer
 
-from devctl.generators.docker_scaffold import (
+from devctl.generators.docker import (
     DockerScaffoldError,
     scaffold_docker_assets,
 )
@@ -20,6 +20,7 @@ FORCE_OPTION = typer.Option(
     help="Overwrite generated Docker files that already exist.",
 )
 
+
 @app.command()
 def deploy(
     path: Path = PATH_ARGUMENT,

{devctl-1.0.0 → devctl-1.2.1}/devctl/commands/docker.py

@@ -7,7 +7,7 @@ from pathlib import Path
 
 import typer
 
-from devctl.generators.docker_scaffold import (
+from devctl.generators.docker import (
     DockerScaffoldError,
     scaffold_docker_assets,
 )

{devctl-1.0.0 → devctl-1.2.1}/devctl/commands/init.py

@@ -6,7 +6,6 @@ Django, Svelte, and Go.
 
 import typer
 
-# Angular generator
 from devctl.generators.angular import generate_angular_boilerplate
 from devctl.generators.django import generate_django_boilerplate
 from devctl.generators.fastapi import generate_fastapi_boilerplate
@@ -15,8 +14,6 @@ from devctl.generators.nestjs import generate_nest_boilerplate
 from devctl.generators.nextjs import generate_nextjs_boilerplate
 from devctl.generators.nodejs import generate_nodejs_boilerplate
 from devctl.generators.react import generate_react_boilerplate
-
-# Spring generator
 from devctl.generators.spring import download_spring_boilerplate
 from devctl.generators.svelte import generate_svelte_boilerplate
 from devctl.generators.vue import generate_vue_boilerplate

{devctl-1.0.0 → devctl-1.2.1}/devctl/commands/run.py

@@ -7,7 +7,7 @@ from pathlib import Path
 
 import typer
 
-from devctl.generators.docker_scaffold import discover_docker_projects
+from devctl.generators.docker import discover_docker_projects
 from devctl.orchestrator.runner import launch_dev_environment
 from devctl.utils.dependencies import check_tool
 

devctl-1.2.1/devctl/commands/tui.py

@@ -0,0 +1,32 @@
+"""
+CLI command group for launching the interactive TUI.
+"""
+
+import typer
+
+app = typer.Typer(help="Interactive Terminal User Interface.")
+
+
+@app.callback(invoke_without_command=True)
+def launch_tui(
+    ctx: typer.Context,
+    single: bool = typer.Option(
+        False, "--single", "-s", help="Launch the single-panel dashboard layout."
+    ),
+):
+    """
+    Launches the interactive btop-like management interface.
+    """
+    if ctx.invoked_subcommand is not None:
+        return
+
+    typer.secho("Initializing interactive Devctl TUI...", fg=typer.colors.CYAN)
+
+    try:
+        from devctl.tui.app import DevctlTUI
+
+        tui_app = DevctlTUI(single_panel=single)
+        tui_app.run()
+    except Exception as e:
+        typer.secho(f"Error launching TUI: {e}", fg=typer.colors.RED)
+        raise typer.Exit(code=1) from e

devctl-1.2.1/devctl/generators/angular/__init__.py

@@ -0,0 +1,8 @@
+"""
+Angular framework generator and scaffolder.
+"""
+
+from devctl.generators.angular.generator import generate_angular_boilerplate
+from devctl.generators.angular.scaffolder import generate_angular_resource
+
+__all__ = ["generate_angular_boilerplate", "generate_angular_resource"]

devctl-1.0.0/devctl/generators/angular.py → devctl-1.2.1/devctl/generators/angular/generator.py

@@ -23,7 +23,7 @@ def setup_angular_environments(project_path: str):
     os.makedirs(env_dir, exist_ok=True)
 
     # 2. Template rendering via Jinja2
-    templates_dir = os.path.join(os.path.dirname(__file__), "..", "templates", "angular", "config")
+    templates_dir = os.path.join(os.path.dirname(__file__), "templates", "config")
     env = Environment(loader=FileSystemLoader(templates_dir))
 
     files_to_generate = {
@@ -79,8 +79,16 @@ def generate_angular_boilerplate(project_name: str) -> bool:
 
     safe_name = project_name.lower().replace("_", "-")
 
+    from ...utils import get_platform
+
+    platform = get_platform()
     try:
-        subprocess.run(["ng", "version"], capture_output=True, check=True)
+        subprocess.run(
+            ["ng", "version"],
+            capture_output=True,
+            check=True,
+            shell=platform.shell_required,
+        )
     except FileNotFoundError:
         typer.secho(
             "Error: Angular CLI ('ng') not found on your system.",
@@ -95,7 +103,7 @@ def generate_angular_boilerplate(project_name: str) -> bool:
         command = ["ng", "new", safe_name, "--routing=true", "--style=scss", "--skip-git=true"]
 
         typer.secho("Downloading npm packages... (This may take 1-2 minutes)", fg=typer.colors.CYAN)
-        subprocess.run(command, check=True)
+        subprocess.run(command, check=True, shell=platform.shell_required)
 
         # Post-installation configuration
         project_full_path = os.path.join(os.getcwd(), safe_name)

devctl-1.0.0/devctl/generators/scaffold_angular.py → devctl-1.2.1/devctl/generators/angular/scaffolder.py

@@ -117,7 +117,7 @@ def generate_angular_resource(resource_name: str, fields_str: str, root_path: st
         },
     ]
 
-    templates_dir = os.path.join(os.path.dirname(__file__), "..", "templates", "angular", "feature")
+    templates_dir = os.path.join(os.path.dirname(__file__), "templates", "feature")
     env = Environment(loader=FileSystemLoader(templates_dir))
 
     typer.secho(f"Generating Angular feature '{entity_name}'...", fg=typer.colors.CYAN)

devctl-1.2.1/devctl/generators/django/__init__.py

@@ -0,0 +1,8 @@
+"""
+Django framework generator and scaffolder.
+"""
+
+from devctl.generators.django.generator import generate_django_boilerplate
+from devctl.generators.django.scaffolder import generate_django_resource
+
+__all__ = ["generate_django_boilerplate", "generate_django_resource"]

devctl-1.2.1/devctl/generators/django/generator.py

@@ -0,0 +1,90 @@
+"""
+Generators for Django projects.
+Includes boilerplate generation with Django and DRF.
+"""
+
+import os
+import subprocess
+import sys
+
+import typer
+from jinja2 import Environment, FileSystemLoader
+
+
+def generate_django_boilerplate(project_name: str) -> bool:
+    """
+    Generates a new Django project.
+    """
+    typer.secho(f"Generating Django project '{project_name}'...", fg=typer.colors.CYAN)
+    safe_name = project_name.lower().replace("-", "_")  # Django prefers underscores
+    project_path = os.path.join(os.getcwd(), project_name)
+
+    try:
+        os.makedirs(project_path, exist_ok=True)
+
+        templates_dir = os.path.join(os.path.dirname(__file__), "templates", "config")
+        env = Environment(loader=FileSystemLoader(templates_dir))
+
+        # 1. Create requirements.txt
+        req_content = env.get_template("requirements.txt.j2").render()
+        with open(os.path.join(project_path, "requirements.txt"), "w", encoding="utf-8") as f:
+            f.write(req_content)
+
+        python_exe = "python" if sys.platform == "win32" else "python3"
+
+        # 2. Create virtual environment
+        typer.secho("Creating virtual environment...", fg=typer.colors.CYAN)
+        subprocess.run(
+            [python_exe, "-m", "venv", ".venv"],
+            cwd=project_path,
+            check=True,
+            shell=(sys.platform == "win32"),
+        )
+
+        # 3. Install Django
+        typer.secho("Installing Django and DRF...", fg=typer.colors.CYAN)
+        if sys.platform == "win32":
+            pip_path = os.path.join(".venv", "Scripts", "pip.exe")
+        else:
+            pip_path = os.path.join(".venv", "bin", "pip")
+        subprocess.run(
+            [pip_path, "install", "django", "djangorestframework"],
+            cwd=project_path,
+            check=True,
+            stdout=subprocess.DEVNULL,
+            shell=(sys.platform == "win32"),
+        )
+
+        # 4. Start Project
+        typer.secho("Scaffolding Django project structure...", fg=typer.colors.CYAN)
+        if sys.platform == "win32":
+            django_admin = os.path.join(".venv", "Scripts", "django-admin.exe")
+        else:
+            django_admin = os.path.join(".venv", "bin", "django-admin")
+        subprocess.run(
+            [django_admin, "startproject", safe_name, "."],
+            cwd=project_path,
+            check=True,
+            shell=(sys.platform == "win32"),
+        )
+
+        # 5. Create core app
+        if sys.platform == "win32":
+            python_path = os.path.join(".venv", "Scripts", "python.exe")
+        else:
+            python_path = os.path.join(".venv", "bin", "python")
+        subprocess.run(
+            [python_path, "manage.py", "startapp", "core"],
+            cwd=project_path,
+            check=True,
+            shell=(sys.platform == "win32"),
+        )
+
+        typer.secho(
+            f"Django project '{project_name}' successfully generated!", fg=typer.colors.GREEN
+        )
+        return True
+
+    except Exception as e:
+        typer.secho(f"Error: Django initialization failed: {e}", fg=typer.colors.RED)
+        return False

devctl-1.0.0/devctl/generators/scaffold_django.py → devctl-1.2.1/devctl/generators/django/scaffolder.py

@@ -6,6 +6,7 @@ Handles the creation of models, serializers, and views.
 import os
 
 import typer
+from jinja2 import Environment, FileSystemLoader
 
 from devctl.orchestrator.scanner import detect_environment
 
@@ -30,47 +31,34 @@ def generate_django_resource(resource_name: str, fields_str: str, root_path: str
     if not os.path.exists(core_dir):
         os.makedirs(core_dir, exist_ok=True)
 
+    templates_dir = os.path.join(os.path.dirname(__file__), "templates", "resource")
+    env = Environment(loader=FileSystemLoader(templates_dir))
+
     typer.secho(f"⚙️  Generating Django resource '{entity_name}'...", fg=typer.colors.CYAN)
 
+    context = {
+        "entity_name": entity_name,
+        "fields_str": fields_str,
+    }
+
     # 1. Append Model
-    model_snippet = f"""
-class {entity_name}(models.Model):
-    # Fields: {fields_str}
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
-
-    def __str__(self):
-        return f"{entity_name} {{self.id}}"
-"""
-    with open(os.path.join(core_dir, "models.py"), "a") as f:
+    model_snippet = "\n" + env.get_template("model.py.j2").render(**context) + "\n"
+    with open(os.path.join(core_dir, "models.py"), "a", encoding="utf-8") as f:
         f.write(model_snippet)
 
     # 2. Append Serializer
     serializer_path = os.path.join(core_dir, "serializers.py")
     if not os.path.exists(serializer_path):
-        with open(serializer_path, "w") as f:
+        with open(serializer_path, "w", encoding="utf-8") as f:
             f.write("from rest_framework import serializers\nfrom .models import *\n")
 
-    serializer_snippet = f"""
-class {entity_name}Serializer(serializers.ModelSerializer):
-    class Meta:
-        model = {entity_name}
-        fields = '__all__'
-"""
-    with open(serializer_path, "a") as f:
+    serializer_snippet = "\n" + env.get_template("serializer.py.j2").render(**context) + "\n"
+    with open(serializer_path, "a", encoding="utf-8") as f:
         f.write(serializer_snippet)
 
     # 3. Append View
-    view_snippet = f"""
-from rest_framework import viewsets
-from .models import {entity_name}
-from .serializers import {entity_name}Serializer
-
-class {entity_name}ViewSet(viewsets.ModelViewSet):
-    queryset = {entity_name}.objects.all()
-    serializer_class = {entity_name}Serializer
-"""
-    with open(os.path.join(core_dir, "views.py"), "a") as f:
+    view_snippet = "\n" + env.get_template("view.py.j2").render(**context) + "\n"
+    with open(os.path.join(core_dir, "views.py"), "a", encoding="utf-8") as f:
         f.write(view_snippet)
 
     typer.secho(f"✅ {entity_name} Django feature successfully generated!", fg=typer.colors.GREEN)

devctl-1.2.1/devctl/generators/django/templates/config/requirements.txt.j2

@@ -0,0 +1,3 @@
+django
+djangorestframework
+django-cors-headers

devctl-1.2.1/devctl/generators/django/templates/resource/model.py.j2

@@ -0,0 +1,7 @@
+class {{ entity_name }}(models.Model):
+    # Fields: {{ fields_str }}
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+
+    def __str__(self):
+        return f"{{ entity_name }} {self.id}"

devctl-1.2.1/devctl/generators/django/templates/resource/serializer.py.j2

@@ -0,0 +1,4 @@
+class {{ entity_name }}Serializer(serializers.ModelSerializer):
+    class Meta:
+        model = {{ entity_name }}
+        fields = '__all__'

devctl-1.2.1/devctl/generators/django/templates/resource/view.py.j2

@@ -0,0 +1,7 @@
+from rest_framework import viewsets
+from .models import {{ entity_name }}
+from .serializers import {{ entity_name }}Serializer
+
+class {{ entity_name }}ViewSet(viewsets.ModelViewSet):
+    queryset = {{ entity_name }}.objects.all()
+    serializer_class = {{ entity_name }}Serializer

devctl-1.2.1/devctl/generators/docker/__init__.py

@@ -0,0 +1,19 @@
+"""
+Docker asset scaffolder.
+"""
+
+from devctl.generators.docker.scaffolder import (
+    DockerProject,
+    DockerScaffoldError,
+    discover_docker_projects,
+    sanitize_service_name,
+    scaffold_docker_assets,
+)
+
+__all__ = [
+    "DockerProject",
+    "DockerScaffoldError",
+    "discover_docker_projects",
+    "sanitize_service_name",
+    "scaffold_docker_assets",
+]

devctl-1.0.0/devctl/generators/docker_scaffold.py → devctl-1.2.1/devctl/generators/docker/scaffolder.py

@@ -257,7 +257,7 @@ def _generate_compose_content(projects: list[DockerProject]) -> str:
 
         services_data.append(service_dict)
 
-    template_dir = Path(__file__).resolve().parent.parent / "templates" / "docker"
+    template_dir = Path(__file__).resolve().parent / "templates"
     env = Environment(
         loader=FileSystemLoader(str(template_dir)),
         trim_blocks=True,
@@ -501,7 +501,7 @@ def _write_file(path: Path, content: str, *, force: bool, dry_run: bool) -> File
 
 
 def _template_environment() -> Environment:
-    template_dir = Path(__file__).resolve().parent.parent / "templates" / "docker"
+    template_dir = Path(__file__).resolve().parent / "templates"
     return Environment(
         loader=FileSystemLoader(str(template_dir)),
         trim_blocks=True,

devctl-1.2.1/devctl/generators/fastapi/__init__.py

@@ -0,0 +1,8 @@
+"""
+FastAPI framework generator and scaffolder.
+"""
+
+from devctl.generators.fastapi.generator import generate_fastapi_boilerplate
+from devctl.generators.fastapi.scaffolder import generate_fastapi_resource
+
+__all__ = ["generate_fastapi_boilerplate", "generate_fastapi_resource"]

devctl-1.0.0/devctl/generators/fastapi.py → devctl-1.2.1/devctl/generators/fastapi/generator.py

@@ -5,8 +5,10 @@ Includes boilerplate generation with Uvicorn and Pydantic.
 
 import os
 import subprocess
+import sys
 
 import typer
+from jinja2 import Environment, FileSystemLoader
 
 
 def generate_fastapi_boilerplate(project_name: str) -> bool:
@@ -20,43 +22,42 @@ def generate_fastapi_boilerplate(project_name: str) -> bool:
     try:
         os.makedirs(project_path, exist_ok=True)
 
-        # 1. Create main.py
-        main_py = """from fastapi import FastAPI
-
-app = FastAPI(title="devctl FastAPI project")
-
-@app.get("/")
-def read_root():
-    return {"Hello": "from devctl FastAPI!"}
+        templates_dir = os.path.join(os.path.dirname(__file__), "templates", "config")
+        env = Environment(loader=FileSystemLoader(templates_dir))
 
-@app.get("/items/{item_id}")
-def read_item(item_id: int, q: str = None):
-    return {"item_id": item_id, "q": q}
-"""
-        with open(os.path.join(project_path, "main.py"), "w") as f:
-            f.write(main_py)
+        # 1. Create main.py
+        main_content = env.get_template("main.py.j2").render()
+        with open(os.path.join(project_path, "main.py"), "w", encoding="utf-8") as f:
+            f.write(main_content)
 
         # 2. Create requirements.txt
-        requirements = """fastapi
-uvicorn[standard]
-pydantic
-"""
-        with open(os.path.join(project_path, "requirements.txt"), "w") as f:
-            f.write(requirements)
+        req_content = env.get_template("requirements.txt.j2").render()
+        with open(os.path.join(project_path, "requirements.txt"), "w", encoding="utf-8") as f:
+            f.write(req_content)
+
+        python_exe = "python" if sys.platform == "win32" else "python3"
 
         # 3. Create virtual environment
         typer.secho("Creating virtual environment...", fg=typer.colors.CYAN)
-        subprocess.run(["python3", "-m", "venv", ".venv"], cwd=project_path, check=True)
+        subprocess.run(
+            [python_exe, "-m", "venv", ".venv"],
+            cwd=project_path,
+            check=True,
+            shell=(sys.platform == "win32"),
+        )
 
         # 4. Install dependencies
         typer.secho("Installing dependencies (fastapi, uvicorn)...", fg=typer.colors.CYAN)
-        # Note: on Linux it's .venv/bin/pip
-        pip_path = os.path.join(".venv", "bin", "pip")
+        if sys.platform == "win32":
+            pip_path = os.path.join(".venv", "Scripts", "pip.exe")
+        else:
+            pip_path = os.path.join(".venv", "bin", "pip")
         subprocess.run(
             [pip_path, "install", "-r", "requirements.txt"],
             cwd=project_path,
             check=True,
             stdout=subprocess.DEVNULL,
+            shell=(sys.platform == "win32"),
         )
 
         typer.secho(f"FastAPI project '{safe_name}' successfully generated!", fg=typer.colors.GREEN)