vibetuner 2.7.0__py3-none-any.whl → 2.18.1__py3-none-any.whl

vibetuner/templates.py

@@ -3,13 +3,7 @@ from typing import Any, Dict, Optional
 
 from jinja2 import Environment, FileSystemLoader, TemplateNotFound
 
-from .paths import (
-    app_templates,
-    core_templates,
-    email_templates,
-    frontend_templates,
-    markdown_templates,
-)
+from . import paths
 
 
 def _get_base_paths_for_namespace(
@@ -22,19 +16,19 @@ def _get_base_paths_for_namespace(
 
     # Map known namespaces to their predefined paths
     if namespace == "email":
-        return email_templates
+        return paths.email_templates
     if namespace == "markdown":
-        return markdown_templates
+        return paths.markdown_templates
     if namespace == "frontend":
-        return frontend_templates
+        return paths.frontend_templates
 
     # Default for unknown or None namespace
     # Only include app_templates if project root has been set
-    paths = []
-    if app_templates is not None:
-        paths.append(app_templates)
-    paths.append(core_templates)
-    return paths
+    path_list = []
+    if paths.app_templates is not None:
+        path_list.append(paths.app_templates)
+    path_list.append(paths.core_templates)
+    return path_list
 
 
 def _build_search_paths(

vibetuner/versioning.py

@@ -1,7 +1,7 @@
 __version__ = "0.0.0-default"
 
 try:
-    from .._version import version as __version__  # type: ignore
+    from app._version import version as __version__  # type: ignore
 except ImportError:
     pass
 

vibetuner-2.18.1.dist-info/METADATA

@@ -0,0 +1,241 @@
+Metadata-Version: 2.3
+Name: vibetuner
+Version: 2.18.1
+Summary: Core Python framework and blessed dependencies for production-ready FastAPI + MongoDB + HTMX projects
+Keywords: fastapi,mongodb,htmx,web-framework,scaffolding,oauth,background-jobs
+Author: All Tuner Labs, S.L.
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Framework :: FastAPI
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Dist: aioboto3>=15.5.0
+Requires-Dist: arel>=0.4.0
+Requires-Dist: asyncer>=0.0.10
+Requires-Dist: authlib>=1.6.5
+Requires-Dist: beanie[zstd]>=2.0.0
+Requires-Dist: click>=8.3.0
+Requires-Dist: copier>=9.10.3,<9.10.4
+Requires-Dist: email-validator>=2.3.0
+Requires-Dist: fastapi[standard-no-fastapi-cloud-cli]>=0.121.1
+Requires-Dist: granian[pname]>=2.5.7
+Requires-Dist: httpx[http2]>=0.28.1
+Requires-Dist: itsdangerous>=2.2.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic[email]>=2.12.4
+Requires-Dist: pydantic-extra-types[pycountry]>=2.10.6
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: redis[hiredis]>=7.0.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: sse-starlette>=3.0.3
+Requires-Dist: starlette-babel>=1.0.3
+Requires-Dist: starlette-htmx>=0.1.1
+Requires-Dist: streaq[web]<6.0.0
+Requires-Dist: typer-slim[standard]>=0.20.0
+Requires-Dist: babel>=2.17.0 ; extra == 'dev'
+Requires-Dist: cloudflare>=4.3.1 ; extra == 'dev'
+Requires-Dist: djlint>=1.36.4 ; extra == 'dev'
+Requires-Dist: dunamai>=1.25.0 ; extra == 'dev'
+Requires-Dist: gh-bin>=2.83.0 ; extra == 'dev'
+Requires-Dist: granian[pname,reload]>=2.5.7 ; extra == 'dev'
+Requires-Dist: just-bin>=1.43.0 ; extra == 'dev'
+Requires-Dist: pre-commit>=4.4.0 ; extra == 'dev'
+Requires-Dist: pysemver>=0.5.0 ; extra == 'dev'
+Requires-Dist: ruff>=0.14.4 ; extra == 'dev'
+Requires-Dist: rumdl>=0.0.174 ; extra == 'dev'
+Requires-Dist: semver>=3.0.4 ; extra == 'dev'
+Requires-Dist: taplo>=0.9.3 ; extra == 'dev'
+Requires-Dist: ty>=0.0.1a26 ; extra == 'dev'
+Requires-Dist: types-aioboto3[s3,ses]>=15.5.0 ; extra == 'dev'
+Requires-Dist: types-authlib>=1.6.5.20251005 ; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0.12.20250915 ; extra == 'dev'
+Requires-Dist: uv-bump>=0.3.1 ; extra == 'dev'
+Requires-Python: >=3.11
+Project-URL: Changelog, https://github.com/alltuner/vibetuner/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://vibetuner.alltuner.com/
+Project-URL: Homepage, https://vibetuner.alltuner.com/
+Project-URL: Issues, https://github.com/alltuner/vibetuner/issues
+Project-URL: Repository, https://github.com/alltuner/vibetuner
+Provides-Extra: dev
+Description-Content-Type: text/markdown
+
+# vibetuner
+
+Core Python framework and blessed dependencies for Vibetuner projects
+
+This package provides the complete Python framework and curated dependency set for building modern
+web applications with Vibetuner. It includes everything from FastAPI and MongoDB integration to
+authentication, background jobs, and CLI tools.
+
+## What is Vibetuner?
+
+Vibetuner is a production-ready scaffolding tool for FastAPI + MongoDB + HTMX web applications.
+This package (`vibetuner`) is the Python component that provides:
+
+- Complete web application framework built on FastAPI
+- MongoDB integration with Beanie ODM
+- OAuth and magic link authentication out of the box
+- Background job processing with Redis + Streaq
+- CLI framework with Typer
+- Email services, blob storage, and more
+
+**This package is designed to be used within projects generated by the Vibetuner scaffolding
+tool.** For standalone use, you'll need to set up the project structure manually.
+
+## Installation
+
+```bash
+# In a Vibetuner-generated project (automatic)
+uv sync
+
+# Add to an existing project
+uv add vibetuner
+
+# With development dependencies
+uv add vibetuner[dev]
+```
+
+## Quick Start
+
+The recommended way to use Vibetuner is via the scaffolding tool:
+
+```bash
+# Create a new project with all the framework code
+uvx vibetuner scaffold new my-project
+cd my-project
+just dev
+```
+
+This will generate a complete project with:
+
+- Pre-configured FastAPI application
+- Authentication system (OAuth + magic links)
+- MongoDB models and configuration
+- Frontend templates and asset pipeline
+- Docker setup for development and production
+- CLI commands and background job infrastructure
+
+## What's Included
+
+### Core Framework (`src/vibetuner/`)
+
+- **`frontend/`**: FastAPI app, routes, middleware, auth
+- **`models/`**: User, OAuth, email verification, blob storage models
+- **`services/`**: Email (SES), blob storage (S3)
+- **`tasks/`**: Background job infrastructure
+- **`cli/`**: CLI framework with scaffold, run commands
+- **`config.py`**: Pydantic settings management
+- **`mongo.py`**: MongoDB/Beanie setup
+- **`logging.py`**: Structured logging configuration
+
+### Blessed Dependencies
+
+- **FastAPI** (0.121+): Modern, fast web framework
+- **Beanie**: Async MongoDB ODM with Pydantic
+- **Authlib**: OAuth 1.0/2.0 client
+- **Granian**: High-performance ASGI server
+- **Redis** + **Streaq**: Background task processing
+- **Typer**: CLI framework
+- **Rich**: Beautiful terminal output
+- **Loguru**: Structured logging
+- **Pydantic**: Data validation and settings
+
+See [pyproject.toml](./pyproject.toml) for the complete dependency list.
+
+## CLI Tools
+
+When installed, provides the `vibetuner` command:
+
+```bash
+# Create new project from template
+vibetuner scaffold new my-project
+vibetuner scaffold new my-project --defaults
+
+# Update existing project
+vibetuner scaffold update
+
+# Run development server (in generated projects)
+vibetuner run dev frontend
+vibetuner run dev worker
+
+# Run production server (in generated projects)
+vibetuner run prod frontend
+vibetuner run prod worker
+```
+
+## Development Dependencies
+
+The `[dev]` extra includes all tools needed for development:
+
+- **Ruff**: Fast linting and formatting
+- **Babel**: i18n message extraction
+- **pre-commit**: Git hooks
+- **Type stubs**: For aioboto3, authlib, PyYAML
+- And more...
+
+## Usage in Generated Projects
+
+In a Vibetuner-generated project, import from `vibetuner`:
+
+```python
+# Use core models
+from vibetuner.models import UserModel, OAuthAccountModel
+
+# Use services
+from vibetuner.services.email import send_email
+
+# Use configuration
+from vibetuner.config import settings
+
+# Extend core routes
+from vibetuner.frontend import app
+
+# Add your routes
+@app.get("/api/hello")
+async def hello():
+    return {"message": "Hello World"}
+```
+
+## Documentation
+
+For complete documentation, guides, and examples, see the main Vibetuner repository:
+
+**📖 [Vibetuner Documentation](https://vibetuner.alltuner.com/)**
+
+## Package Ecosystem
+
+Vibetuner consists of three packages that work together:
+
+1. **vibetuner** (this package): Python framework and dependencies
+2. **[@alltuner/vibetuner](https://www.npmjs.com/package/@alltuner/vibetuner)**: JavaScript/CSS build dependencies
+3. **Scaffolding template**: Copier template for project generation
+
+All three are version-locked and tested together to ensure compatibility.
+
+## Contributing
+
+Contributions welcome! See the main repository for contribution guidelines:
+
+**🤝 [Contributing to Vibetuner](https://github.com/alltuner/vibetuner/blob/main/CONTRIBUTING.md)**
+
+## License
+
+MIT License - Copyright (c) 2025 All Tuner Labs, S.L.
+
+See [LICENSE](https://github.com/alltuner/vibetuner/blob/main/LICENSE) for details.
+
+## Links
+
+- **Main Repository**: <https://github.com/alltuner/vibetuner>
+- **Documentation**: <https://vibetuner.alltuner.com/>
+- **Issues**: <https://github.com/alltuner/vibetuner/issues>
+- **PyPI**: <https://pypi.org/project/vibetuner/>
+- **npm Package**: <https://www.npmjs.com/package/@alltuner/vibetuner>

vibetuner-2.18.1.dist-info/RECORD

@@ -0,0 +1,72 @@
+vibetuner/__init__.py,sha256=rFIVCmxkKTT_g477V8biCw0lgpudyuUabXhYxg189lY,90
+vibetuner/__main__.py,sha256=Ye9oBAgXhcYQ4I4yZli3TIXF5lWQ9yY4tTPs4XnDDUY,29
+vibetuner/cli/__init__.py,sha256=IY2wJ_ErX2PimyYSe5SL_zGrENSWLgW-cXgMRXNC7pE,1992
+vibetuner/cli/run.py,sha256=mHvZypizNfVwdLo7k8SvBO7HPUF4Vka9hjJlECZCGfA,5009
+vibetuner/cli/scaffold.py,sha256=qADWxx1gYECQ8N6dgvJmlucT6mZ29rxWu3VZhbWmhC0,5710
+vibetuner/config.py,sha256=Z-o7jP1dLvPR0yVzW9wPvRgQezbl6Be40EpuG9i9Eos,4157
+vibetuner/context.py,sha256=h4f4FfkmLlOD6WiSLhx7-IjFvIA4zcrsAp6478l6npg,743
+vibetuner/frontend/__init__.py,sha256=QpQY9kUWvKzMtMCh9Lcoyz1dNdYfW1d_Ue4WUnzz_No,3017
+vibetuner/frontend/context.py,sha256=yd9mJ8Cj9AUeHE533dofEoyCkw6oSPowdq397whfN_s,169
+vibetuner/frontend/deps.py,sha256=b3ocC_ryaK2Jp51SfcFqckrXiaL7V-chkFRqLjzgA_c,1296
+vibetuner/frontend/email.py,sha256=k0d7FCZCge5VYOKp3fLsbx7EA5_SrtBkpMs57o4W7u0,1119
+vibetuner/frontend/hotreload.py,sha256=Gl7FIKJaiCVVoyWQqdErBUOKDP1cGBFUpGzqHMiJd10,285
+vibetuner/frontend/lifespan.py,sha256=iKrRcEaPn5Q2B4ZZhMKzXE-hBM8OxjwMn6A5Q1FUbWY,679
+vibetuner/frontend/middleware.py,sha256=aVsEeXGuBqcBB_IlmtBW_3icuvVix7P3A63AkyeX_38,4957
+vibetuner/frontend/oauth.py,sha256=EzEwoOZ_8xn_CiqAWpNoEdhV2NPxZKKwF2bA6W6Bkj0,5884
+vibetuner/frontend/routes/__init__.py,sha256=nHhiylHIUPZ2R-Bd7vXEGHLJBQ7fNuzPTJodjJR3lyc,428
+vibetuner/frontend/routes/auth.py,sha256=vKE-Dm2yPXReaOLvcxfT4a6df1dKUoteZ4p46v8Elm4,4331
+vibetuner/frontend/routes/debug.py,sha256=Mzbyx3gv_mCxg0sdjY4p7LXgH1wI3BoEyn1sRZuGY90,12743
+vibetuner/frontend/routes/health.py,sha256=_XkMpdMNUemu7qzkGkqn5TBnZmGrArA3Xps5CWCcGlg,959
+vibetuner/frontend/routes/language.py,sha256=wHNfdewqWfK-2JLXwglu0Q0b_e00HFGd0A2-PYT44LE,1240
+vibetuner/frontend/routes/meta.py,sha256=pSyIxQsiB0QZSYwCQbS07KhkT5oHC5r9jvjUDIqZRGw,1409
+vibetuner/frontend/routes/user.py,sha256=b8ow6IGnfsHosSwSmEIYZtuQJnW_tacnNjp_aMnqWxU,2666
+vibetuner/frontend/templates.py,sha256=1k2jCGBdMx9U9RDcHmuO6fiNEXrRYZ0Mzk51H9XAlrM,5322
+vibetuner/logging.py,sha256=9eNofqVtKZCBDS33NbBI7Sv2875gM8MNStTSCjX2AXQ,2409
+vibetuner/models/__init__.py,sha256=JvmQvzDIxaI7zlk-ROCWEbuzxXSUOqCshINUjgu-AfQ,325
+vibetuner/models/blob.py,sha256=F30HFS4Z_Bji_PGPflWIv4dOwqKLsEWQHcjW1Oz_79M,2523
+vibetuner/models/email_verification.py,sha256=iwDnbPhceugY6vQZwyp0AKCEID61NbAxqA7tdQKHHAI,2488
+vibetuner/models/mixins.py,sha256=934aAcdos_SlDMyiARBV8dhhClgtaVpf0O7OJf4d6YQ,3053
+vibetuner/models/oauth.py,sha256=BdOZbW47Das9ntHTtRmVdl1lB5zLCcXW2fyVJ-tQ_F8,1509
+vibetuner/models/registry.py,sha256=O5YG7vOrWluqpH5N7m44v72wbscMhU_Pu3TJw_u0MTk,311
+vibetuner/models/types.py,sha256=Lj3ASEvx5eNgQMcVhNyKQHHolJqDxj2yH8S-M9oa4J8,402
+vibetuner/models/user.py,sha256=ttcSH4mVREPhA6bCFUWXKfJ9_8_Iq3lEYXe3rDrslw4,2696
+vibetuner/mongo.py,sha256=F8AzD33LWQ6jq7kFUqQPSPDSr7KPlbOy8THsvXHFKdg,504
+vibetuner/paths.py,sha256=WFHuaanFOBI7v7xOHjyLvNMYKwX0KqOyi63x62wLE-M,7470
+vibetuner/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vibetuner/services/blob.py,sha256=-lEGIWe30yR2IuTfy5bB9Sg_PX0HoYC_WMTQ3VN28gU,5660
+vibetuner/services/email.py,sha256=IavJZS5MI40LlF_cjBpPPRx_S2r1JD4GcFg3-dWkzPA,1626
+vibetuner/tasks/__init__.py,sha256=uETtKOA5rJ48NBx-LN4niRJDzkb6--NHAPW3jReHABI,71
+vibetuner/tasks/context.py,sha256=FOFUDWGNo1h8G8qlE-1Gbkh-Kd1z3WZTqSMHkvZ68v8,869
+vibetuner/tasks/worker.py,sha256=-PKQ2kqvMe8X5ninULh3Vrp3M-gwh-ht2kmitvkHTVg,429
+vibetuner/templates/email/magic_link.html.jinja,sha256=DzaCnBsYoau2JQh5enPAa2FMFFTyCwdyiM3vGhBQdtA,553
+vibetuner/templates/email/magic_link.txt.jinja,sha256=dANak9ion1cpILt45V3GcI2qnL_gKFPj7PsZKYV0m5s,200
+vibetuner/templates/frontend/base/favicons.html.jinja,sha256=A7s7YXuE82tRd7ZLJs1jGEGwBRiMPrqlWd507xL1iZg,70
+vibetuner/templates/frontend/base/footer.html.jinja,sha256=P5EKssUk-HHz0yFE3auj1WtSqsJxAzi39XbRxjBtLLg,165
+vibetuner/templates/frontend/base/header.html.jinja,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vibetuner/templates/frontend/base/opengraph.html.jinja,sha256=wjmLAE3C4OZqxPhPCce1kD3XDN-BZgp3v0GwlToUoBc,419
+vibetuner/templates/frontend/base/skeleton.html.jinja,sha256=uOEUt577Mfv83nLOKLPKvBJHh8PG6w7YwDYv1GVwnaQ,1698
+vibetuner/templates/frontend/debug/collections.html.jinja,sha256=LogTicEMSzy-sYrHQ8Kjqf_6Il9Cv5cRElMgivcJC2U,7094
+vibetuner/templates/frontend/debug/components/debug_nav.html.jinja,sha256=SntW7esMV6TDkIHcoevZX7j-fCv3h6pblOJ--_-5fUI,2963
+vibetuner/templates/frontend/debug/index.html.jinja,sha256=qheuA53UYGBBeVvsNL8APJ2Y7FxjL3g8LWafY2U1MSA,4892
+vibetuner/templates/frontend/debug/info.html.jinja,sha256=Z9yZxW-dyOZ1kWsY1_ZX7jvPQ4IaM9hJMVD6Sk8QxgA,14968
+vibetuner/templates/frontend/debug/users.html.jinja,sha256=BjTiJbOMadZYZJYvtYW0KeFcYN7ooI7_YylhOnfbLD4,7809
+vibetuner/templates/frontend/debug/version.html.jinja,sha256=pJ-QuDRuvB7X04nC43upZiXLaFCC6vmI5QhRS62rt6k,2901
+vibetuner/templates/frontend/email/magic_link.txt.jinja,sha256=fTVl3Wjfvp3EJAB5DYt01EL_O7o9r8lHedDH05YP44c,192
+vibetuner/templates/frontend/email_sent.html.jinja,sha256=Pq3J_WOwY_zFe9QJkvO29o6pw06JEnYxh068kyl_ZEg,5236
+vibetuner/templates/frontend/index.html.jinja,sha256=m8_xNS1O7JlrfWOHy0y7prf64HyVokQEeKvFqRWjxrQ,925
+vibetuner/templates/frontend/lang/select.html.jinja,sha256=4jHo8QWvMOIeK_KqHzSaDzgvuT3v8MlmjTrrYIl2sjk,224
+vibetuner/templates/frontend/login.html.jinja,sha256=Y_dKk47-H6M8StepiFXntJcorBNXiOXKjORJN--SjOA,5548
+vibetuner/templates/frontend/meta/browserconfig.xml.jinja,sha256=5DE-Dowxw3fRg4UJerW6tVrUYdHWUsUOfS_YucoRVXQ,300
+vibetuner/templates/frontend/meta/robots.txt.jinja,sha256=SUBJqQCOW5FFdD4uIkReo04NcAYnjITLyB4Wk1wBcS4,46
+vibetuner/templates/frontend/meta/site.webmanifest.jinja,sha256=QCg2Z2GXd2AwJ3C8CnW9Brvu3cbXcZiquLNEzA8FsOc,150
+vibetuner/templates/frontend/meta/sitemap.xml.jinja,sha256=IhBjk7p5OdqszyK6DR3eUAdeAucKk2s_PpnOfYxgNCo,170
+vibetuner/templates/frontend/user/edit.html.jinja,sha256=dhmLFsokTWbtnmIE10S8gC6rDHToC6vNIUB2BRximKQ,5443
+vibetuner/templates/frontend/user/profile.html.jinja,sha256=qXFonyeCy99JE5o3rEtaOHtnxgg2-AlNykwIZyxpk_M,9964
+vibetuner/templates/markdown/.placeholder,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vibetuner/templates.py,sha256=xRoMb_oyAI5x4kxfpg56UcLKkT8e9HVn-o3KFAu9ISE,5094
+vibetuner/time.py,sha256=3_DtveCCzI20ocTnAlTh2u7FByUXtINaUoQZO-_uZow,1188
+vibetuner/versioning.py,sha256=UAHGoNsv3QEPAJgHyt_Q8I26SW7ng2FnZlX2-0M6r6U,156
+vibetuner-2.18.1.dist-info/WHEEL,sha256=DpNsHFUm_gffZe1FgzmqwuqiuPC6Y-uBCzibcJcdupM,78
+vibetuner-2.18.1.dist-info/entry_points.txt,sha256=aKIj9YCCXizjYupx9PeWkUJePg3ncHke_LTS5rmCsfs,49
+vibetuner-2.18.1.dist-info/METADATA,sha256=c_aNrSkA_hSWfazWl6Nn-9O38DWtgnofBZanp8892fo,8061
+vibetuner-2.18.1.dist-info/RECORD,,

{vibetuner-2.7.0.dist-info → vibetuner-2.18.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.7
+Generator: uv 0.9.8
 Root-Is-Purelib: true
 Tag: py3-none-any

vibetuner-2.18.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+vibetuner = vibetuner.cli:app
+

vibetuner/frontend/AGENTS.md

@@ -1,113 +0,0 @@
-# Core Frontend Module
-
-**IMMUTABLE SCAFFOLDING CODE** - This is the framework's core frontend infrastructure.
-
-## What's Here
-
-This module contains the scaffolding's core frontend components:
-
-- **routes/** - Essential default routes (auth, health, debug, language, user, meta)
-- **templates.py** - Template rendering with automatic context injection
-- **deps.py** - FastAPI dependencies (authentication, language, etc.)
-- **middleware.py** - Request/response middleware
-- **oauth.py** - OAuth provider integration
-- **email.py** - Magic link email authentication
-- **lifespan.py** - Application startup/shutdown lifecycle
-- **context.py** - Request context management
-- **hotreload.py** - Development hot-reload support
-
-## Important Rules
-
-⚠️  **DO NOT MODIFY** these core frontend components directly.
-
-**For changes to core frontend:**
-
-- File an issue at `https://github.com/alltuner/scaffolding`
-- Core changes benefit all projects using the scaffolding
-
-**For your application routes:**
-
-- Create them in `src/app/frontend/routes/` instead
-- Import core components when needed:
-  - `from vibetuner.frontend.deps import get_current_user`
-  - `from vibetuner.frontend.templates import render_template`
-
-## User Route Pattern (for reference)
-
-Your application routes in `src/app/frontend/routes/` should follow this pattern:
-
-```python
-# src/app/frontend/routes/dashboard.py
-from fastapi import APIRouter, Request, Depends
-from vibetuner.frontend.deps import get_current_user
-from vibetuner.frontend.templates import render_template
-
-router = APIRouter()
-
-@router.get("/dashboard")
-async def dashboard(request: Request, user=Depends(get_current_user)):
-    return render_template("dashboard.html.jinja", request, {"user": user})
-```
-
-## Template Rendering
-
-```python
-# Automatic context in every template:
-{
-    "request": request,
-    "DEBUG": settings.DEBUG,
-    "hotreload": hotreload,  # Dev mode
-    # ... plus your custom context
-}
-```
-
-### Template Filters
-
-- `{{ datetime | timeago }}` - "2 hours ago"
-- `{{ datetime | format_date }}` - "January 15, 2024"
-- `{{ text | markdown }}` - Convert Markdown to HTML
-
-## Core Dependencies Available
-
-Import these from `vibetuner.frontend.deps`:
-
-- `get_current_user` - Require authenticated user (raises 403 if not authenticated)
-- `get_current_user_optional` - Optional auth check (returns None if not authenticated)
-- `LangDep` - Current language from cookie/header
-- `MagicCookieDep` - Magic link cookie for authentication
-
-## HTMX Patterns
-
-```html
-<!-- Partial updates -->
-<button hx-post="/api/action" hx-target="#result">Click</button>
-
-<!-- Form submission -->
-<form hx-post="/submit" hx-swap="outerHTML">...</form>
-
-<!-- Polling -->
-<div hx-get="/status" hx-trigger="every 2s">...</div>
-```
-
-## Default Routes Provided
-
-The following routes are automatically available (DO NOT MODIFY):
-
-- **/auth/*** - OAuth and magic link authentication
-- **/health/ping** - Health check endpoint
-- **/debug/** - Debug info (only in DEBUG mode)
-- **/lang/** - Language selection
-- **/user/** - User profile routes
-- **/meta/** - Metadata endpoints
-
-## Development
-
-**CRITICAL**: Both processes required:
-
-```bash
-# Terminal 1: Frontend assets
-bun dev
-
-# Terminal 2: Backend server
-just local-dev
-```

vibetuner/frontend/CLAUDE.md

@@ -1,113 +0,0 @@
-# Core Frontend Module
-
-**IMMUTABLE SCAFFOLDING CODE** - This is the framework's core frontend infrastructure.
-
-## What's Here
-
-This module contains the scaffolding's core frontend components:
-
-- **routes/** - Essential default routes (auth, health, debug, language, user, meta)
-- **templates.py** - Template rendering with automatic context injection
-- **deps.py** - FastAPI dependencies (authentication, language, etc.)
-- **middleware.py** - Request/response middleware
-- **oauth.py** - OAuth provider integration
-- **email.py** - Magic link email authentication
-- **lifespan.py** - Application startup/shutdown lifecycle
-- **context.py** - Request context management
-- **hotreload.py** - Development hot-reload support
-
-## Important Rules
-
-⚠️  **DO NOT MODIFY** these core frontend components directly.
-
-**For changes to core frontend:**
-
-- File an issue at `https://github.com/alltuner/scaffolding`
-- Core changes benefit all projects using the scaffolding
-
-**For your application routes:**
-
-- Create them in `src/app/frontend/routes/` instead
-- Import core components when needed:
-  - `from vibetuner.frontend.deps import get_current_user`
-  - `from vibetuner.frontend.templates import render_template`
-
-## User Route Pattern (for reference)
-
-Your application routes in `src/app/frontend/routes/` should follow this pattern:
-
-```python
-# src/app/frontend/routes/dashboard.py
-from fastapi import APIRouter, Request, Depends
-from vibetuner.frontend.deps import get_current_user
-from vibetuner.frontend.templates import render_template
-
-router = APIRouter()
-
-@router.get("/dashboard")
-async def dashboard(request: Request, user=Depends(get_current_user)):
-    return render_template("dashboard.html.jinja", request, {"user": user})
-```
-
-## Template Rendering
-
-```python
-# Automatic context in every template:
-{
-    "request": request,
-    "DEBUG": settings.DEBUG,
-    "hotreload": hotreload,  # Dev mode
-    # ... plus your custom context
-}
-```
-
-### Template Filters
-
-- `{{ datetime | timeago }}` - "2 hours ago"
-- `{{ datetime | format_date }}` - "January 15, 2024"
-- `{{ text | markdown }}` - Convert Markdown to HTML
-
-## Core Dependencies Available
-
-Import these from `vibetuner.frontend.deps`:
-
-- `get_current_user` - Require authenticated user (raises 403 if not authenticated)
-- `get_current_user_optional` - Optional auth check (returns None if not authenticated)
-- `LangDep` - Current language from cookie/header
-- `MagicCookieDep` - Magic link cookie for authentication
-
-## HTMX Patterns
-
-```html
-<!-- Partial updates -->
-<button hx-post="/api/action" hx-target="#result">Click</button>
-
-<!-- Form submission -->
-<form hx-post="/submit" hx-swap="outerHTML">...</form>
-
-<!-- Polling -->
-<div hx-get="/status" hx-trigger="every 2s">...</div>
-```
-
-## Default Routes Provided
-
-The following routes are automatically available (DO NOT MODIFY):
-
-- **/auth/*** - OAuth and magic link authentication
-- **/health/ping** - Health check endpoint
-- **/debug/** - Debug info (only in DEBUG mode)
-- **/lang/** - Language selection
-- **/user/** - User profile routes
-- **/meta/** - Metadata endpoints
-
-## Development
-
-**CRITICAL**: Both processes required:
-
-```bash
-# Terminal 1: Frontend assets
-bun dev
-
-# Terminal 2: Backend server
-just local-dev
-```