boilerworks 0.1.0__tar.gz

boilerworks-0.1.0/.gitignore

@@ -0,0 +1,2 @@
+.idea/
+backend/backend.iml

boilerworks-0.1.0/PKG-INFO

@@ -0,0 +1,230 @@
+Metadata-Version: 2.4
+Name: boilerworks
+Version: 0.1.0
+Summary: Production-ready project templates — assembled in seconds.
+Project-URL: Homepage, https://boilerworks.dev
+Project-URL: Repository, https://github.com/ConflictHQ/boilerworks
+Project-URL: Issues, https://github.com/ConflictHQ/boilerworks/issues
+License: MIT
+Keywords: boilerplate,cli,scaffolding,templates
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1
+Requires-Dist: gitpython>=3.1
+Requires-Dist: jinja2>=3.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.0
+Description-Content-Type: text/markdown
+
+# Boilerworks
+
+**Production-ready project templates — assembled in seconds.**
+
+Boilerworks is a CLI that clones and configures any of 26 opinionated, best-of-breed project templates. Stop re-solving auth, permissions, Docker, CI, and admin panels from scratch. Pick a stack, run `boilerworks init`, and get straight to your business logic.
+
+```bash
+pip install boilerworks
+boilerworks setup    # interactive wizard → writes boilerworks.yaml
+boilerworks init     # clone + configure the template
+cd my-project
+docker compose up -d # full stack running in seconds
+```
+
+---
+
+## Installation
+
+```bash
+pip install boilerworks
+# or with uv:
+uv tool install boilerworks
+```
+
+Requires Python 3.12+.
+
+---
+
+## Quick Start
+
+### 1. Run the setup wizard
+
+```bash
+boilerworks setup
+```
+
+Answer 13 questions about your project (name, template, cloud, compliance, etc.) and a `boilerworks.yaml` manifest is written to the current directory.
+
+### 2. Generate the project
+
+```bash
+boilerworks init
+```
+
+Boilerworks clones the selected template, replaces all `boilerworks` references with your project name, and runs `git init` to give you a clean starting commit.
+
+### 3. Start developing
+
+```bash
+cd my-project
+docker compose up -d
+# Visit http://localhost:3000
+```
+
+One command. Full stack. No manual setup.
+
+---
+
+## Template Catalogue
+
+26 templates across three sizes:
+
+| Size | Description | Auth | Deploy Target |
+|------|-------------|------|---------------|
+| **Full** | Apps with users | Session auth, permissions, org management | VPS, containers, Kubernetes |
+| **Micro** | API services | API-key auth | VPS, containers |
+| **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages |
+
+### Full Templates (15)
+
+| Name | Backend | Frontend |
+|------|---------|----------|
+| [django-nextjs](https://github.com/ConflictHQ/boilerworks-django-nextjs) | Django 5 | Next.js 16 |
+| [nestjs-nextjs](https://github.com/ConflictHQ/boilerworks-nestjs-nextjs) | NestJS 11 | Next.js 16 |
+| [rails-hotwire](https://github.com/ConflictHQ/boilerworks-rails-hotwire) | Rails 8 | Hotwire + Tailwind |
+| [rails-nextjs](https://github.com/ConflictHQ/boilerworks-rails-nextjs) | Rails 8 | Next.js 16 |
+| [spring-angular](https://github.com/ConflictHQ/boilerworks-spring-angular) | Spring Boot 3 | Angular 19 |
+| [go-nextjs](https://github.com/ConflictHQ/boilerworks-go-nextjs) | Go + Chi | Next.js 16 |
+| [phoenix-liveview](https://github.com/ConflictHQ/boilerworks-phoenix-liveview) | Phoenix 1.7 | LiveView |
+| [laravel-vue](https://github.com/ConflictHQ/boilerworks-laravel-vue) | Laravel 12 | Inertia + Vue 3 |
+| [django-htmx](https://github.com/ConflictHQ/boilerworks-django-htmx) | Django 5 | HTMX + Alpine.js |
+| [fastapi-nextjs](https://github.com/ConflictHQ/boilerworks-fastapi-nextjs) | FastAPI | Next.js 16 |
+| [spring-nextjs](https://github.com/ConflictHQ/boilerworks-spring-nextjs) | Spring Boot 3 | Next.js 16 |
+| [laravel-livewire](https://github.com/ConflictHQ/boilerworks-laravel-livewire) | Laravel 12 | Livewire 3 |
+| [go-htmx](https://github.com/ConflictHQ/boilerworks-go-htmx) | Go + Chi | HTMX + Templ |
+| [fastapi-htmx](https://github.com/ConflictHQ/boilerworks-fastapi-htmx) | FastAPI | HTMX + Alpine.js |
+| [saleor-nextjs](https://github.com/ConflictHQ/boilerworks-saleor-nextjs) | Saleor (Django) | Next.js 16 |
+
+### Micro Templates (6)
+
+| Name | Backend |
+|------|---------|
+| [django-micro](https://github.com/ConflictHQ/boilerworks-django-micro) | Django 5 (DRF/Ninja) |
+| [fastapi-micro](https://github.com/ConflictHQ/boilerworks-fastapi-micro) | FastAPI |
+| [nestjs-micro](https://github.com/ConflictHQ/boilerworks-nestjs-micro) | NestJS 11 |
+| [go-micro](https://github.com/ConflictHQ/boilerworks-go-micro) | Go + Chi |
+| [rust-micro](https://github.com/ConflictHQ/boilerworks-rust-micro) | Axum (Rust) |
+| [cherrypy-micro](https://github.com/ConflictHQ/boilerworks-cherrypy-micro) | CherryPy |
+
+### Edge Templates (5)
+
+| Name | Framework |
+|------|-----------|
+| [sveltekit-full](https://github.com/ConflictHQ/boilerworks-sveltekit-full) | SvelteKit |
+| [remix-full](https://github.com/ConflictHQ/boilerworks-remix-full) | Remix |
+| [hono-micro](https://github.com/ConflictHQ/boilerworks-hono-micro) | Hono (Cloudflare Workers) |
+| [nuxt-full](https://github.com/ConflictHQ/boilerworks-nuxt-full) | Nuxt 4 |
+| [astro-site](https://github.com/ConflictHQ/boilerworks-astro-site) | Astro |
+
+---
+
+## Commands
+
+```bash
+boilerworks --help              # show all commands
+boilerworks list                # show all 26 templates
+boilerworks list --size micro   # filter by size
+boilerworks list --language python  # filter by language
+boilerworks setup               # interactive wizard
+boilerworks init                # generate project from boilerworks.yaml
+boilerworks init --dry-run      # preview what would happen
+boilerworks init --manifest ./path/to/boilerworks.yaml
+boilerworks init --output /path/to/output
+```
+
+---
+
+## boilerworks.yaml
+
+The manifest file describes your project. Generated by `boilerworks setup`, editable by hand.
+
+```yaml
+project: my-app
+family: django-nextjs
+size: full
+topology: standard
+cloud: aws
+ops: true
+region: us-east-1
+domain: myapp.com
+mobile: false
+web_presence: false
+compliance:
+  - soc2
+services:
+  email: ses
+  cache: redis
+data:
+  database: postgres
+  migrations: true
+  seed_data: true
+testing:
+  e2e: playwright
+  unit: true
+  integration: true
+```
+
+See [`boilerworks.yaml.example`](boilerworks.yaml.example) for a fully annotated version.
+
+---
+
+## What Every Template Includes
+
+Every Boilerworks Full template ships with:
+
+- **Auth** — session-based (httpOnly cookies), bcrypt passwords
+- **Permissions** — group-based, per-operation, checked at every endpoint
+- **Background jobs** — Redis-backed queue, retries, dead-letter handling
+- **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally)
+- **Admin** — authenticated management interface with CRUD for all models
+- **Docker Compose** — one command to boot the full stack
+- **CI/CD** — GitHub Actions: lint, test, build, audit
+- **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md
+
+---
+
+## Infrastructure
+
+Pair any template with [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) for production Terraform:
+
+- **AWS** — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager
+- **GCP / Azure** — structured stubs ready for expansion
+
+Select a cloud in `boilerworks setup` and `boilerworks init` will clone and configure the ops repo alongside your app.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process.
+
+Issues and PRs welcome at [github.com/ConflictHQ/boilerworks](https://github.com/ConflictHQ/boilerworks).
+
+---
+
+## Links
+
+- Documentation: [boilerworks.dev](https://boilerworks.dev)
+- Product: [boilerworks.ai](https://boilerworks.ai)
+- Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ)
+
+---
+
+Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC.

boilerworks-0.1.0/README.md

@@ -0,0 +1,204 @@
+# Boilerworks
+
+**Production-ready project templates — assembled in seconds.**
+
+Boilerworks is a CLI that clones and configures any of 26 opinionated, best-of-breed project templates. Stop re-solving auth, permissions, Docker, CI, and admin panels from scratch. Pick a stack, run `boilerworks init`, and get straight to your business logic.
+
+```bash
+pip install boilerworks
+boilerworks setup    # interactive wizard → writes boilerworks.yaml
+boilerworks init     # clone + configure the template
+cd my-project
+docker compose up -d # full stack running in seconds
+```
+
+---
+
+## Installation
+
+```bash
+pip install boilerworks
+# or with uv:
+uv tool install boilerworks
+```
+
+Requires Python 3.12+.
+
+---
+
+## Quick Start
+
+### 1. Run the setup wizard
+
+```bash
+boilerworks setup
+```
+
+Answer 13 questions about your project (name, template, cloud, compliance, etc.) and a `boilerworks.yaml` manifest is written to the current directory.
+
+### 2. Generate the project
+
+```bash
+boilerworks init
+```
+
+Boilerworks clones the selected template, replaces all `boilerworks` references with your project name, and runs `git init` to give you a clean starting commit.
+
+### 3. Start developing
+
+```bash
+cd my-project
+docker compose up -d
+# Visit http://localhost:3000
+```
+
+One command. Full stack. No manual setup.
+
+---
+
+## Template Catalogue
+
+26 templates across three sizes:
+
+| Size | Description | Auth | Deploy Target |
+|------|-------------|------|---------------|
+| **Full** | Apps with users | Session auth, permissions, org management | VPS, containers, Kubernetes |
+| **Micro** | API services | API-key auth | VPS, containers |
+| **Edge** | Serverless apps | Flexible | Cloudflare Workers / Pages |
+
+### Full Templates (15)
+
+| Name | Backend | Frontend |
+|------|---------|----------|
+| [django-nextjs](https://github.com/ConflictHQ/boilerworks-django-nextjs) | Django 5 | Next.js 16 |
+| [nestjs-nextjs](https://github.com/ConflictHQ/boilerworks-nestjs-nextjs) | NestJS 11 | Next.js 16 |
+| [rails-hotwire](https://github.com/ConflictHQ/boilerworks-rails-hotwire) | Rails 8 | Hotwire + Tailwind |
+| [rails-nextjs](https://github.com/ConflictHQ/boilerworks-rails-nextjs) | Rails 8 | Next.js 16 |
+| [spring-angular](https://github.com/ConflictHQ/boilerworks-spring-angular) | Spring Boot 3 | Angular 19 |
+| [go-nextjs](https://github.com/ConflictHQ/boilerworks-go-nextjs) | Go + Chi | Next.js 16 |
+| [phoenix-liveview](https://github.com/ConflictHQ/boilerworks-phoenix-liveview) | Phoenix 1.7 | LiveView |
+| [laravel-vue](https://github.com/ConflictHQ/boilerworks-laravel-vue) | Laravel 12 | Inertia + Vue 3 |
+| [django-htmx](https://github.com/ConflictHQ/boilerworks-django-htmx) | Django 5 | HTMX + Alpine.js |
+| [fastapi-nextjs](https://github.com/ConflictHQ/boilerworks-fastapi-nextjs) | FastAPI | Next.js 16 |
+| [spring-nextjs](https://github.com/ConflictHQ/boilerworks-spring-nextjs) | Spring Boot 3 | Next.js 16 |
+| [laravel-livewire](https://github.com/ConflictHQ/boilerworks-laravel-livewire) | Laravel 12 | Livewire 3 |
+| [go-htmx](https://github.com/ConflictHQ/boilerworks-go-htmx) | Go + Chi | HTMX + Templ |
+| [fastapi-htmx](https://github.com/ConflictHQ/boilerworks-fastapi-htmx) | FastAPI | HTMX + Alpine.js |
+| [saleor-nextjs](https://github.com/ConflictHQ/boilerworks-saleor-nextjs) | Saleor (Django) | Next.js 16 |
+
+### Micro Templates (6)
+
+| Name | Backend |
+|------|---------|
+| [django-micro](https://github.com/ConflictHQ/boilerworks-django-micro) | Django 5 (DRF/Ninja) |
+| [fastapi-micro](https://github.com/ConflictHQ/boilerworks-fastapi-micro) | FastAPI |
+| [nestjs-micro](https://github.com/ConflictHQ/boilerworks-nestjs-micro) | NestJS 11 |
+| [go-micro](https://github.com/ConflictHQ/boilerworks-go-micro) | Go + Chi |
+| [rust-micro](https://github.com/ConflictHQ/boilerworks-rust-micro) | Axum (Rust) |
+| [cherrypy-micro](https://github.com/ConflictHQ/boilerworks-cherrypy-micro) | CherryPy |
+
+### Edge Templates (5)
+
+| Name | Framework |
+|------|-----------|
+| [sveltekit-full](https://github.com/ConflictHQ/boilerworks-sveltekit-full) | SvelteKit |
+| [remix-full](https://github.com/ConflictHQ/boilerworks-remix-full) | Remix |
+| [hono-micro](https://github.com/ConflictHQ/boilerworks-hono-micro) | Hono (Cloudflare Workers) |
+| [nuxt-full](https://github.com/ConflictHQ/boilerworks-nuxt-full) | Nuxt 4 |
+| [astro-site](https://github.com/ConflictHQ/boilerworks-astro-site) | Astro |
+
+---
+
+## Commands
+
+```bash
+boilerworks --help              # show all commands
+boilerworks list                # show all 26 templates
+boilerworks list --size micro   # filter by size
+boilerworks list --language python  # filter by language
+boilerworks setup               # interactive wizard
+boilerworks init                # generate project from boilerworks.yaml
+boilerworks init --dry-run      # preview what would happen
+boilerworks init --manifest ./path/to/boilerworks.yaml
+boilerworks init --output /path/to/output
+```
+
+---
+
+## boilerworks.yaml
+
+The manifest file describes your project. Generated by `boilerworks setup`, editable by hand.
+
+```yaml
+project: my-app
+family: django-nextjs
+size: full
+topology: standard
+cloud: aws
+ops: true
+region: us-east-1
+domain: myapp.com
+mobile: false
+web_presence: false
+compliance:
+  - soc2
+services:
+  email: ses
+  cache: redis
+data:
+  database: postgres
+  migrations: true
+  seed_data: true
+testing:
+  e2e: playwright
+  unit: true
+  integration: true
+```
+
+See [`boilerworks.yaml.example`](boilerworks.yaml.example) for a fully annotated version.
+
+---
+
+## What Every Template Includes
+
+Every Boilerworks Full template ships with:
+
+- **Auth** — session-based (httpOnly cookies), bcrypt passwords
+- **Permissions** — group-based, per-operation, checked at every endpoint
+- **Background jobs** — Redis-backed queue, retries, dead-letter handling
+- **Email** — provider-agnostic (SES, SendGrid, Mailgun, Mailpit locally)
+- **Admin** — authenticated management interface with CRUD for all models
+- **Docker Compose** — one command to boot the full stack
+- **CI/CD** — GitHub Actions: lint, test, build, audit
+- **AI agent shims** — CLAUDE.md, AGENTS.md, bootstrap.md
+
+---
+
+## Infrastructure
+
+Pair any template with [boilerworks-opscode](https://github.com/ConflictHQ/boilerworks-opscode) for production Terraform:
+
+- **AWS** — ECS Fargate, RDS Postgres 16, ElastiCache Redis, ALB, Route53, ACM, S3, Secrets Manager
+- **GCP / Azure** — structured stubs ready for expansion
+
+Select a cloud in `boilerworks setup` and `boilerworks init` will clone and configure the ops repo alongside your app.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the development process.
+
+Issues and PRs welcome at [github.com/ConflictHQ/boilerworks](https://github.com/ConflictHQ/boilerworks).
+
+---
+
+## Links
+
+- Documentation: [boilerworks.dev](https://boilerworks.dev)
+- Product: [boilerworks.ai](https://boilerworks.ai)
+- Templates: [github.com/ConflictHQ](https://github.com/ConflictHQ)
+
+---
+
+Boilerworks is a [Conflict](https://weareconflict.com) brand. CONFLICT is a registered trademark of Conflict LLC.

boilerworks-0.1.0/boilerworks/__init__.py

@@ -0,0 +1,3 @@
+"""Boilerworks — production-ready project templates."""
+
+__version__ = "0.1.0"

boilerworks-0.1.0/boilerworks/bootstrap.py

@@ -0,0 +1,43 @@
+"""Bootstrap command — infrastructure layer orchestration (v2 stub)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from rich.panel import Panel
+
+from boilerworks.console import console, print_info, print_warning
+
+_LAYERS = [
+    ("1", "Foundation", "VPC, subnets, security groups, IAM roles"),
+    ("2", "Data", "RDS (Postgres), ElastiCache (Redis), S3 buckets"),
+    ("3", "Compute", "ECS/GKE cluster, service definitions, autoscaling"),
+    ("4", "Delivery", "Load balancer, TLS certificates, CDN, DNS"),
+    ("5", "Observability", "Metrics, logs, alerts, dashboards"),
+]
+
+_V2_NOTICE = (
+    "Infrastructure bootstrapping is coming in v2.\n"
+    "For now, follow the ops template README to provision infrastructure manually.\n\n"
+    "Ops template: [bold]https://github.com/ConflictHQ/boilerworks-opscode[/bold]"
+)
+
+
+def run_bootstrap(ops_dir: str | None = None, dry_run: bool = True) -> None:
+    """Show the infrastructure bootstrap execution plan."""
+    if ops_dir:
+        ops_path = Path(ops_dir)
+        if not ops_path.exists():
+            print_warning(f"Ops directory not found: {ops_path}")
+    else:
+        print_info("No --ops-dir specified; showing generic plan")
+
+    # Build the plan panel
+    plan_lines = ["[bold]Execution plan — 5 layers[/bold]\n"]
+    for layer_num, layer_name, layer_desc in _LAYERS:
+        plan_lines.append(f"  [cyan]{layer_num}.[/cyan] [bold]{layer_name}[/bold]")
+        plan_lines.append(f"     {layer_desc}")
+        plan_lines.append("")
+
+    console.print(Panel("\n".join(plan_lines).rstrip(), title="[bold]Bootstrap Plan[/bold]", border_style="cyan"))
+    console.print(Panel(_V2_NOTICE, title="[bold yellow]v1 — Stub[/bold yellow]", border_style="yellow"))

boilerworks-0.1.0/boilerworks/cli.py

@@ -0,0 +1,69 @@
+"""Boilerworks CLI — main entry point."""
+
+from __future__ import annotations
+
+import click
+
+from boilerworks import __version__
+
+
+@click.group()
+@click.version_option(__version__, prog_name="boilerworks")
+def main() -> None:
+    """Boilerworks — production-ready project templates."""
+
+
+@main.command()
+def setup() -> None:
+    """Interactive wizard → writes boilerworks.yaml."""
+    from boilerworks.wizard import run_wizard
+
+    run_wizard()
+
+
+@main.command(name="init")
+@click.option("--manifest", "manifest_path", default=None, help="Path to boilerworks.yaml")
+@click.option("--output", "output_dir", default=".", show_default=True, help="Output directory for generated project")
+@click.option("--dry-run", is_flag=True, default=False, help="Print what would happen without doing it")
+def init_command(manifest_path: str | None, output_dir: str, dry_run: bool) -> None:
+    """Clone a template and configure it from boilerworks.yaml."""
+    from boilerworks.generator import generate_from_manifest
+
+    generate_from_manifest(manifest_path=manifest_path, output_dir=output_dir, dry_run=dry_run)
+
+
+@main.command()
+@click.option("--ops-dir", default=None, help="Path to ops directory (default: ../{project}-ops)")
+@click.option("--dry-run", is_flag=True, default=True, help="Show execution plan (v1 only supports dry-run)")
+def bootstrap(ops_dir: str | None, dry_run: bool) -> None:
+    """Show infrastructure bootstrap plan (Terraform — v2)."""
+    from boilerworks.bootstrap import run_bootstrap
+
+    run_bootstrap(ops_dir=ops_dir, dry_run=dry_run)
+
+
+@main.command(name="list")
+@click.option("--size", type=click.Choice(["full", "micro", "edge"]), default=None, help="Filter by template size")
+@click.option(
+    "--language",
+    type=click.Choice(["python", "typescript", "ruby", "php", "java", "go", "elixir", "rust", "svelte"]),
+    default=None,
+    help="Filter by primary language",
+)
+@click.option("--status", type=click.Choice(["done", "building", "planned"]), default=None, help="Filter by status")
+def list_command(size: str | None, language: str | None, status: str | None) -> None:
+    """List all available templates."""
+    from boilerworks.console import print_template_table
+    from boilerworks.registry import Registry
+
+    registry = Registry()
+    templates = registry.list_all()
+
+    if size:
+        templates = [t for t in templates if t.size == size]
+    if language:
+        templates = [t for t in templates if t.language == language]
+    if status:
+        templates = [t for t in templates if t.status == status]
+
+    print_template_table(templates)

boilerworks-0.1.0/boilerworks/console.py

@@ -0,0 +1,106 @@
+"""Rich output helpers for the Boilerworks CLI."""
+
+from __future__ import annotations
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich.text import Text
+
+from boilerworks.registry import TemplateInfo
+
+console = Console()
+
+
+_STATUS_STYLE: dict[str, str] = {
+    "done": "bold green",
+    "building": "bold yellow",
+    "planned": "dim",
+}
+
+_SIZE_STYLE: dict[str, str] = {
+    "full": "cyan",
+    "micro": "magenta",
+    "edge": "blue",
+}
+
+
+def _status_badge(status: str) -> Text:
+    style = _STATUS_STYLE.get(status, "")
+    labels = {"done": "● done", "building": "◐ building", "planned": "○ planned"}
+    return Text(labels.get(status, status), style=style)
+
+
+def print_template_table(templates: list[TemplateInfo]) -> None:
+    """Print a Rich table of templates."""
+    if not templates:
+        console.print("[yellow]No templates match your filters.[/yellow]")
+        return
+
+    table = Table(
+        title=f"Boilerworks Templates ({len(templates)})",
+        show_lines=False,
+        header_style="bold white",
+        border_style="dim",
+        expand=False,
+    )
+
+    table.add_column("Name", style="bold", min_width=20)
+    table.add_column("Size", min_width=6)
+    table.add_column("Language", min_width=11)
+    table.add_column("Backend", min_width=16)
+    table.add_column("Frontend", min_width=16)
+    table.add_column("Status", min_width=13)
+    table.add_column("Description", min_width=30)
+
+    for t in templates:
+        size_text = Text(t.size, style=_SIZE_STYLE.get(t.size, ""))
+        table.add_row(
+            t.name,
+            size_text,
+            t.language,
+            t.backend,
+            t.frontend if t.frontend else "—",
+            _status_badge(t.status),
+            t.description,
+        )
+
+    console.print(table)
+
+
+def print_template_detail(template: TemplateInfo) -> None:
+    """Print a Rich panel with full template details."""
+    lines = [
+        f"[bold]Name:[/bold]       {template.name}",
+        f"[bold]Repo:[/bold]       {template.repo}",
+        f"[bold]Size:[/bold]       {template.size}",
+        f"[bold]Language:[/bold]   {template.language}",
+        f"[bold]Backend:[/bold]    {template.backend}",
+        f"[bold]Frontend:[/bold]   {template.frontend or '—'}",
+        f"[bold]Status:[/bold]     {template.status}",
+        f"[bold]Topologies:[/bold] {', '.join(template.topologies)}",
+        "",
+        f"[bold]Best for:[/bold]   {template.best_for}",
+        f"[bold]Description:[/bold] {template.description}",
+    ]
+    console.print(Panel("\n".join(lines), title=f"[bold cyan]{template.name}[/bold cyan]", border_style="cyan"))
+
+
+def print_success(message: str) -> None:
+    """Print a success message."""
+    console.print(f"[bold green]✓[/bold green] {message}")
+
+
+def print_error(message: str) -> None:
+    """Print an error message."""
+    console.print(f"[bold red]✗[/bold red] {message}")
+
+
+def print_info(message: str) -> None:
+    """Print an informational message."""
+    console.print(f"[dim]→[/dim] {message}")
+
+
+def print_warning(message: str) -> None:
+    """Print a warning message."""
+    console.print(f"[bold yellow]![/bold yellow] {message}")