tina4-python 3.11.12__tar.gz → 3.11.13__tar.gz

{tina4_python-3.11.12 → tina4_python-3.11.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tina4-python
-Version: 3.11.12
+Version: 3.11.13
 Summary: Tina4 for Python — 54 built-in features, zero dependencies
 Author-email: Andre van Zuydam <andrevanzuydam@gmail.com>
 License: MIT
@@ -37,13 +37,13 @@ Description-Content-Type: text/markdown
 <h1 align="center">Tina4 Python</h1>
 
 <p align="center">
-  54 built-in features. Zero dependencies. One import, everything works.
+  55 built-in features. Zero dependencies. One import, everything works.
 </p>
 
 <p align="center">
   <a href="https://pypi.org/project/tina4-python/"><img src="https://img.shields.io/pypi/v/tina4-python?color=7b1fa2&label=PyPI" alt="PyPI"></a>
-  <img src="https://img.shields.io/badge/tests-2%2C068%20passing-brightgreen" alt="Tests">
-  <img src="https://img.shields.io/badge/features-54-blue" alt="Features">
+  <img src="https://img.shields.io/badge/tests-2%2C281%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/features-55-blue" alt="Features">
   <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="Zero Deps">
   <a href="https://tina4.com"><img src="https://img.shields.io/badge/docs-tina4.com-7b1fa2" alt="Docs"></a>
 </p>
@@ -72,10 +72,12 @@ tina4 init python ./my-app
 cd my-app && tina4 serve
 ```
 
-Open http://localhost:7145 — your app is running.
+Open http://localhost:7146 — your app is running.
 
 <details>
-<summary><strong>Without the Tina4 CLI</strong></summary>
+<summary><strong>Without the Tina4 CLI (Docker / CI only)</strong></summary>
+
+The framework normally refuses to start without the `tina4` Rust CLI (it owns file watching and SCSS compilation). To bypass — e.g. inside a Docker image where you've already built the assets — set `TINA4_OVERRIDE_CLIENT=true` in `.env`:
 
 ```bash
 # 1. Create project
@@ -85,24 +87,25 @@ uv init && uv add tina4-python
 # 2. Create entry point
 echo 'from tina4_python.core import run; run()' > app.py
 
-# 3. Create .env
+# 3. Create .env (note the override)
 echo 'TINA4_DEBUG=true' > .env
 echo 'TINA4_LOG_LEVEL=ALL' >> .env
+echo 'TINA4_OVERRIDE_CLIENT=true' >> .env
 
 # 4. Create route directory
 mkdir -p src/routes
 
-# 5. Run
+# 5. Run (no file watching, no hot reload in this mode)
 uv run python app.py
 ```
 
-Open http://localhost:7145
+Open http://localhost:7146
 
 </details>
 
 ---
 
-## What's Built In (54 Features)
+## What's Built In (55 Features)
 
 Every feature is built from scratch -- no pip install, no node_modules, no third-party runtime dependencies in core.
 
@@ -119,7 +122,7 @@ Every feature is built from scratch -- no pip install, no node_modules, no third
 | **Developer Tools** (7) | Dev dashboard (11 tabs), dev toolbar, error overlay (Catppuccin Mocha), dev mailbox, hot reload + CSS hot-reload, code metrics (complexity, coupling, maintainability), AI context installer (7 tools) |
 | **Utilities** (7) | DI container (transient + singleton), HtmlElement builder, inline testing (`@tests` decorator), i18n (6 languages), Swagger/OpenAPI auto-generation, CLI scaffolding (`generate model/route/migration/middleware`), structured logging |
 
-**2,066 tests. Zero dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
+**2,281 tests. Zero dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
 
 For full documentation visit **[tina4.com](https://tina4.com)**.
 
@@ -198,7 +201,7 @@ async def hello_name(request, response):
     return response({"message": f"Hello, {name}!"})
 ```
 
-Visit `http://localhost:7145/api/hello` -- routes are auto-discovered, no imports needed.
+Visit `http://localhost:7146/api/hello` -- routes are auto-discovered, no imports needed.
 
 ### 3. Add a database
 
@@ -602,10 +605,10 @@ cache.tag("users").flush()
 
 Set `TINA4_DEBUG=true` in `.env` to enable:
 
-- **Live reload** -- browser auto-refreshes on code changes
-- **CSS hot-reload** -- SCSS changes apply without page refresh
+- **Live reload** -- the `tina4` Rust CLI watches `src/`, `migrations/`, `.env` and POSTs `/__dev/api/reload` to the running server; the framework broadcasts to the browser via WebSocket (`/__dev_reload`) with a polling fallback (`GET /__dev/api/mtime`)
+- **CSS hot-reload** -- SCSS changes apply without a full page refresh
 - **Error overlay** -- rich error display in the browser
-- **Dev admin** at `/__dev/` with 11 tabs: Routes, Queue, Mailbox, Messages, Database, Requests, Errors, WebSocket, System, Tools, Tina4
+- **Dev admin** at `/__dev/` with tabs: Routes, Queue, Mailbox, Messages, Database, Requests, Errors, WebSocket, System, Tools, Tina4
 
 ---
 
@@ -613,7 +616,7 @@ Set `TINA4_DEBUG=true` in `.env` to enable:
 
 ```bash
 tina4python init [dir]             # Scaffold a new project
-tina4python serve [port]           # Start dev server (default: 7145)
+tina4python serve [--port P] [--no-browser] [--no-reload]  # Dev server (default: 0.0.0.0:7146)
 tina4python serve --production     # Auto-install and use best production server (uvicorn)
 tina4python migrate                # Run pending migrations
 tina4python migrate:create <desc>  # Create a migration file
@@ -715,13 +718,13 @@ Benchmarked with `wrk` — 5,000 requests, 50 concurrent, median of 3 runs:
 
 | Framework | JSON req/s | Deps | Features |
 |-----------|-----------|------|----------|
-| **Tina4 Python** | **6,508** | 0 | 54 |
+| **Tina4 Python** | **6,508** | 0 | 55 |
 | FastAPI | 12,652 | 12+ | ~8 |
 | Flask | 4,928 | 6+ | ~7 |
 | Bottle | 4,355 | 0 | ~5 |
 | Django | 4,050 | 20+ | ~22 |
 
-Tina4 Python delivers competitive throughput with **zero dependencies and 54 features** — frameworks with higher req/s have a fraction of the functionality and require dozens of third-party packages.
+Tina4 Python delivers competitive throughput with **zero dependencies and 55 features** — frameworks with higher req/s have a fraction of the functionality and require dozens of third-party packages.
 
 **Across all 4 Tina4 implementations:**
 
@@ -729,7 +732,7 @@ Tina4 Python delivers competitive throughput with **zero dependencies and 54 fea
 |---|--------|-----|------|---------|
 | **JSON req/s** | 6,508 | 29,293 | 10,243 | 84,771 |
 | **Dependencies** | 0 | 0 | 0 | 0 |
-| **Features** | 54 | 54 | 54 | 54 |
+| **Features** | 55 | 55 | 55 | 55 |
 
 Run benchmarks locally: `python benchmarks/benchmark.py --python`
 
@@ -737,15 +740,15 @@ Run benchmarks locally: `python benchmarks/benchmark.py --python`
 
 ## Cross-Framework Parity
 
-Tina4 ships identical features across four languages — same architecture, same conventions, same 54 features:
+Tina4 ships identical features across four languages — same architecture, same conventions, same 55 features:
 
 | | Python | PHP | Ruby | Node.js |
 |---|--------|-----|------|---------|
 | **Package** | `tina4-python` | `tina4stack/tina4php` | `tina4ruby` | `tina4-nodejs` |
-| **Tests** | 2,066 | 1,427 | 1,793 | 1,950 |
-| **Default port** | 7145 | 7146 | 7147 | 7148 |
+| **Tests (v3.11.12)** | 2,281 | 2,073 | 2,508 | 2,897 |
+| **Default port** | 7146 | 7145 | 7147 | 7148 |
 
-**7,236 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
+**~9,700 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
 
 ---
 

{tina4_python-3.11.12 → tina4_python-3.11.13}/README.md

@@ -5,13 +5,13 @@
 <h1 align="center">Tina4 Python</h1>
 
 <p align="center">
-  54 built-in features. Zero dependencies. One import, everything works.
+  55 built-in features. Zero dependencies. One import, everything works.
 </p>
 
 <p align="center">
   <a href="https://pypi.org/project/tina4-python/"><img src="https://img.shields.io/pypi/v/tina4-python?color=7b1fa2&label=PyPI" alt="PyPI"></a>
-  <img src="https://img.shields.io/badge/tests-2%2C068%20passing-brightgreen" alt="Tests">
-  <img src="https://img.shields.io/badge/features-54-blue" alt="Features">
+  <img src="https://img.shields.io/badge/tests-2%2C281%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/features-55-blue" alt="Features">
   <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="Zero Deps">
   <a href="https://tina4.com"><img src="https://img.shields.io/badge/docs-tina4.com-7b1fa2" alt="Docs"></a>
 </p>
@@ -40,10 +40,12 @@ tina4 init python ./my-app
 cd my-app && tina4 serve
 ```
 
-Open http://localhost:7145 — your app is running.
+Open http://localhost:7146 — your app is running.
 
 <details>
-<summary><strong>Without the Tina4 CLI</strong></summary>
+<summary><strong>Without the Tina4 CLI (Docker / CI only)</strong></summary>
+
+The framework normally refuses to start without the `tina4` Rust CLI (it owns file watching and SCSS compilation). To bypass — e.g. inside a Docker image where you've already built the assets — set `TINA4_OVERRIDE_CLIENT=true` in `.env`:
 
 ```bash
 # 1. Create project
@@ -53,24 +55,25 @@ uv init && uv add tina4-python
 # 2. Create entry point
 echo 'from tina4_python.core import run; run()' > app.py
 
-# 3. Create .env
+# 3. Create .env (note the override)
 echo 'TINA4_DEBUG=true' > .env
 echo 'TINA4_LOG_LEVEL=ALL' >> .env
+echo 'TINA4_OVERRIDE_CLIENT=true' >> .env
 
 # 4. Create route directory
 mkdir -p src/routes
 
-# 5. Run
+# 5. Run (no file watching, no hot reload in this mode)
 uv run python app.py
 ```
 
-Open http://localhost:7145
+Open http://localhost:7146
 
 </details>
 
 ---
 
-## What's Built In (54 Features)
+## What's Built In (55 Features)
 
 Every feature is built from scratch -- no pip install, no node_modules, no third-party runtime dependencies in core.
 
@@ -87,7 +90,7 @@ Every feature is built from scratch -- no pip install, no node_modules, no third
 | **Developer Tools** (7) | Dev dashboard (11 tabs), dev toolbar, error overlay (Catppuccin Mocha), dev mailbox, hot reload + CSS hot-reload, code metrics (complexity, coupling, maintainability), AI context installer (7 tools) |
 | **Utilities** (7) | DI container (transient + singleton), HtmlElement builder, inline testing (`@tests` decorator), i18n (6 languages), Swagger/OpenAPI auto-generation, CLI scaffolding (`generate model/route/migration/middleware`), structured logging |
 
-**2,066 tests. Zero dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
+**2,281 tests. Zero dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
 
 For full documentation visit **[tina4.com](https://tina4.com)**.
 
@@ -166,7 +169,7 @@ async def hello_name(request, response):
     return response({"message": f"Hello, {name}!"})
 ```
 
-Visit `http://localhost:7145/api/hello` -- routes are auto-discovered, no imports needed.
+Visit `http://localhost:7146/api/hello` -- routes are auto-discovered, no imports needed.
 
 ### 3. Add a database
 
@@ -570,10 +573,10 @@ cache.tag("users").flush()
 
 Set `TINA4_DEBUG=true` in `.env` to enable:
 
-- **Live reload** -- browser auto-refreshes on code changes
-- **CSS hot-reload** -- SCSS changes apply without page refresh
+- **Live reload** -- the `tina4` Rust CLI watches `src/`, `migrations/`, `.env` and POSTs `/__dev/api/reload` to the running server; the framework broadcasts to the browser via WebSocket (`/__dev_reload`) with a polling fallback (`GET /__dev/api/mtime`)
+- **CSS hot-reload** -- SCSS changes apply without a full page refresh
 - **Error overlay** -- rich error display in the browser
-- **Dev admin** at `/__dev/` with 11 tabs: Routes, Queue, Mailbox, Messages, Database, Requests, Errors, WebSocket, System, Tools, Tina4
+- **Dev admin** at `/__dev/` with tabs: Routes, Queue, Mailbox, Messages, Database, Requests, Errors, WebSocket, System, Tools, Tina4
 
 ---
 
@@ -581,7 +584,7 @@ Set `TINA4_DEBUG=true` in `.env` to enable:
 
 ```bash
 tina4python init [dir]             # Scaffold a new project
-tina4python serve [port]           # Start dev server (default: 7145)
+tina4python serve [--port P] [--no-browser] [--no-reload]  # Dev server (default: 0.0.0.0:7146)
 tina4python serve --production     # Auto-install and use best production server (uvicorn)
 tina4python migrate                # Run pending migrations
 tina4python migrate:create <desc>  # Create a migration file
@@ -683,13 +686,13 @@ Benchmarked with `wrk` — 5,000 requests, 50 concurrent, median of 3 runs:
 
 | Framework | JSON req/s | Deps | Features |
 |-----------|-----------|------|----------|
-| **Tina4 Python** | **6,508** | 0 | 54 |
+| **Tina4 Python** | **6,508** | 0 | 55 |
 | FastAPI | 12,652 | 12+ | ~8 |
 | Flask | 4,928 | 6+ | ~7 |
 | Bottle | 4,355 | 0 | ~5 |
 | Django | 4,050 | 20+ | ~22 |
 
-Tina4 Python delivers competitive throughput with **zero dependencies and 54 features** — frameworks with higher req/s have a fraction of the functionality and require dozens of third-party packages.
+Tina4 Python delivers competitive throughput with **zero dependencies and 55 features** — frameworks with higher req/s have a fraction of the functionality and require dozens of third-party packages.
 
 **Across all 4 Tina4 implementations:**
 
@@ -697,7 +700,7 @@ Tina4 Python delivers competitive throughput with **zero dependencies and 54 fea
 |---|--------|-----|------|---------|
 | **JSON req/s** | 6,508 | 29,293 | 10,243 | 84,771 |
 | **Dependencies** | 0 | 0 | 0 | 0 |
-| **Features** | 54 | 54 | 54 | 54 |
+| **Features** | 55 | 55 | 55 | 55 |
 
 Run benchmarks locally: `python benchmarks/benchmark.py --python`
 
@@ -705,15 +708,15 @@ Run benchmarks locally: `python benchmarks/benchmark.py --python`
 
 ## Cross-Framework Parity
 
-Tina4 ships identical features across four languages — same architecture, same conventions, same 54 features:
+Tina4 ships identical features across four languages — same architecture, same conventions, same 55 features:
 
 | | Python | PHP | Ruby | Node.js |
 |---|--------|-----|------|---------|
 | **Package** | `tina4-python` | `tina4stack/tina4php` | `tina4ruby` | `tina4-nodejs` |
-| **Tests** | 2,066 | 1,427 | 1,793 | 1,950 |
-| **Default port** | 7145 | 7146 | 7147 | 7148 |
+| **Tests (v3.11.12)** | 2,281 | 2,073 | 2,508 | 2,897 |
+| **Default port** | 7146 | 7145 | 7147 | 7148 |
 
-**7,236 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
+**~9,700 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
 
 ---
 

{tina4_python-3.11.12 → tina4_python-3.11.13}/tina4_python/CLAUDE.md

@@ -632,12 +632,13 @@ Frond.add_test("positive", lambda x: x > 0)
 
 ### The @template() decorator
 
-Auto-renders a dict return value through a template:
+Auto-renders a dict return value through a template. **Stack `@template` BELOW the route decorator** — route decorators capture the current function when applied, so `@template` above `@get` is never reached by the router:
+
 ```python
 from tina4_python.core.router import get, template
 
-@template("pages/dashboard.twig")
 @get("/dashboard")
+@template("pages/dashboard.twig")
 async def dashboard(request, response):
     return {"title": "Dashboard", "stats": get_stats()}
 ```
@@ -1779,8 +1780,8 @@ for job in queue.consume("emails"):
 # src/routes/dashboard.py
 from tina4_python.core.router import get, template
 
-@template("pages/dashboard.twig")
 @get("/dashboard")
+@template("pages/dashboard.twig")
 async def dashboard(request, response):
     stats = db.fetch("SELECT count(*) as total FROM orders").to_array()
     return {"title": "Dashboard", "stats": stats}

{tina4_python-3.11.12 → tina4_python-3.11.13}/tina4_python/__init__.py

@@ -8,7 +8,7 @@ Tina4 Python v3.0 — Zero-dependency, lightweight web framework.
 
 One import, everything works.
 """
-__version__ = "3.11.12"
+__version__ = "3.11.13"
 
 # ── Route decorators ──
 from tina4_python.core.router import (  # noqa: E402, F401

{tina4_python-3.11.12 → tina4_python-3.11.13}/tina4_python/ai/__init__.py

@@ -20,6 +20,7 @@ AI_TOOLS = [
     {"name": "aider", "description": "Aider", "context_file": "CONVENTIONS.md", "config_dir": None},
     {"name": "cline", "description": "Cline", "context_file": ".clinerules", "config_dir": None},
     {"name": "codex", "description": "OpenAI Codex", "context_file": "AGENTS.md", "config_dir": None},
+    {"name": "antigravity", "description": "Google Antigravity", "context_file": ".antigravity/context.md", "config_dir": ".antigravity"},
 ]
 
 
@@ -40,10 +41,11 @@ def show_menu(root: str = ".") -> str:
         marker = f"  {green}[installed]{reset}" if installed else ""
         print(f"  {i}. {tool['description']:<20s} {tool['context_file']}{marker}")
 
-    # tina4-ai tools option
+    # tina4-ai tools option — rendered AFTER the tool list, always the last number
+    tina4_ai_num = len(AI_TOOLS) + 1
     tina4_ai_installed = shutil.which("mdview") is not None
     marker = f"  {green}[installed]{reset}" if tina4_ai_installed else ""
-    print(f"  8. Install tina4-ai tools  (requires Python){marker}")
+    print(f"  {tina4_ai_num}. Install tina4-ai tools  (requires Python){marker}")
     print()
     return input("  Select (comma-separated, or 'all'): ").strip()
 
@@ -56,6 +58,7 @@ def install_selected(root: str, selection: str) -> list[str]:
     """
     root_path = Path(root).resolve()
     created = []
+    tina4_ai_num = len(AI_TOOLS) + 1  # keep menu numbering aligned with show_menu
 
     if selection.lower() == "all":
         indices = list(range(len(AI_TOOLS)))
@@ -67,7 +70,7 @@ def install_selected(root: str, selection: str) -> list[str]:
         for p in parts:
             try:
                 n = int(p)
-                if n == 8:
+                if n == tina4_ai_num:
                     install_tina4_ai = True
                 elif 1 <= n <= len(AI_TOOLS):
                     indices.append(n - 1)

{tina4_python-3.11.12 → tina4_python-3.11.13}/tina4_python/core/router.py

@@ -342,19 +342,49 @@ class Router:
         _ws_routes.clear()
 
 
+# Supported typed-parameter constraints. Keys are the type name written in
+# the route pattern (e.g. ``{id:int}``); values are the regex that the param
+# must match. Mirrored verbatim in PHP/Ruby/Node.js for cross-framework parity.
+#
+# Any type name that isn't in this table raises at route registration time —
+# we never silently fall through to the default matcher, because a typo like
+# ``{id:inetger}`` would otherwise match anything and create a security
+# footgun (see tina4-book#125).
+_TYPE_PATTERNS = {
+    "string":   "[^/]+",                                         # default, any non-slash segment
+    "int":      r"\d+",
+    "integer":  r"\d+",
+    "float":    r"[\d.]+",
+    "number":   r"[\d.]+",
+    "alpha":    "[A-Za-z]+",                                     # letters only
+    "alnum":    "[A-Za-z0-9]+",                                  # letters + digits
+    "slug":     "[a-z0-9-]+",                                    # URL slug
+    "uuid":     "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}",
+    "path":     ".+",                                            # greedy — matches remaining path
+    ".*":       ".+",
+}
+
+
 def _compile_pattern(path: str) -> tuple[re.Pattern, list[str]]:
     """Convert a route path to a regex pattern.
 
     Supports:
-        /api/users          → exact match
-        /api/users/{id}     → named parameter (any non-slash chars)
-        /api/files/{path:path}  → greedy (matches remaining path)
+        /api/users                → exact match
+        /api/users/{id}           → named parameter (any non-slash chars)
+        /api/users/{id:int}       → digits only
+        /api/users/{name:alpha}   → letters only
+        /api/users/{slug:slug}    → URL slug (a-z 0-9 -)
+        /api/users/{id:uuid}      → UUID v4 format
+        /api/files/{p:path}       → greedy (matches remaining path)
+        /api/docs/*               → bare-wildcard catch-all (key "*")
+
+    Unknown type names raise ``ValueError`` at route registration time.
     """
     param_names = []
     regex_parts = []
 
     segments = path.strip("/").split("/")
-    for i, segment in enumerate(segments):
+    for segment in segments:
         if segment == "*":
             # Wildcard: matches the rest of the path (greedy)
             param_names.append("*")
@@ -364,14 +394,12 @@ def _compile_pattern(path: str) -> tuple[re.Pattern, list[str]]:
             inner = segment[1:-1]
             if ":" in inner:
                 name, type_hint = inner.split(":", 1)
-                if type_hint == "path":
-                    regex_parts.append("(.+)")
-                elif type_hint == "int":
-                    regex_parts.append("(\\d+)")
-                elif type_hint == "float":
-                    regex_parts.append("([\\d.]+)")
-                else:
-                    regex_parts.append("([^/]+)")
+                if type_hint not in _TYPE_PATTERNS:
+                    raise ValueError(
+                        f"Unknown param type {type_hint!r} in route {path!r}. "
+                        f"Valid types: {', '.join(sorted(k for k in _TYPE_PATTERNS if k != '.*'))}."
+                    )
+                regex_parts.append("(" + _TYPE_PATTERNS[type_hint] + ")")
             else:
                 name = inner
                 regex_parts.append("([^/]+)")
@@ -518,9 +546,13 @@ def cached(max_age: int = 60):
 def template(template_name: str):
     """Auto-render a dict return value through a Frond/Twig template.
 
-    Usage:
-        @template("pages/dashboard.twig")
+    IMPORTANT: ``@template`` must sit BELOW the route decorator so the
+    wrapper is registered (route decorators capture the current function
+    reference when applied — a @template above @get never reaches the
+    router). Correct order:
+
         @get("/dashboard")
+        @template("pages/dashboard.twig")
         async def dashboard(request, response):
             return {"title": "Dashboard", "items": get_items()}
 

{tina4_python-3.11.12 → tina4_python-3.11.13}/tina4_python/core/server.py

@@ -253,7 +253,7 @@ def _is_gallery_deployed(name: str) -> bool:
 def _gallery_btn(name: str, try_url: str) -> str:
     """Render a Try It or View button depending on deployment state."""
     if _is_gallery_deployed(name):
-        return f'<button class="try-btn" style="background:#22c55e;" onclick="window.location.href=\'{try_url}\'" data-deployed="1">View &#8599;</button>'
+        return f'<button class="try-btn" style="background:#22c55e;" onclick="window.open(\'{try_url}\',\'_blank\')" data-deployed="1">View &#8599;</button>'
     return f'<button class="try-btn" onclick="deployGallery(\'{name}\',\'{try_url}\')">Try It</button>'
 
 
@@ -437,18 +437,20 @@ function deployGallery(name, tryUrl) {{
             btn.style.background = '#22c55e';
             btn.disabled = false;
             btn.dataset.deployed = '1';
-            // Wait for the newly deployed route to become reachable before navigating
+            // Wait for the newly deployed route to become reachable, then
+            // open it in a new tab so the dev-admin / gallery home stays
+            // open (fixes tina4-book#115).
             var attempts = 0;
             var maxAttempts = 5;
             function pollRoute() {{
                 fetch(tryUrl, {{method: 'HEAD'}}).then(function() {{
-                    window.location.href = tryUrl;
+                    window.open(tryUrl, '_blank');
                 }}).catch(function() {{
                     attempts++;
                     if (attempts < maxAttempts) {{
                         setTimeout(pollRoute, 500);
                     }} else {{
-                        window.location.href = tryUrl;
+                        window.open(tryUrl, '_blank');
                     }}
                 }});
             }}