fastapi-fullstack 0.1.7__py3-none-any.whl → 0.1.15__py3-none-any.whl

fastapi_gen/generator.py

@@ -12,31 +12,31 @@ from .config import DatabaseType, FrontendType, ProjectConfig
 console = Console()
 
 
-def _get_database_setup_commands(database: DatabaseType) -> list[str]:
+def _get_database_setup_commands(database: DatabaseType) -> list[tuple[str, str]]:
     """Get database-specific setup commands for post-generation messages.
 
     Args:
         database: The database type selected by the user
 
     Returns:
-        List of command strings to display
+        List of (command, description) tuples to display
     """
     if database == DatabaseType.SQLITE:
         return [
-            "# SQLite database will be created automatically at first run",
-            "make db-migrate       # Create initial migration",
-            "make db-upgrade       # Apply migrations",
+            ("# SQLite database will be created automatically", ""),
+            ("make db-migrate", "Create initial migration"),
+            ("make db-upgrade", "Apply migrations"),
         ]
     elif database == DatabaseType.MONGODB:
         return [
-            "make docker-mongo     # Start MongoDB container",
-            "# Or configure MongoDB Atlas connection in .env",
+            ("make docker-mongo", "Start MongoDB container"),
+            ("# Or configure MongoDB Atlas connection in .env", ""),
         ]
     else:  # PostgreSQL
         return [
-            "make docker-db        # Start PostgreSQL container",
-            "make db-migrate       # Create initial migration",
-            "make db-upgrade       # Apply migrations",
+            ("make docker-db", "Start PostgreSQL container"),
+            ("make db-migrate", "Create initial migration"),
+            ("make db-upgrade", "Apply migrations"),
         ]
 
 
@@ -153,8 +153,18 @@ def post_generation_tasks(project_path: Path, config: ProjectConfig) -> None:
         if config.database.value != "none":
             console.print()
             console.print(f"[bold]{step}. Database setup:[/]")
-            for cmd in _get_database_setup_commands(config.database):
-                console.print(f"  {cmd}")
+            db_commands = _get_database_setup_commands(config.database)
+            for cmd, desc in db_commands:
+                if desc:
+                    console.print(f"  {cmd:22}# {desc}")
+                else:
+                    console.print(f"  {cmd}")
+            if config.database != DatabaseType.MONGODB:
+                console.print()
+                console.print(
+                    "  [dim]⚠️  Run all commands in order:[/] "
+                    "[dim]db-migrate creates the migration, db-upgrade applies it[/]"
+                )
             step += 1
         console.print()
         console.print(f"[bold]{step}. Run backend:[/]")
@@ -184,8 +194,18 @@ def post_generation_tasks(project_path: Path, config: ProjectConfig) -> None:
         if config.database.value != "none":
             console.print()
             console.print(f"[bold]{step}. Database setup:[/]")
-            for cmd in _get_database_setup_commands(config.database):
-                console.print(f"  {cmd}")
+            db_commands = _get_database_setup_commands(config.database)
+            for cmd, desc in db_commands:
+                if desc:
+                    console.print(f"  {cmd:22}# {desc}")
+                else:
+                    console.print(f"  {cmd}")
+            if config.database != DatabaseType.MONGODB:
+                console.print()
+                console.print(
+                    "  [dim]⚠️  Run all commands in order:[/] "
+                    "[dim]db-migrate creates the migration, db-upgrade applies it[/]"
+                )
             step += 1
         console.print()
         console.print(f"[bold]{step}. Run server:[/]")

fastapi_gen/prompts.py

@@ -19,6 +19,7 @@ from .config import (
     LLMProviderType,
     LogfireFeatures,
     OAuthProvider,
+    OrmType,
     ProjectConfig,
     RateLimitStorageType,
     ReverseProxyType,
@@ -152,6 +153,31 @@ def prompt_database() -> DatabaseType:
     )
 
 
+def prompt_orm_type() -> OrmType:
+    """Prompt for ORM library selection."""
+    choices = [
+        questionary.Choice(
+            "SQLAlchemy — full control, supports admin panel",
+            value=OrmType.SQLALCHEMY,
+        ),
+        questionary.Choice(
+            "SQLModel — less boilerplate, no admin panel support",
+            value=OrmType.SQLMODEL,
+        ),
+    ]
+
+    return cast(
+        OrmType,
+        _check_cancelled(
+            questionary.select(
+                "ORM Library:",
+                choices=choices,
+                default=choices[0],
+            ).ask()
+        ),
+    )
+
+
 def prompt_auth() -> AuthType:
     """Prompt for authentication method."""
     console.print()
@@ -263,36 +289,120 @@ def prompt_background_tasks() -> BackgroundTaskType:
     )
 
 
-def prompt_integrations() -> dict[str, bool]:
-    """Prompt for optional integrations."""
+def prompt_integrations(
+    database: DatabaseType,
+    orm_type: OrmType,
+) -> dict[str, bool]:
+    """Prompt for optional integrations.
+
+    Args:
+        database: Selected database type (affects which options are shown).
+        orm_type: Selected ORM type (SQLModel doesn't support admin panel).
+    """
     console.print()
     console.print("[bold cyan]Optional Integrations[/]")
     console.print()
 
+    # Build choices dynamically based on context
+    choices: list[questionary.Choice] = [
+        questionary.Choice(
+            "Redis — required for caching, rate limiting (Redis), task queues",
+            value="redis",
+        ),
+        questionary.Choice(
+            "Caching (fastapi-cache2) — requires Redis",
+            value="caching",
+        ),
+        questionary.Choice(
+            "Rate limiting (slowapi) — optional Redis storage",
+            value="rate_limiting",
+        ),
+        questionary.Choice(
+            "Pagination (fastapi-pagination)",
+            value="pagination",
+            checked=True,
+        ),
+        questionary.Choice(
+            "Sentry — error tracking & monitoring",
+            value="sentry",
+        ),
+        questionary.Choice(
+            "Prometheus — metrics endpoint for monitoring",
+            value="prometheus",
+        ),
+    ]
+
+    # Admin Panel only available with SQLAlchemy (not SQLModel) and SQL database
+    if (
+        database in (DatabaseType.POSTGRESQL, DatabaseType.SQLITE)
+        and orm_type == OrmType.SQLALCHEMY
+    ):
+        choices.append(
+            questionary.Choice(
+                "Admin Panel (SQLAdmin) — web UI for database management",
+                value="admin_panel",
+            )
+        )
+
+    choices.extend(
+        [
+            questionary.Choice(
+                "WebSockets — real-time bidirectional communication",
+                value="websockets",
+            ),
+            questionary.Choice(
+                "File Storage (S3/MinIO) — file upload/download support",
+                value="file_storage",
+            ),
+            questionary.Choice(
+                "AI Agent (PydanticAI/LangGraph/CrewAI) — LLM-powered assistant",
+                value="ai_agent",
+                checked=True,
+            ),
+        ]
+    )
+
+    # Webhooks require database
+    if database != DatabaseType.NONE:
+        choices.append(
+            questionary.Choice(
+                "Webhooks — outbound event notifications",
+                value="webhooks",
+            )
+        )
+
+    choices.extend(
+        [
+            questionary.Choice(
+                "Example CRUD (Item model) — sample API endpoints",
+                value="example_crud",
+                checked=True,
+            ),
+            questionary.Choice(
+                "CORS middleware — cross-origin request support",
+                value="cors",
+                checked=True,
+            ),
+            questionary.Choice(
+                "orjson — faster JSON serialization",
+                value="orjson",
+                checked=True,
+            ),
+        ]
+    )
+
     features = _check_cancelled(
         questionary.checkbox(
             "Select additional features:",
-            choices=[
-                questionary.Choice("Redis (caching/sessions)", value="redis"),
-                questionary.Choice("Caching (fastapi-cache2)", value="caching"),
-                questionary.Choice("Rate limiting (slowapi)", value="rate_limiting"),
-                questionary.Choice(
-                    "Pagination (fastapi-pagination)", value="pagination", checked=True
-                ),
-                questionary.Choice("Sentry (error tracking)", value="sentry"),
-                questionary.Choice("Prometheus (metrics)", value="prometheus"),
-                questionary.Choice("Admin Panel (SQLAdmin)", value="admin_panel"),
-                questionary.Choice("WebSockets", value="websockets"),
-                questionary.Choice("File Storage (S3/MinIO)", value="file_storage"),
-                questionary.Choice("AI Agent (PydanticAI/LangChain)", value="ai_agent"),
-                questionary.Choice("Webhooks (outbound events)", value="webhooks"),
-                questionary.Choice("Example CRUD (Item model)", value="example_crud", checked=True),
-                questionary.Choice("CORS middleware", value="cors", checked=True),
-                questionary.Choice("orjson (faster JSON)", value="orjson", checked=True),
-            ],
+            choices=choices,
         ).ask()
     )
 
+    # Auto-enable Redis for caching (show info message)
+    if "caching" in features and "redis" not in features:
+        console.print("[yellow]ℹ Caching requires Redis — auto-enabled[/]")
+        features.append("redis")
+
     return {
         "enable_redis": "redis" in features,
         "enable_caching": "caching" in features,
@@ -426,7 +536,14 @@ def prompt_reverse_proxy() -> ReverseProxyType:
             "Traefik (included in docker-compose)", value=ReverseProxyType.TRAEFIK_INCLUDED
         ),
         questionary.Choice(
-            "External Traefik (shared between projects)", value=ReverseProxyType.TRAEFIK_EXTERNAL
+            "Traefik (external, shared between projects)",
+            value=ReverseProxyType.TRAEFIK_EXTERNAL,
+        ),
+        questionary.Choice(
+            "Nginx (included in docker-compose)", value=ReverseProxyType.NGINX_INCLUDED
+        ),
+        questionary.Choice(
+            "Nginx (external, config template only)", value=ReverseProxyType.NGINX_EXTERNAL
         ),
         questionary.Choice(
             "None (expose ports directly, use own proxy)", value=ReverseProxyType.NONE
@@ -452,8 +569,8 @@ def prompt_frontend() -> FrontendType:
     console.print()
 
     choices = [
-        questionary.Choice("None (API only)", value=FrontendType.NONE),
         questionary.Choice("Next.js 15 (App Router, TypeScript, Bun)", value=FrontendType.NEXTJS),
+        questionary.Choice("None (API only)", value=FrontendType.NONE),
     ]
 
     return cast(
@@ -497,6 +614,9 @@ def prompt_ai_framework() -> AIFrameworkType:
     choices = [
         questionary.Choice("PydanticAI (recommended)", value=AIFrameworkType.PYDANTIC_AI),
         questionary.Choice("LangChain", value=AIFrameworkType.LANGCHAIN),
+        questionary.Choice("LangGraph (ReAct agent)", value=AIFrameworkType.LANGGRAPH),
+        questionary.Choice("CrewAI (multi-agent crews)", value=AIFrameworkType.CREWAI),
+        questionary.Choice("DeepAgents (agentic coding)", value=AIFrameworkType.DEEPAGENTS),
     ]
 
     return cast(
@@ -516,7 +636,7 @@ def prompt_llm_provider(ai_framework: AIFrameworkType) -> LLMProviderType:
 
     Args:
         ai_framework: The selected AI framework. OpenRouter is only
-            available for PydanticAI.
+            available for PydanticAI (not LangChain, LangGraph, CrewAI, or DeepAgents).
     """
     console.print()
     console.print("[bold cyan]LLM Provider[/]")
@@ -527,7 +647,7 @@ def prompt_llm_provider(ai_framework: AIFrameworkType) -> LLMProviderType:
         questionary.Choice("Anthropic (claude-sonnet-4-5)", value=LLMProviderType.ANTHROPIC),
     ]
 
-    # OpenRouter only available for PydanticAI
+    # OpenRouter only available for PydanticAI (not LangChain, LangGraph, or CrewAI)
     if ai_framework == AIFrameworkType.PYDANTIC_AI:
         choices.append(
             questionary.Choice("OpenRouter (multi-provider)", value=LLMProviderType.OPENROUTER)
@@ -545,18 +665,31 @@ def prompt_llm_provider(ai_framework: AIFrameworkType) -> LLMProviderType:
     )
 
 
-def prompt_websocket_auth() -> WebSocketAuthType:
-    """Prompt for WebSocket authentication method for AI Agent."""
+def prompt_websocket_auth(auth: AuthType) -> WebSocketAuthType:
+    """Prompt for WebSocket authentication method for AI Agent.
+
+    Args:
+        auth: The main auth type. JWT WebSocket auth is only available
+            if JWT is enabled (JWT or BOTH).
+    """
     console.print()
     console.print("[bold cyan]AI Agent WebSocket Authentication[/]")
     console.print()
 
     choices = [
         questionary.Choice("None (public access)", value=WebSocketAuthType.NONE),
-        questionary.Choice("JWT token required", value=WebSocketAuthType.JWT),
-        questionary.Choice("API Key required (query param)", value=WebSocketAuthType.API_KEY),
     ]
 
+    # JWT WebSocket auth only available if main auth uses JWT
+    if auth in (AuthType.JWT, AuthType.BOTH):
+        choices.append(questionary.Choice("JWT token required", value=WebSocketAuthType.JWT))
+
+    # API Key WebSocket auth available if main auth uses API keys
+    if auth in (AuthType.API_KEY, AuthType.BOTH):
+        choices.append(
+            questionary.Choice("API Key required (query param)", value=WebSocketAuthType.API_KEY)
+        )
+
     return cast(
         WebSocketAuthType,
         _check_cancelled(
@@ -679,6 +812,11 @@ def run_interactive_prompts() -> ProjectConfig:
     # Database
     database = prompt_database()
 
+    # ORM type (only for PostgreSQL or SQLite)
+    orm_type = OrmType.SQLALCHEMY
+    if database in (DatabaseType.POSTGRESQL, DatabaseType.SQLITE):
+        orm_type = prompt_orm_type()
+
     # Auth
     auth = prompt_auth()
 
@@ -702,8 +840,8 @@ def run_interactive_prompts() -> ProjectConfig:
     # Background tasks
     background_tasks = prompt_background_tasks()
 
-    # Integrations
-    integrations = prompt_integrations()
+    # Integrations (pass context for dynamic option filtering)
+    integrations = prompt_integrations(database=database, orm_type=orm_type)
 
     # Dev tools
     dev_tools = prompt_dev_tools()
@@ -738,7 +876,7 @@ def run_interactive_prompts() -> ProjectConfig:
     if integrations.get("enable_ai_agent"):
         ai_framework = prompt_ai_framework()
         llm_provider = prompt_llm_provider(ai_framework)
-        websocket_auth = prompt_websocket_auth()
+        websocket_auth = prompt_websocket_auth(auth=auth)
         # Only offer persistence if database is enabled
         if database != DatabaseType.NONE:
             enable_conversation_persistence = _check_cancelled(
@@ -781,6 +919,7 @@ def run_interactive_prompts() -> ProjectConfig:
         author_name=basic_info["author_name"],
         author_email=basic_info["author_email"],
         database=database,
+        orm_type=orm_type,
         auth=auth,
         oauth_provider=oauth_provider,
         enable_session_management=enable_session_management,
@@ -818,6 +957,8 @@ def show_summary(config: ProjectConfig) -> None:
 
     console.print(f"  [cyan]Project:[/] {config.project_name}")
     console.print(f"  [cyan]Database:[/] {config.database.value}")
+    if config.database in (DatabaseType.POSTGRESQL, DatabaseType.SQLITE):
+        console.print(f"  [cyan]ORM:[/] {config.orm_type.value}")
     auth_str = config.auth.value
     if config.oauth_provider != OAuthProvider.NONE:
         auth_str += f" + {config.oauth_provider.value} OAuth"

fastapi_gen/template/VARIABLES.md

@@ -59,6 +59,19 @@ These variables are set automatically by the generator.
 | `db_max_overflow` | int | `10` | Max overflow connections above pool size | Requires SQL database |
 | `db_pool_timeout` | int | `30` | Timeout (seconds) waiting for connection | Requires SQL database |
 
+### ORM Library
+
+| Variable | Type | Default | Description | Dependencies |
+|----------|------|---------|-------------|--------------|
+| `orm_type` | enum | `"sqlalchemy"` | ORM library. Values: `sqlalchemy`, `sqlmodel` | Requires SQL database |
+| `use_sqlalchemy` | bool | `true` | SQLAlchemy is selected | Computed from `orm_type` |
+| `use_sqlmodel` | bool | `false` | SQLModel is selected | Computed from `orm_type` |
+
+**Notes:**
+- SQLModel provides simplified syntax combining SQLAlchemy and Pydantic
+- SQLModel is only available for PostgreSQL and SQLite (not MongoDB)
+- SQLModel uses the same database session and migrations as SQLAlchemy
+
 **Notes:**
 - PostgreSQL uses `asyncpg` for async operations
 - MongoDB uses `motor` for async operations
@@ -174,9 +187,12 @@ These variables are set automatically by the generator.
 | Variable | Type | Default | Description | Dependencies |
 |----------|------|---------|-------------|--------------|
 | `enable_ai_agent` | bool | `false` | Enable AI agent functionality | - |
-| `ai_framework` | enum | `"pydantic_ai"` | AI framework. Values: `pydantic_ai`, `langchain` | Requires `enable_ai_agent` |
+| `ai_framework` | enum | `"pydantic_ai"` | AI framework. Values: `pydantic_ai`, `langchain`, `langgraph`, `crewai`, `deepagents` | Requires `enable_ai_agent` |
 | `use_pydantic_ai` | bool | `true` | PydanticAI is selected | Computed from `ai_framework` |
 | `use_langchain` | bool | `false` | LangChain is selected | Computed from `ai_framework` |
+| `use_langgraph` | bool | `false` | LangGraph (ReAct agent) is selected | Computed from `ai_framework` |
+| `use_crewai` | bool | `false` | CrewAI (multi-agent crews) is selected | Computed from `ai_framework` |
+| `use_deepagents` | bool | `false` | DeepAgents (agentic coding) is selected | Computed from `ai_framework` |
 | `llm_provider` | enum | `"openai"` | LLM provider. Values: `openai`, `anthropic`, `openrouter` | Requires `enable_ai_agent` |
 | `use_openai` | bool | `true` | OpenAI is selected | Computed from `llm_provider` |
 | `use_anthropic` | bool | `false` | Anthropic is selected | Computed from `llm_provider` |
@@ -185,7 +201,10 @@ These variables are set automatically by the generator.
 
 **Notes:**
 - PydanticAI uses `iter()` for full event streaming over WebSocket
-- OpenRouter with LangChain is not supported
+- LangGraph implements a ReAct (Reasoning + Acting) agent pattern with graph-based architecture
+- CrewAI enables multi-agent teams that collaborate on complex tasks
+- DeepAgents provides an agentic coding assistant with built-in filesystem tools (ls, read_file, write_file, edit_file, glob, grep) and task management
+- OpenRouter with LangChain, LangGraph, CrewAI, or DeepAgents is not supported
 
 ---
 
@@ -221,14 +240,20 @@ These variables are set automatically by the generator.
 | `use_github_actions` | bool | `true` | GitHub Actions is selected | Computed from `ci_type` |
 | `use_gitlab_ci` | bool | `false` | GitLab CI is selected | Computed from `ci_type` |
 | `enable_kubernetes` | bool | `false` | Include Kubernetes manifests | - |
-| `reverse_proxy` | enum | `"traefik_included"` | Reverse proxy config. Values: `traefik_included`, `traefik_external`, `none` | Requires Docker |
+| `reverse_proxy` | enum | `"traefik_included"` | Reverse proxy config. Values: `traefik_included`, `traefik_external`, `nginx_included`, `nginx_external`, `none` | Requires Docker |
 | `include_traefik_service` | bool | `true` | Include Traefik container in docker-compose | Computed from `reverse_proxy` |
 | `include_traefik_labels` | bool | `true` | Include Traefik labels on services | Computed from `reverse_proxy` |
+| `use_traefik` | bool | `true` | Using Traefik (included or external) | Computed from `reverse_proxy` |
+| `include_nginx_service` | bool | `false` | Include Nginx container in docker-compose | Computed from `reverse_proxy` |
+| `include_nginx_config` | bool | `false` | Generate nginx configuration files | Computed from `reverse_proxy` |
+| `use_nginx` | bool | `false` | Using Nginx (included or external) | Computed from `reverse_proxy` |
 
 **Reverse Proxy Options:**
 - `traefik_included`: Full Traefik setup included in docker-compose.prod.yml (default)
 - `traefik_external`: Services have Traefik labels but no Traefik container (for shared Traefik)
-- `none`: No reverse proxy, ports exposed directly (use your own nginx/caddy/HAProxy)
+- `nginx_included`: Full Nginx setup included in docker-compose.prod.yml with config template
+- `nginx_external`: Nginx config template only, for external Nginx (no container in compose)
+- `none`: No reverse proxy, ports exposed directly (use your own proxy)
 
 ---
 
@@ -265,6 +290,10 @@ database = "postgresql"
   → use_mongodb = false
   → use_sqlite = false
   → use_database = true
+
+orm_type = "sqlmodel"
+  → use_sqlalchemy = false
+  → use_sqlmodel = true
 ```
 
 These computed variables are used in Jinja2 conditionals within templates:

fastapi_gen/template/cookiecutter.json

@@ -16,6 +16,9 @@
   "db_pool_size": 5,
   "db_max_overflow": 10,
   "db_pool_timeout": 30,
+  "orm_type": "sqlalchemy",
+  "use_sqlalchemy": true,
+  "use_sqlmodel": false,
   "auth": "jwt",
   "use_jwt": true,
   "use_api_key": false,
@@ -58,6 +61,9 @@
   "ai_framework": "pydantic_ai",
   "use_pydantic_ai": true,
   "use_langchain": false,
+  "use_langgraph": false,
+  "use_crewai": false,
+  "use_deepagents": false,
   "llm_provider": "openai",
   "use_openai": true,
   "use_anthropic": false,
@@ -79,6 +85,10 @@
   "reverse_proxy": "traefik_included",
   "include_traefik_service": true,
   "include_traefik_labels": true,
+  "use_traefik": true,
+  "include_nginx_service": false,
+  "include_nginx_config": false,
+  "use_nginx": false,
   "ci_type": "github",
   "use_github_actions": true,
   "use_gitlab_ci": false,

fastapi_gen/template/hooks/post_gen_project.py

@@ -16,10 +16,15 @@ use_database = "{{ cookiecutter.use_database }}" == "True"
 use_postgresql = "{{ cookiecutter.use_postgresql }}" == "True"
 use_sqlite = "{{ cookiecutter.use_sqlite }}" == "True"
 use_mongodb = "{{ cookiecutter.use_mongodb }}" == "True"
+use_sqlalchemy = "{{ cookiecutter.use_sqlalchemy }}" == "True"
+use_sqlmodel = "{{ cookiecutter.use_sqlmodel }}" == "True"
 include_example_crud = "{{ cookiecutter.include_example_crud }}" == "True"
 enable_ai_agent = "{{ cookiecutter.enable_ai_agent }}" == "True"
 use_pydantic_ai = "{{ cookiecutter.use_pydantic_ai }}" == "True"
 use_langchain = "{{ cookiecutter.use_langchain }}" == "True"
+use_langgraph = "{{ cookiecutter.use_langgraph }}" == "True"
+use_crewai = "{{ cookiecutter.use_crewai }}" == "True"
+use_deepagents = "{{ cookiecutter.use_deepagents }}" == "True"
 enable_admin_panel = "{{ cookiecutter.enable_admin_panel }}" == "True"
 enable_websockets = "{{ cookiecutter.enable_websockets }}" == "True"
 enable_redis = "{{ cookiecutter.enable_redis }}" == "True"
@@ -30,9 +35,15 @@ enable_conversation_persistence = "{{ cookiecutter.enable_conversation_persisten
 enable_webhooks = "{{ cookiecutter.enable_webhooks }}" == "True"
 enable_oauth = "{{ cookiecutter.enable_oauth }}" == "True"
 use_jwt = "{{ cookiecutter.use_jwt }}" == "True"
+use_api_key = "{{ cookiecutter.use_api_key }}" == "True"
 use_celery = "{{ cookiecutter.use_celery }}" == "True"
 use_taskiq = "{{ cookiecutter.use_taskiq }}" == "True"
 use_arq = "{{ cookiecutter.use_arq }}" == "True"
+use_github_actions = "{{ cookiecutter.use_github_actions }}" == "True"
+use_gitlab_ci = "{{ cookiecutter.use_gitlab_ci }}" == "True"
+enable_kubernetes = "{{ cookiecutter.enable_kubernetes }}" == "True"
+use_nginx = "{{ cookiecutter.use_nginx }}" == "True"
+enable_logfire = "{{ cookiecutter.enable_logfire }}" == "True"
 
 
 def remove_file(path: str) -> None:
@@ -42,6 +53,23 @@ def remove_file(path: str) -> None:
         print(f"  Removed: {os.path.relpath(path)}")
 
 
+def is_stub_file(filepath: str) -> bool:
+    """Check if file only contains a docstring stub with no real code."""
+    if not os.path.exists(filepath):
+        return False
+    with open(filepath) as f:
+        content = f.read().strip()
+    # Empty file
+    if not content:
+        return True
+    # File only has docstring (triple-quoted string)
+    if content.startswith('"""') and content.endswith('"""'):
+        # Check if there's only one docstring and no code
+        inner = content[3:-3].strip()
+        return '"""' not in inner and "def " not in content and "class " not in content
+    return False
+
+
 def remove_dir(path: str) -> None:
     """Remove a directory if it exists."""
     if os.path.exists(path):
@@ -68,6 +96,12 @@ else:
         remove_file(os.path.join(backend_app, "agents", "assistant.py"))
     if not use_langchain:
         remove_file(os.path.join(backend_app, "agents", "langchain_assistant.py"))
+    if not use_langgraph:
+        remove_file(os.path.join(backend_app, "agents", "langgraph_assistant.py"))
+    if not use_crewai:
+        remove_file(os.path.join(backend_app, "agents", "crewai_assistant.py"))
+    if not use_deepagents:
+        remove_file(os.path.join(backend_app, "agents", "deepagents_assistant.py"))
 
 # --- Example CRUD files ---
 if not include_example_crud or not use_database:
@@ -105,8 +139,8 @@ if not enable_session_management or not use_jwt:
 if not enable_websockets:
     remove_file(os.path.join(backend_app, "api", "routes", "v1", "ws.py"))
 
-# --- Admin panel ---
-if not enable_admin_panel or (not use_postgresql and not use_sqlite):
+# --- Admin panel (requires SQLAlchemy, not SQLModel) ---
+if not enable_admin_panel or (not use_postgresql and not use_sqlite) or not use_sqlalchemy:
     remove_file(os.path.join(backend_app, "admin.py"))
 
 # --- Redis/Cache files ---
@@ -125,6 +159,32 @@ if not enable_oauth:
     remove_file(os.path.join(backend_app, "api", "routes", "v1", "oauth.py"))
     remove_file(os.path.join(backend_app, "core", "oauth.py"))
 
+# --- Security file (only when no auth at all) ---
+if not use_jwt and not use_api_key:
+    remove_file(os.path.join(backend_app, "core", "security.py"))
+
+# --- Auth/User files (when JWT is disabled) ---
+if not use_jwt:
+    remove_file(os.path.join(backend_app, "api", "routes", "v1", "auth.py"))
+    remove_file(os.path.join(backend_app, "api", "routes", "v1", "users.py"))
+    remove_file(os.path.join(backend_app, "db", "models", "user.py"))
+    remove_file(os.path.join(backend_app, "repositories", "user.py"))
+    remove_file(os.path.join(backend_app, "services", "user.py"))
+    remove_file(os.path.join(backend_app, "schemas", "user.py"))
+    remove_file(os.path.join(backend_app, "schemas", "token.py"))
+
+# --- Logfire setup file (when logfire is disabled) ---
+if not enable_logfire:
+    remove_file(os.path.join(backend_app, "core", "logfire_setup.py"))
+
+# --- Cleanup stub files (files with only docstring, no code) ---
+core_dir = os.path.join(backend_app, "core")
+for stub_candidate in ["security.py", "cache.py", "rate_limit.py", "oauth.py", "logfire_setup.py", "csrf.py"]:
+    filepath = os.path.join(core_dir, stub_candidate)
+    if is_stub_file(filepath):
+        remove_file(filepath)
+        print(f"  Removed stub: {os.path.relpath(filepath)}")
+
 # --- Worker/Background tasks ---
 use_any_background_tasks = use_celery or use_taskiq or use_arq
 if not use_any_background_tasks:
@@ -172,6 +232,31 @@ for subdir in ["clients", "agents", "worker", "worker/tasks"]:
 
 print("File cleanup complete.")
 
+# --- CI/CD files cleanup ---
+if not use_github_actions:
+    github_dir = os.path.join(os.getcwd(), ".github")
+    if os.path.exists(github_dir):
+        shutil.rmtree(github_dir)
+        print("Removed .github/ directory (GitHub Actions not enabled)")
+
+if not use_gitlab_ci:
+    gitlab_ci_file = os.path.join(os.getcwd(), ".gitlab-ci.yml")
+    if os.path.exists(gitlab_ci_file):
+        os.remove(gitlab_ci_file)
+        print("Removed .gitlab-ci.yml (GitLab CI not enabled)")
+
+if not enable_kubernetes:
+    kubernetes_dir = os.path.join(os.getcwd(), "kubernetes")
+    if os.path.exists(kubernetes_dir):
+        shutil.rmtree(kubernetes_dir)
+        print("Removed kubernetes/ directory (Kubernetes not enabled)")
+
+if not use_nginx:
+    nginx_dir = os.path.join(os.getcwd(), "nginx")
+    if os.path.exists(nginx_dir):
+        shutil.rmtree(nginx_dir)
+        print("Removed nginx/ directory (Nginx not enabled)")
+
 # Remove frontend folder if not using frontend
 if not use_frontend:
     frontend_dir = os.path.join(os.getcwd(), "frontend")

fastapi_gen/template/{{cookiecutter.project_slug}}/.env.prod.example

@@ -17,6 +17,15 @@ DOMAIN=example.com
 ACME_EMAIL=admin@example.com
 {%- endif %}
 
+{%- if cookiecutter.use_nginx %}
+
+# === Domain Configuration ===
+DOMAIN=example.com
+# Note: Place SSL certificates in nginx/ssl/ directory:
+#   - nginx/ssl/cert.pem (certificate chain)
+#   - nginx/ssl/key.pem (private key)
+{%- endif %}
+
 {%- if cookiecutter.use_postgresql %}
 
 # === PostgreSQL ===