FastAPI-fastkit 1.2.0__tar.gz → 1.3.0__tar.gz

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: FastAPI-fastkit
-Version: 1.2.0
+Version: 1.3.0
 Summary: Fast, easy-to-use starter kit for new users of Python and FastAPI
 Author-Email: bnbong <bbbong9@gmail.com>
 License: MIT
@@ -12,12 +12,13 @@ Requires-Python: >=3.12
 Requires-Dist: click>=8.1.7
 Requires-Dist: rich>=13.9.2
 Provides-Extra: dev
-Requires-Dist: pytest>=8.3.3; extra == "dev"
+Requires-Dist: pytest>=9.0.3; extra == "dev"
 Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
-Requires-Dist: black>=24.10.0; extra == "dev"
+Requires-Dist: black>=26.3.1; extra == "dev"
 Requires-Dist: pre-commit>=4.0.1; extra == "dev"
 Requires-Dist: mypy>=1.12.0; extra == "dev"
 Requires-Dist: isort>=5.13.2; extra == "dev"
+Requires-Dist: pygments>=2.20.0; extra == "dev"
 Description-Content-Type: text/markdown
 
 <p align="center">
@@ -36,6 +37,9 @@ Description-Content-Type: text/markdown
 <a href="https://codecov.io/gh/bnbong/FastAPI-fastkit" >
     <img src="https://codecov.io/gh/bnbong/FastAPI-fastkit/graph/badge.svg?token=WS0B6WWD8K"/>
 </a>
+<a href="https://pepy.tech/project/fastapi-fastkit">
+    <img src="https://static.pepy.tech/personalized-badge/fastapi-fastkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads" alt="PyPI Downloads">
+</a>
 </p>
 
 ---
@@ -47,6 +51,7 @@ This project was inspired by the `SpringBoot initializer` & Python Django's `dja
 ## Key Features
 
 - **⚡ Immediate FastAPI project creation** : Super-fast FastAPI workspace & project creation via CLI, inspired by `django-admin` feature of [Python Django](https://github.com/django/django)
+- **✨ Interactive project builder**: Guided step-by-step feature selection for databases, authentication, caching, monitoring, and more with auto-generated code
 - **🎨 Prettier CLI output** : Beautiful CLI experience powered by [rich library](https://github.com/Textualize/rich)
 - **📋 Standards-based FastAPI project templates** : Templates follow Python standards and common FastAPI patterns.
 - **🔍 Automated template quality assurance** : Weekly automated testing ensures all templates remain functional and up-to-date
@@ -79,6 +84,29 @@ fastkit init [OPTIONS]
   - `--package-manager` [pip|uv|pdm|poetry]
   - Stack selection: `minimal` | `standard` | `full` (interactive)
 
+### Create a project with interactive mode
+```console
+fastkit init --interactive
+```
+- What it does: Guided step-by-step project setup with intelligent feature selection
+- Features:
+  - **Architecture preset**: `minimal` | `single-module` | `classic-layered` | `domain-starter` (default)
+  - **Database selection**: PostgreSQL, MySQL, MongoDB, Redis, SQLite
+  - **Authentication**: JWT, OAuth2, FastAPI-Users, Session-based
+  - **Background tasks**: Celery, Dramatiq
+  - **Caching**: Redis, fastapi-cache2
+  - **Monitoring**: Loguru, OpenTelemetry, Prometheus
+  - **Testing**: Basic (pytest), Coverage, Advanced (with faker, factory-boy)
+  - **Utilities**: CORS, Rate-Limiting, Pagination, WebSocket
+  - **Deployment**: Docker, docker-compose with auto-generated configs
+  - **Package manager**: pip, uv, pdm, poetry
+  - **Custom packages**: Add your own dependencies
+- Auto-generates (varies by preset — see [the matrix](https://bnbong.github.io/FastAPI-fastkit/reference/preset-feature-matrix/) for details):
+  - `main.py` regenerated from selected features for `minimal` / `single-module`; preserved as-shipped for `classic-layered` / `domain-starter`
+  - Database and authentication configuration files at preset-specific paths
+  - Docker deployment files (`Dockerfile`, `docker-compose.yml`) with the preset's correct uvicorn entrypoint
+  - Test configuration (pytest with coverage)
+
 ### Create a project from a template
 ```console
 fastkit startdemo [TEMPLATE] [OPTIONS]
@@ -117,9 +145,11 @@ fastkit deleteproject <project_name>
 
 For comprehensive guides and detailed usage instructions, visit our documentation:
 
+- 🧭 **[Which starter should I choose?](https://bnbong.github.io/FastAPI-fastkit/user-guide/choosing-a-starter/)** - Beginner decision guide for `startdemo` templates and interactive presets
 - 📚 **[User Guide](https://bnbong.github.io/FastAPI-fastkit/user-guide/quick-start/)** - Detailed installation and usage guides
 - 🎯 **[Tutorial](https://bnbong.github.io/FastAPI-fastkit/tutorial/getting-started/)** - Step-by-step tutorials for beginners
 - 📖 **[CLI Reference](https://bnbong.github.io/FastAPI-fastkit/user-guide/cli-reference/)** - Complete command reference
+- 🧱 **[Architecture Preset Matrix](https://bnbong.github.io/FastAPI-fastkit/reference/preset-feature-matrix/)** - Per-preset / per-feature contract for interactive generation
 - 🔍 **[Template Quality Assurance](https://bnbong.github.io/FastAPI-fastkit/reference/template-quality-assurance/)** - Automated testing and quality standards
 
 ## Contributing

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/README.md

@@ -14,6 +14,9 @@
 <a href="https://codecov.io/gh/bnbong/FastAPI-fastkit" >
     <img src="https://codecov.io/gh/bnbong/FastAPI-fastkit/graph/badge.svg?token=WS0B6WWD8K"/>
 </a>
+<a href="https://pepy.tech/project/fastapi-fastkit">
+    <img src="https://static.pepy.tech/personalized-badge/fastapi-fastkit?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads" alt="PyPI Downloads">
+</a>
 </p>
 
 ---
@@ -25,6 +28,7 @@ This project was inspired by the `SpringBoot initializer` & Python Django's `dja
 ## Key Features
 
 - **⚡ Immediate FastAPI project creation** : Super-fast FastAPI workspace & project creation via CLI, inspired by `django-admin` feature of [Python Django](https://github.com/django/django)
+- **✨ Interactive project builder**: Guided step-by-step feature selection for databases, authentication, caching, monitoring, and more with auto-generated code
 - **🎨 Prettier CLI output** : Beautiful CLI experience powered by [rich library](https://github.com/Textualize/rich)
 - **📋 Standards-based FastAPI project templates** : Templates follow Python standards and common FastAPI patterns.
 - **🔍 Automated template quality assurance** : Weekly automated testing ensures all templates remain functional and up-to-date
@@ -57,6 +61,29 @@ fastkit init [OPTIONS]
   - `--package-manager` [pip|uv|pdm|poetry]
   - Stack selection: `minimal` | `standard` | `full` (interactive)
 
+### Create a project with interactive mode
+```console
+fastkit init --interactive
+```
+- What it does: Guided step-by-step project setup with intelligent feature selection
+- Features:
+  - **Architecture preset**: `minimal` | `single-module` | `classic-layered` | `domain-starter` (default)
+  - **Database selection**: PostgreSQL, MySQL, MongoDB, Redis, SQLite
+  - **Authentication**: JWT, OAuth2, FastAPI-Users, Session-based
+  - **Background tasks**: Celery, Dramatiq
+  - **Caching**: Redis, fastapi-cache2
+  - **Monitoring**: Loguru, OpenTelemetry, Prometheus
+  - **Testing**: Basic (pytest), Coverage, Advanced (with faker, factory-boy)
+  - **Utilities**: CORS, Rate-Limiting, Pagination, WebSocket
+  - **Deployment**: Docker, docker-compose with auto-generated configs
+  - **Package manager**: pip, uv, pdm, poetry
+  - **Custom packages**: Add your own dependencies
+- Auto-generates (varies by preset — see [the matrix](https://bnbong.github.io/FastAPI-fastkit/reference/preset-feature-matrix/) for details):
+  - `main.py` regenerated from selected features for `minimal` / `single-module`; preserved as-shipped for `classic-layered` / `domain-starter`
+  - Database and authentication configuration files at preset-specific paths
+  - Docker deployment files (`Dockerfile`, `docker-compose.yml`) with the preset's correct uvicorn entrypoint
+  - Test configuration (pytest with coverage)
+
 ### Create a project from a template
 ```console
 fastkit startdemo [TEMPLATE] [OPTIONS]
@@ -95,9 +122,11 @@ fastkit deleteproject <project_name>
 
 For comprehensive guides and detailed usage instructions, visit our documentation:
 
+- 🧭 **[Which starter should I choose?](https://bnbong.github.io/FastAPI-fastkit/user-guide/choosing-a-starter/)** - Beginner decision guide for `startdemo` templates and interactive presets
 - 📚 **[User Guide](https://bnbong.github.io/FastAPI-fastkit/user-guide/quick-start/)** - Detailed installation and usage guides
 - 🎯 **[Tutorial](https://bnbong.github.io/FastAPI-fastkit/tutorial/getting-started/)** - Step-by-step tutorials for beginners
 - 📖 **[CLI Reference](https://bnbong.github.io/FastAPI-fastkit/user-guide/cli-reference/)** - Complete command reference
+- 🧱 **[Architecture Preset Matrix](https://bnbong.github.io/FastAPI-fastkit/reference/preset-feature-matrix/)** - Per-preset / per-feature contract for interactive generation
 - 🔍 **[Template Quality Assurance](https://bnbong.github.io/FastAPI-fastkit/reference/template-quality-assurance/)** - Automated testing and quality standards
 
 ## Contributing

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/pyproject.toml

@@ -11,7 +11,7 @@ dependencies = [
 ]
 requires-python = ">=3.12"
 readme = "README.md"
-version = "1.2.0"
+version = "1.3.0"
 
 [project.license]
 text = "MIT"
@@ -24,12 +24,13 @@ Changelog = "https://bnbong.github.io/FastAPI-fastkit/changelog/"
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=8.3.3",
+    "pytest>=9.0.3",
     "pytest-cov>=6.2.1",
-    "black>=24.10.0",
+    "black>=26.3.1",
     "pre-commit>=4.0.1",
     "mypy>=1.12.0",
     "isort>=5.13.2",
+    "pygments>=2.20.0",
 ]
 
 [project.scripts]
@@ -120,6 +121,9 @@ docs = [
     "mkdocs-static-i18n>=1.3.0",
     "pyyaml>=6.0.3",
     "types-PyYAML>=6.0.12.20250915",
+    "pygments>=2.20.0",
+    "requests>=2.33.0",
+    "pymdown-extensions>=10.17.2",
 ]
 translation = [
     "openai>=2.8.1",

fastapi_fastkit-1.3.0/src/fastapi_fastkit/__init__.py

@@ -0,0 +1 @@
+__version__ = 'v1.3.0'

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/src/fastapi_fastkit/backend/inspector.py

@@ -23,19 +23,23 @@ import os
 import shutil
 import subprocess
 import sys
+import tomllib
 from pathlib import Path
 from typing import Any, Callable, Dict, List, Optional, Tuple
 
 import yaml
 
 from fastapi_fastkit.backend.main import (
+    _parse_setup_dependencies,
     create_venv,
     find_template_core_modules,
     inject_project_metadata,
     install_dependencies_with_manager,
 )
+from fastapi_fastkit.backend.package_managers.poetry_manager import (
+    _parse_pip_requirement,
+)
 from fastapi_fastkit.backend.transducer import copy_and_convert_template
-from fastapi_fastkit.core.settings import settings
 from fastapi_fastkit.utils.logging import debug_log, get_logger
 from fastapi_fastkit.utils.main import print_error, print_success, print_warning
 
@@ -127,7 +131,6 @@ class TemplateInspector:
 
     def _force_cleanup_directory(self, directory_path: str) -> None:
         """Force cleanup of directory with multiple strategies."""
-        import stat
         import time
 
         max_retries = 5
@@ -396,20 +399,39 @@ class TemplateInspector:
         return True
 
     def _check_file_structure(self) -> bool:
-        """Check the required file and directory structure."""
-        required_paths = [
-            "tests",
-            "requirements.txt-tpl",
-            "setup.py-tpl",
-            "README.md-tpl",
+        """Check the required file and directory structure.
+
+        Modern templates may ship ``pyproject.toml-tpl`` as the primary metadata
+        file; ``setup.py-tpl`` remains accepted for backward compatibility.
+        A template must provide at least one of the two. ``requirements.txt-tpl``
+        is no longer strictly required when ``pyproject.toml-tpl`` declares
+        ``[project].dependencies``.
+        """
+        always_required = ["tests", "README.md-tpl"]
+        metadata_candidates = ["pyproject.toml-tpl", "setup.py-tpl"]
+
+        missing_required = [
+            path for path in always_required if not (self.template_path / path).exists()
         ]
+        has_metadata = any(
+            (self.template_path / name).exists() for name in metadata_candidates
+        )
 
-        for path in required_paths:
-            if not (self.template_path / path).exists():
+        if missing_required:
+            for path in missing_required:
                 error_msg = f"Missing required path: {path}"
                 self.errors.append(error_msg)
                 debug_log(f"File structure check failed: {error_msg}", "error")
-                return False
+        if not has_metadata:
+            error_msg = (
+                "Missing metadata file: expected pyproject.toml-tpl "
+                "(preferred) or setup.py-tpl"
+            )
+            self.errors.append(error_msg)
+            debug_log(f"File structure check failed: {error_msg}", "error")
+
+        if missing_required or not has_metadata:
+            return False
 
         debug_log("File structure check passed", "info")
         return True
@@ -427,40 +449,139 @@ class TemplateInspector:
         return True
 
     def _check_dependencies(self) -> bool:
-        """Check the dependencies in both setup.py-tpl and requirements.txt-tpl."""
+        """Check that FastAPI is declared in at least one supported source.
+
+        All three metadata sources are consulted independently:
+
+        - ``requirements.txt-tpl``
+        - ``pyproject.toml-tpl`` ``[project].dependencies``
+        - ``setup.py-tpl`` ``install_requires``
+
+        The check passes if *any* source declares ``fastapi``, so a template
+        with a stale ``requirements.txt-tpl`` still passes when
+        ``pyproject.toml-tpl`` is authoritative. It fails only when every
+        present source is missing ``fastapi`` (or when no source exists at
+        all — that also implies no metadata file, which
+        ``_check_file_structure`` already rejects).
+        """
         req_path = self.template_path / "requirements.txt-tpl"
+        pyproject_path = self.template_path / "pyproject.toml-tpl"
         setup_path = self.template_path / "setup.py-tpl"
 
-        if not req_path.exists():
-            error_msg = "requirements.txt-tpl not found"
-            self.errors.append(error_msg)
-            debug_log(f"Dependencies check failed: {error_msg}", "error")
-            return False
-        if not setup_path.exists():
-            error_msg = "setup.py-tpl not found"
+        sources_checked: List[str] = []
+        fastapi_declared = False
+
+        if req_path.exists():
+            sources_checked.append("requirements.txt-tpl")
+            try:
+                with open(req_path, encoding="utf-8") as f:
+                    deps = f.read().splitlines()
+                package_names = {
+                    _parse_pip_requirement(dep)[0].lower()
+                    for dep in deps
+                    if dep.strip() and not dep.strip().startswith("#")
+                }
+                debug_log(
+                    f"requirements.txt-tpl dependencies: {sorted(package_names)}",
+                    "debug",
+                )
+                if "fastapi" in package_names:
+                    fastapi_declared = True
+            except (OSError, UnicodeDecodeError) as e:
+                error_msg = f"Error reading requirements.txt-tpl: {e}"
+                self.errors.append(error_msg)
+                debug_log(f"Dependencies check failed: {error_msg}", "error")
+                return False
+
+        if pyproject_path.exists():
+            sources_checked.append("pyproject.toml-tpl")
+            package_names, parse_error = self._extract_pyproject_dependency_names(
+                pyproject_path
+            )
+            if parse_error is not None:
+                self.errors.append(parse_error)
+                debug_log(f"Dependencies check failed: {parse_error}", "error")
+                return False
+            debug_log(
+                f"pyproject.toml-tpl dependencies: {sorted(package_names)}", "debug"
+            )
+            if "fastapi" in package_names:
+                fastapi_declared = True
+
+        if setup_path.exists():
+            sources_checked.append("setup.py-tpl")
+            try:
+                with open(setup_path, encoding="utf-8") as f:
+                    content = f.read()
+                deps = _parse_setup_dependencies(content)
+                package_names = {
+                    _parse_pip_requirement(dep)[0].lower() for dep in deps if dep
+                }
+                debug_log(
+                    f"setup.py-tpl dependencies: {sorted(package_names)}", "debug"
+                )
+                if "fastapi" in package_names:
+                    fastapi_declared = True
+            except (OSError, UnicodeDecodeError) as e:
+                error_msg = f"Error reading setup.py-tpl: {e}"
+                self.errors.append(error_msg)
+                debug_log(f"Dependencies check failed: {error_msg}", "error")
+                return False
+
+        if not sources_checked:
+            error_msg = (
+                "No dependency source found: expected one of requirements.txt-tpl, "
+                "pyproject.toml-tpl, or setup.py-tpl"
+            )
             self.errors.append(error_msg)
             debug_log(f"Dependencies check failed: {error_msg}", "error")
             return False
 
-        try:
-            with open(req_path, encoding="utf-8") as f:
-                deps = f.read().splitlines()
-                package_names = [dep.split("==")[0] for dep in deps if dep]
-                debug_log(f"Found dependencies: {package_names}", "debug")
-                if "fastapi" not in package_names:
-                    error_msg = "FastAPI dependency not found in requirements.txt-tpl"
-                    self.errors.append(error_msg)
-                    debug_log(f"Dependencies check failed: {error_msg}", "error")
-                    return False
-        except (OSError, UnicodeDecodeError) as e:
-            error_msg = f"Error reading requirements.txt-tpl: {e}"
+        if not fastapi_declared:
+            error_msg = (
+                "FastAPI dependency not found in any source ("
+                + ", ".join(sources_checked)
+                + ")"
+            )
             self.errors.append(error_msg)
             debug_log(f"Dependencies check failed: {error_msg}", "error")
             return False
 
-        debug_log("Dependencies check passed", "info")
+        debug_log(
+            f"Dependencies check passed (sources: {', '.join(sources_checked)})",
+            "info",
+        )
         return True
 
+    @staticmethod
+    def _extract_pyproject_dependency_names(
+        pyproject_path: Path,
+    ) -> Tuple[set, Optional[str]]:  # type: ignore
+        """Parse a pyproject.toml-tpl and return (lowercased dep names, error).
+
+        ``error`` is ``None`` on success. Returns an empty set with a descriptive
+        error string when the file is unreadable or malformed.
+        """
+        try:
+            with open(pyproject_path, "rb") as f:
+                data = tomllib.load(f)
+        except (OSError, tomllib.TOMLDecodeError, UnicodeDecodeError) as e:
+            return set(), f"Invalid pyproject.toml-tpl: {e}"
+
+        project = data.get("project", {})
+        raw_deps = project.get("dependencies", []) or []
+        if not isinstance(raw_deps, list):
+            return set(), "pyproject.toml-tpl [project].dependencies must be a list"
+
+        names: set = set()  # type: ignore
+        for dep in raw_deps:
+            if not isinstance(dep, str) or not dep.strip():
+                continue
+            name = _parse_pip_requirement(dep)[0]
+            if name:
+                names.add(name.lower())
+        return names, None
+
     def _check_fastapi_implementation(self) -> bool:
         """Check if the template has a proper FastAPI server implementation."""
         try:

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/src/fastapi_fastkit/backend/interactive/__init__.py

@@ -9,6 +9,7 @@
 from .config_builder import InteractiveConfigBuilder
 from .prompts import (
     prompt_additional_features,
+    prompt_architecture_preset,
     prompt_authentication_selection,
     prompt_basic_info,
     prompt_caching_selection,
@@ -31,6 +32,7 @@ from .validators import (
 __all__ = [
     "InteractiveConfigBuilder",
     "prompt_basic_info",
+    "prompt_architecture_preset",
     "prompt_template_selection",
     "prompt_database_selection",
     "prompt_authentication_selection",

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/src/fastapi_fastkit/backend/interactive/config_builder.py

@@ -12,6 +12,7 @@ from fastapi_fastkit.utils.main import console, print_warning
 
 from .prompts import (
     prompt_additional_features,
+    prompt_architecture_preset,
     prompt_basic_info,
     prompt_template_selection,
 )
@@ -51,11 +52,15 @@ class InteractiveConfigBuilder:
         # Step 1: Basic information
         self._collect_basic_info()
 
-        # Step 2: Always use Empty template as base for interactive mode
+        # Step 2: Architecture preset — chosen early so downstream prompts
+        # (and later, preset-specific scaffolding) can branch on the layout.
+        self._collect_architecture_preset()
+
+        # Step 3: Always use Empty template as base for interactive mode
         # (Feature selection will build the project incrementally)
         self.config["base_template"] = None  # None = Empty project
 
-        # Step 3: Feature selections
+        # Step 4: Feature selections
         self._collect_feature_selections()
 
         # Step 4: Build final configuration
@@ -78,6 +83,20 @@ class InteractiveConfigBuilder:
         basic_info = prompt_basic_info()
         self.config.update(basic_info)
 
+    def _collect_architecture_preset(self) -> None:
+        """Collect the user's architecture preset choice.
+
+        Persists the canonical id on the config under ``architecture_preset``
+        (used by downstream code) plus the human-readable description under
+        ``architecture_preset_description`` (used by the confirmation summary
+        so users see what their choice means, not just the raw id).
+        """
+        preset = prompt_architecture_preset(self.settings)
+        self.config["architecture_preset"] = preset
+        self.config["architecture_preset_description"] = (
+            self.settings.ARCHITECTURE_PRESETS.get(preset, "")
+        )
+
     def _collect_template_selection(self) -> None:
         """Collect template selection."""
         template = prompt_template_selection(self.settings)

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/src/fastapi_fastkit/backend/interactive/prompts.py

@@ -15,7 +15,6 @@
 from typing import Any, Dict, List, Optional, cast
 
 import click
-from rich.panel import Panel
 
 from fastapi_fastkit.utils.main import console, print_error
 
@@ -64,6 +63,58 @@ def prompt_basic_info() -> Dict[str, str]:
     }
 
 
+def prompt_architecture_preset(settings: Any) -> str:
+    """
+    Prompt for the project's architecture preset.
+
+    Run early in the interactive flow so downstream prompts (and later,
+    preset-specific scaffolding) can branch on the user's choice. Returns
+    the canonical preset id (one of the keys in
+    ``settings.ARCHITECTURE_PRESETS``).
+
+    The recommended default (``settings.DEFAULT_ARCHITECTURE_PRESET``) is
+    annotated as such in the rendered table so users can spot it at a glance
+    and accept it with a single Enter press.
+
+    Args:
+        settings: FastkitConfig instance
+
+    Returns:
+        Preset id, e.g. ``"domain-starter"``.
+    """
+    console.print("\n[bold cyan]🧱 Architecture Preset[/bold cyan]")
+    console.print(
+        "[dim]Pick a project layout. Generation logic for each preset is "
+        "rolled out incrementally — your choice is recorded in the "
+        "config either way.[/dim]\n"
+    )
+
+    presets: Dict[str, str] = settings.ARCHITECTURE_PRESETS
+    default_id: str = settings.DEFAULT_ARCHITECTURE_PRESET
+    # Derive a display-only mapping so the recommended default is visibly
+    # annotated without mutating the canonical catalog in settings.
+    display_options: Dict[str, str] = {
+        preset_id: (
+            f"{description} [bold green](recommended default)[/bold green]"
+            if preset_id == default_id
+            else description
+        )
+        for preset_id, description in presets.items()
+    }
+    render_selection_table("Architecture Presets", display_options)
+
+    preset_ids = list(presets.keys())
+    default_idx = preset_ids.index(default_id) + 1
+
+    choice = click.prompt(
+        f"\nSelect architecture preset (default: {default_id})",
+        type=click.IntRange(1, len(preset_ids)),
+        default=default_idx,
+    )
+
+    return cast(str, preset_ids[choice - 1])
+
+
 def prompt_template_selection(settings: Any) -> Optional[str]:
     """
     Prompt for base template selection.

{fastapi_fastkit-1.2.0 → fastapi_fastkit-1.3.0}/src/fastapi_fastkit/backend/interactive/selectors.py

@@ -133,6 +133,16 @@ def confirm_selections(config: Dict[str, Any]) -> bool:
     table.add_row("Email", config.get("author_email", "N/A"))
     table.add_row("Description", config.get("description", "N/A"))
 
+    # Architecture preset (interactive ``init`` always sets this; older
+    # callers may not — guard with a falsy check to stay backward compatible).
+    preset = config.get("architecture_preset")
+    if preset:
+        preset_description = config.get("architecture_preset_description", "")
+        table.add_row(
+            "Architecture Preset",
+            f"{preset} — {preset_description}" if preset_description else preset,
+        )
+
     # Template
     if config.get("base_template"):
         table.add_row("Base Template", config["base_template"])