astris-python 0.1.0__tar.gz → 0.1.1__tar.gz

{astris_python-0.1.0 → astris_python-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astris-python
-Version: 0.1.0
+Version: 0.1.1
 Summary: The modern full-stack web framework for Python. Everything you need to go from idea to orbit; for developers who want to build and ship at escape velocity.
 Author: Felix Gomez
 Author-email: Felix Gomez <felix@felixgomez.com>
@@ -36,16 +36,20 @@ Requires-Dist: alembic>=1.19.1
 Requires-Dist: fastapi>=0.141.1
 Requires-Dist: itsdangerous>=2.2.0
 Requires-Dist: pwdlib[argon2]>=0.3.1
-Requires-Dist: pydantic>=2.13.4
+Requires-Dist: pydantic>=2.13.5
 Requires-Dist: pydantic-settings>=2.15.0
-Requires-Dist: sqlmodel>=0.0.39
-Requires-Dist: typer>=0.27.1
+Requires-Dist: sqlmodel>=0.0.42
+Requires-Dist: typer>=0.27.2
 Requires-Dist: uvicorn[standard]>=0.52.4
 Requires-Python: >=3.11
+Project-URL: Homepage, https://astris.dev
+Project-URL: Documentation, https://astris.dev
+Project-URL: Repository, https://github.com/TheFelixGomez/astris
+Project-URL: Issues, https://github.com/TheFelixGomez/astris/issues
 Description-Content-Type: text/markdown
 
 <p align="center" style="padding: 20px 0 10px 0;">
-  <a href="https://github.com/TheFelixGomez/astris">
+  <a href="https://astris.dev">
     <img src="https://raw.githubusercontent.com/TheFelixGomez/astris/main/.github/assets/astris-logo-name.png" alt="Astris" width="380">
   </a>
 </p>
@@ -56,6 +60,7 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
+  <a href="https://astris.dev"><img src="https://img.shields.io/badge/docs-astris.dev-0ea5e9.svg" alt="Documentation"></a>
   <a href="https://pypi.org/project/astris-python/"><img src="https://img.shields.io/pypi/v/astris-python.svg" alt="PyPI version"></a>
   <a href="https://pypi.org/project/astris-python/"><img src="https://img.shields.io/pypi/pyversions/astris-python.svg" alt="Python Versions"></a>
   <a href="https://github.com/TheFelixGomez/astris/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
@@ -71,6 +76,8 @@ Description-Content-Type: text/markdown
 
 By combining **FastAPI**, **Inertia.js**, **Vue 3**, **Tailwind CSS v4**, and **SQLModel**, Astris lets you build rich, dynamic single-page applications without the overhead of maintaining separate API layers or complex state synchronization.
 
+📖 **Explore the full documentation, guides, and tutorials at [astris.dev](https://astris.dev).**
+
 ---
 
 ## 🌟 Key Features

{astris_python-0.1.0 → astris_python-0.1.1}/README.md

@@ -1,5 +1,5 @@
 <p align="center" style="padding: 20px 0 10px 0;">
-  <a href="https://github.com/TheFelixGomez/astris">
+  <a href="https://astris.dev">
     <img src="https://raw.githubusercontent.com/TheFelixGomez/astris/main/.github/assets/astris-logo-name.png" alt="Astris" width="380">
   </a>
 </p>
@@ -10,6 +10,7 @@
 </p>
 
 <p align="center">
+  <a href="https://astris.dev"><img src="https://img.shields.io/badge/docs-astris.dev-0ea5e9.svg" alt="Documentation"></a>
   <a href="https://pypi.org/project/astris-python/"><img src="https://img.shields.io/pypi/v/astris-python.svg" alt="PyPI version"></a>
   <a href="https://pypi.org/project/astris-python/"><img src="https://img.shields.io/pypi/pyversions/astris-python.svg" alt="Python Versions"></a>
   <a href="https://github.com/TheFelixGomez/astris/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
@@ -25,6 +26,8 @@
 
 By combining **FastAPI**, **Inertia.js**, **Vue 3**, **Tailwind CSS v4**, and **SQLModel**, Astris lets you build rich, dynamic single-page applications without the overhead of maintaining separate API layers or complex state synchronization.
 
+📖 **Explore the full documentation, guides, and tutorials at [astris.dev](https://astris.dev).**
+
 ---
 
 ## 🌟 Key Features

{astris_python-0.1.0 → astris_python-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "astris-python"
-version = "0.1.0"
+version = "0.1.1"
 description = "The modern full-stack web framework for Python. Everything you need to go from idea to orbit; for developers who want to build and ship at escape velocity."
 readme = "README.md"
 license = "MIT"
@@ -39,10 +39,10 @@ dependencies = [
     "fastapi>=0.141.1",
     "itsdangerous>=2.2.0",
     "pwdlib[argon2]>=0.3.1",
-    "pydantic>=2.13.4",
+    "pydantic>=2.13.5",
     "pydantic-settings>=2.15.0",
-    "sqlmodel>=0.0.39",
-    "typer>=0.27.1",
+    "sqlmodel>=0.0.42",
+    "typer>=0.27.2",
     "uvicorn[standard]>=0.52.4",
 ]
 
@@ -50,6 +50,12 @@ dependencies = [
 name = "Felix Gomez"
 email = "felix@felixgomez.com"
 
+[project.urls]
+Homepage = "https://astris.dev"
+Documentation = "https://astris.dev"
+Repository = "https://github.com/TheFelixGomez/astris"
+Issues = "https://github.com/TheFelixGomez/astris/issues"
+
 [project.scripts]
 astris = "astris.installer:installer_cli"
 astris-python = "astris.installer:installer_cli"

{astris_python-0.1.0 → astris_python-0.1.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "astris-python"
-version = "0.1.0"
+version = "0.1.1"
 description = "The modern full-stack web framework for Python. Everything you need to go from idea to orbit; for developers who want to build and ship at escape velocity."
 readme = "README.md"
 authors = [
@@ -42,13 +42,19 @@ dependencies = [
     "fastapi>=0.141.1",
     "itsdangerous>=2.2.0",
     "pwdlib[argon2]>=0.3.1",
-    "pydantic>=2.13.4",
+    "pydantic>=2.13.5",
     "pydantic-settings>=2.15.0",
-    "sqlmodel>=0.0.39",
-    "typer>=0.27.1",
+    "sqlmodel>=0.0.42",
+    "typer>=0.27.2",
     "uvicorn[standard]>=0.52.4",
 ]
 
+[project.urls]
+Homepage = "https://astris.dev"
+Documentation = "https://astris.dev"
+Repository = "https://github.com/TheFelixGomez/astris"
+Issues = "https://github.com/TheFelixGomez/astris/issues"
+
 [project.scripts]
 astris = "astris.installer:installer_cli"
 astris-python = "astris.installer:installer_cli"

astris_python-0.1.1/src/astris/.agents/skills/astris/SKILL.md

@@ -0,0 +1,342 @@
+---
+name: astris
+description: Astris best practices and conventions. Use when working with Astris full-stack Python applications, controllers, Inertia.js Vue 3 views, SQLModel databases, Orbit CLI, and security. Keeps Astris code clean and up to date with the latest features and patterns.
+---
+
+# Astris
+
+Official Astris skill to write code with best practices, keeping up to date with new versions and features.
+
+## Quick Reference
+
+* Application entrypoint: `app = Astris()` in `main.py`; see [Application Kernel](#application-kernel).
+* Configuration: manage via `.env` and `app/core/config.py`; see [Configuration](#configuration-appcoreconfigpy).
+* Controllers: define in `app/modules/<name>/<name>_controller.py` with `Controller`; see [Controllers & Routing](#controllers--routing).
+* Views: return `InertiaResponse(request, "Component/Path", props={...})`; see [Inertia.js Monolith](#inertiajs-monolith-vue-3--tailwind-css-v4).
+* Mutations: return `RedirectResponse(url="/...", status_code=status.HTTP_303_SEE_OTHER)` for POST/PUT/PATCH/DELETE; see [Form Handling & Mutations](#form-handling--mutations).
+* Database sessions: inject `DatabaseSession` into services via `Depends()`; see [Database & Services](#database--services).
+* Models: define in `app/modules/<name>/<name>_model.py` with `SQLModel`; see [SQLModel Models](#sqlmodel-models).
+* Flash messages: use `flash(request, "type", "message")`; see [Flash Messages & Shared Data](#flash-messages--shared-data).
+* Authentication: use `auth_required` / `guest_required` route dependencies and `AuthUser`; see [Authentication & Security](#authentication--security).
+* Orbit CLI: use `uv run orbit <command>`; see [Orbit CLI](#orbit-cli).
+
+## Application Kernel
+
+Instantiate `Astris()` in `main.py`:
+
+```python
+from astris import Astris
+
+app = Astris()
+```
+
+The kernel automatically:
+1. Loads settings from `app/core/config.py` and `.env`.
+2. Registers security middlewares (CORS, PublicStatic, Session, Flash, CSRF).
+3. Auto-discovers and attaches all controllers in `app/modules/`.
+4. Binds the Inertia.js view engine to `resources/views/root.html`.
+
+## Configuration (`app/core/config.py`)
+
+Astris generates `app/core/config.py` extending the base `Settings` class with automatic `.env` type-casting:
+
+```python
+from astris.config import Settings as BaseAppSettings
+
+
+class Settings(BaseAppSettings):
+    """Extend application settings with custom environment variables."""
+
+    stripe_api_key: str | None = None
+    redis_url: str = "redis://localhost:6379"
+
+
+settings = Settings()
+```
+
+Access strongly typed settings anywhere in your app:
+
+```python
+from app.core.config import settings
+
+api_key = settings.stripe_api_key
+db_url = settings.database_url
+```
+
+## Controllers & Routing
+
+Place controllers inside `app/modules/<module>/<module>_controller.py`. Astris automatically discovers any `Controller` in files matching `*_controller.py`. `Controller` is a direct subclass of FastAPI's `APIRouter`.
+
+```python
+from astris.routing import Controller, Depends, Path, Query
+from astris.http import Request
+from astris.inertia import InertiaResponse
+from app.modules.billing.billing_service import BillingService
+
+controller = Controller(prefix="/billing", tags=["Billing"])
+
+
+@controller.get("/")
+async def index(
+    request: Request,
+    billing: BillingService = Depends(),
+) -> InertiaResponse:
+    invoices = billing.get_recent_invoices()
+    return InertiaResponse(
+        request,
+        "Billing/Index",
+        props={"invoices": [inv.model_dump() for inv in invoices]},
+    )
+
+
+@controller.get("/{invoice_id}")
+async def show(
+    request: Request,
+    invoice_id: int,
+    billing: BillingService = Depends(),
+) -> InertiaResponse:
+    invoice = billing.get_invoice(invoice_id)
+    return InertiaResponse(
+        request,
+        "Billing/Show",
+        props={"invoice": invoice.model_dump()},
+    )
+```
+
+## Form Handling & Mutations
+
+Inertia requires that mutating requests (`POST`, `PUT`, `PATCH`, `DELETE`) redirect with a `303 See Other` status code.
+
+```python
+from astris.routing import Controller, Depends
+from astris.http import Request, RedirectResponse, status
+from astris.inertia import flash
+from app.modules.billing.billing_service import BillingService
+from app.modules.billing.billing_model import InvoiceCreate
+
+controller = Controller(prefix="/billing", tags=["Billing"])
+
+
+@controller.post("/")
+async def store(
+    request: Request,
+    dto: InvoiceCreate,
+    billing: BillingService = Depends(),
+) -> RedirectResponse:
+    invoice = billing.create_invoice(dto)
+    flash(request, "success", f"Invoice #{invoice.id} created successfully!")
+    return RedirectResponse(url="/billing", status_code=status.HTTP_303_SEE_OTHER)
+
+
+@controller.delete("/{invoice_id}")
+async def destroy(
+    request: Request,
+    invoice_id: int,
+    billing: BillingService = Depends(),
+) -> RedirectResponse:
+    billing.delete_invoice(invoice_id)
+    flash(request, "success", "Invoice deleted successfully.")
+    return RedirectResponse(url="/billing", status_code=status.HTTP_303_SEE_OTHER)
+```
+
+## Flash Messages & Shared Data
+
+* Flash messages set with `flash(request, "success", "...")` are automatically shared with the frontend in `$page.props.flash`.
+* Global props can be shared per-request using `share(request, "key", value)`.
+
+```python
+from astris.inertia import flash, share
+
+flash(request, "error", "Invalid payment credentials.")
+share(request, "team_name", "Acme Corp")
+```
+
+## Database & Services
+
+### 1. Service Layer with Injected Session
+Accept `session: DatabaseSession` in the constructor:
+
+```python
+from astris.database import DatabaseSession, select
+from app.modules.billing.billing_model import Invoice, InvoiceCreate
+
+
+class BillingService:
+    def __init__(self, session: DatabaseSession):
+        self.session = session
+
+    def get_recent_invoices(self) -> list[Invoice]:
+        return self.session.exec(select(Invoice).order_by(Invoice.id.desc())).all()
+
+    def get_invoice(self, invoice_id: int) -> Invoice:
+        return self.session.get(Invoice, invoice_id)
+
+    def create_invoice(self, dto: InvoiceCreate) -> Invoice:
+        invoice = Invoice.model_validate(dto)
+        self.session.add(invoice)
+        self.session.commit()
+        self.session.refresh(invoice)
+        return invoice
+
+    def delete_invoice(self, invoice_id: int) -> None:
+        invoice = self.get_invoice(invoice_id)
+        if invoice:
+            self.session.delete(invoice)
+            self.session.commit()
+```
+
+### 2. Standalone Scripts & Background Tasks
+Use `with db.session() as session:` only outside HTTP requests (in seeders, CLI scripts, or background workers):
+
+```python
+from astris.database import db, select
+from app.modules.billing.billing_model import Invoice
+
+with db.session() as session:
+    invoices = session.exec(select(Invoice)).all()
+```
+
+## SQLModel Models
+
+Define models in `app/modules/<module>/<module>_model.py`. Astris auto-imports models to register table metadata with Alembic:
+
+```python
+from astris.database import Field, SQLModel
+
+
+class InvoiceBase(SQLModel):
+    customer_name: str = Field(index=True)
+    amount: float
+    status: str = Field(default="pending")
+
+
+class Invoice(InvoiceBase, table=True):
+    id: int | None = Field(default=None, primary_key=True)
+
+
+class InvoiceCreate(InvoiceBase):
+    pass
+
+
+class InvoicePublic(InvoiceBase):
+    id: int
+```
+
+## Inertia.js Monolith (Vue 3 + Tailwind CSS v4)
+
+Place page components in `resources/js/Pages/<Module>/<Page>.vue`. Always use `<script setup lang="ts">`:
+
+```vue
+<script setup lang="ts">
+import { useForm, Head, Link, usePage } from '@inertiajs/vue3'
+
+interface Invoice {
+  id: number
+  customer_name: string
+  amount: number
+  status: string
+}
+
+defineProps<{
+  invoices: Invoice[]
+}>()
+
+const page = usePage()
+
+const form = useForm({
+  customer_name: '',
+  amount: 0,
+})
+
+const submit = () => {
+  form.post('/billing', {
+    onSuccess: () => form.reset(),
+  })
+}
+</script>
+
+<template>
+  <Head title="Billing" />
+  <div class="max-w-4xl mx-auto p-6 space-y-6">
+    <!-- Flash Banner -->
+    <div
+      v-if="page.props.flash?.success"
+      class="p-4 rounded-xl bg-emerald-500/10 border border-emerald-500/20 text-emerald-400 text-sm"
+    >
+      {{ page.props.flash.success }}
+    </div>
+
+    <h1 class="text-2xl font-bold text-slate-900 dark:text-white">Invoices</h1>
+
+    <!-- Form with Automatic Server Validation Error Bindings -->
+    <form @submit.prevent="submit" class="space-y-4">
+      <div>
+        <label class="block text-sm font-medium">Customer Name</label>
+        <input
+          v-model="form.customer_name"
+          type="text"
+          class="w-full px-3 py-2 border rounded-lg"
+          :class="{ 'border-rose-500': form.errors.customer_name }"
+        />
+        <p v-if="form.errors.customer_name" class="text-sm text-rose-500 mt-1">
+          {{ form.errors.customer_name }}
+        </p>
+      </div>
+
+      <button
+        type="submit"
+        :disabled="form.processing"
+        class="px-4 py-2 bg-sky-500 text-white rounded-lg disabled:opacity-50"
+      >
+        Create Invoice
+      </button>
+    </form>
+  </div>
+</template>
+```
+
+## Authentication & Security
+
+1. **Guards on Controllers**:
+   ```python
+   from astris.routing import Controller
+   from astris.auth import auth_required, guest_required, AuthUser
+   from astris.http import Request
+   from astris.inertia import InertiaResponse
+
+   controller = Controller(prefix="/dashboard", dependencies=[auth_required])
+
+   @controller.get("/")
+   async def dashboard(request: Request, user: AuthUser) -> InertiaResponse:
+       return InertiaResponse(request, "Dashboard", props={"user": user})
+   ```
+
+2. **Session Authentication Helpers**:
+   * `login_user(request, user_id)`: Log a user in by storing signed session cookie.
+   * `logout_user(request)`: Terminate current session.
+   * `hash_password(password)` / `verify_password(plain, hashed)`: Secure Argon2id password management.
+
+3. **CSRF Protection**:
+   Astris sets the `XSRF-TOKEN` cookie automatically. Inertia and Axios send the `X-XSRF-TOKEN` header on all mutating requests with zero frontend configuration.
+
+## Orbit CLI
+
+Always run Orbit commands via `uv run orbit`:
+
+* `uv run orbit serve`: Start local development server (Uvicorn backend + Vite frontend HMR concurrently).
+* `uv run orbit serve --prod`: Start production server on `0.0.0.0` with multi-worker processes.
+* `uv run orbit make:module <name>`: Scaffold domain module (`controller`, `service`, `model`).
+* `uv run orbit make:controller <name> [--module <mod>]`: Generate a controller.
+* `uv run orbit make:model <name> [--module <mod>]`: Generate a SQLModel database table.
+* `uv run orbit make:migration "<message>"`: Autogenerate Alembic schema migration from models.
+* `uv run orbit migrate`: Execute pending migrations.
+* `uv run orbit migrate:rollback`: Roll back database migrations.
+* `uv run orbit migrate:status`: Check current migration revisions.
+* `uv run orbit key:generate`: Generate a 32-byte secret key and update `APP_KEY` in `.env`.
+
+## Key Rules
+
+* Always configure via `.env` and `app/core/config.py`.
+* Never hardcode secrets in code.
+* Always use `DatabaseSession` with `Depends()` in route handlers and services.
+* Always redirect with `status.HTTP_303_SEE_OTHER` after POST/PUT/PATCH/DELETE mutations.

{astris_python-0.1.0 → astris_python-0.1.1}/src/astris/__init__.py

@@ -1,7 +1,10 @@
 from astris.config import Settings
 from astris.kernel import Astris
 
+__version__ = "0.1.1"
+
 __all__ = [
     "Astris",
     "Settings",
+    "__version__",
 ]

{astris_python-0.1.0 → astris_python-0.1.1}/src/astris/cli.py

@@ -31,20 +31,36 @@ def list_commands(ctx: typer.Context):
 
 @orbit_cli.command()
 def serve(
-    host: str = typer.Option(
-        "127.0.0.1", "--host", "-h", help="Bind socket to this host"
+    host: str | None = typer.Option(
+        None, "--host", "-h", help="Bind socket to this host (defaults to 127.0.0.1 in dev, 0.0.0.0 in prod)"
     ),
     port: int = typer.Option(8000, "--port", "-p", help="Bind socket to this port"),
-    reload: bool = typer.Option(
-        True, "--reload/--no-reload", help="Enable/disable auto-reload"
+    reload: bool | None = typer.Option(
+        None, "--reload/--no-reload", help="Enable/disable auto-reload"
     ),
-    vite: bool = typer.Option(
-        True,
+    vite: bool | None = typer.Option(
+        None,
         "--vite/--no-vite",
         help="Start concurrent Vite dev server if package.json exists",
     ),
+    prod: bool = typer.Option(
+        False,
+        "--prod",
+        help="Run in production mode (disables reload and Vite, sets host to 0.0.0.0, enables multi-worker)",
+    ),
+    workers: int | None = typer.Option(
+        None,
+        "--workers",
+        "-w",
+        help="Number of worker processes for production (defaults to 4 in prod)",
+    ),
 ):
-    """Start the development server (with concurrent Vite dev server if package.json exists)."""
+    """Start the application server (development with Vite HMR or production with --prod)."""
+    resolved_host = host or ("0.0.0.0" if prod else "127.0.0.1")
+    resolved_reload = False if prod else (True if reload is None else reload)
+    resolved_vite = False if prod else (True if vite is None else vite)
+    resolved_workers = workers if workers is not None else (4 if prod else 1)
+
     cwd = Path.cwd()
     cwd_str = str(cwd)
     if cwd_str not in sys.path:
@@ -54,7 +70,7 @@ def serve(
     package_json = cwd / "package.json"
     vite_proc = None
 
-    if package_json.exists() and vite:
+    if package_json.exists() and resolved_vite:
         typer.secho(
             "⚡ Full-stack project detected. Starting Vite dev server...",
             fg=typer.colors.MAGENTA,
@@ -73,26 +89,30 @@ def serve(
                 fg=typer.colors.YELLOW,
             )
 
+    mode_label = "in production mode" if prod else ""
     typer.secho(
-        f"🚀 Astris entering orbit on http://{host}:{port}", fg=typer.colors.CYAN
+        f"🚀 Astris entering orbit {mode_label} on http://{resolved_host}:{port}",
+        fg=typer.colors.CYAN,
     )
 
     try:
         reload_dirs = []
-        if (cwd / "app").exists():
-            reload_dirs.append(str(cwd / "app"))
-        if (cwd / "database").exists():
-            reload_dirs.append(str(cwd / "database"))
-        if not reload_dirs:
-            reload_dirs = [cwd_str]
+        if resolved_reload:
+            if (cwd / "app").exists():
+                reload_dirs.append(str(cwd / "app"))
+            if (cwd / "database").exists():
+                reload_dirs.append(str(cwd / "database"))
+            if not reload_dirs:
+                reload_dirs = [cwd_str]
 
         uvicorn.run(
             "main:app",
-            host=host,
+            host=resolved_host,
             port=port,
-            reload=reload,
-            reload_dirs=reload_dirs if reload else None,
-            reload_includes=["*.py", ".env*"] if reload else None,
+            reload=resolved_reload,
+            workers=resolved_workers if not resolved_reload else None,
+            reload_dirs=reload_dirs if resolved_reload else None,
+            reload_includes=["*.py", ".env*"] if resolved_reload else None,
             reload_excludes=[
                 "node_modules",
                 "resources",
@@ -102,7 +122,7 @@ def serve(
                 "dist",
                 "build",
             ]
-            if reload
+            if resolved_reload
             else None,
             app_dir=cwd_str,
         )
@@ -419,3 +439,40 @@ def make_auth():
     except Exception as e:
         typer.secho(f"Error generating auth scaffolding: {e}", fg=typer.colors.RED)
         raise typer.Exit(1) from e
+
+
+@orbit_cli.command("skills:install")
+def skills_install(
+    claude: bool = typer.Option(
+        False, "--claude", help="Install skills for Claude Code in .claude/skills as well"
+    ),
+):
+    """Install or regenerate AI agent skills for the project."""
+    astris_skill = Path(__file__).parent / ".agents" / "skills" / "astris" / "SKILL.md"
+    if not astris_skill.exists():
+        typer.secho("Error: Astris skill file not found in package.", fg=typer.colors.RED)
+        raise typer.Exit(1)
+
+    skill_text = astris_skill.read_text(encoding="utf-8")
+    targets = [Path.cwd() / ".agents" / "skills" / "astris"]
+    if claude:
+        targets.append(Path.cwd() / ".claude" / "skills" / "astris")
+
+    for target_dir in targets:
+        target_dir.mkdir(parents=True, exist_ok=True)
+        (target_dir / "SKILL.md").write_text(skill_text, encoding="utf-8")
+
+    typer.secho("✓ Astris AI skill installed successfully!", fg=typer.colors.GREEN)
+    typer.echo("  - Universal: .agents/skills/astris/SKILL.md")
+    if claude:
+        typer.echo("  - Claude:    .claude/skills/astris/SKILL.md")
+
+
+@orbit_cli.command("skills:update")
+def skills_update(
+    claude: bool = typer.Option(
+        False, "--claude", help="Update skills for Claude Code in .claude/skills as well"
+    ),
+):
+    """Update and re-sync all AI agent skills to match installed package versions."""
+    skills_install(claude=claude)

{astris_python-0.1.0 → astris_python-0.1.1}/src/astris/config.py

@@ -28,9 +28,21 @@ class Settings(BaseSettings):
     # Sessions & Security
     session_cookie_name: str = "astris_session"
     session_max_age: int | None = 14 * 24 * 60 * 60  # 14 days
-    session_https_only: bool = False
+    session_https_only: bool | None = None
     session_same_site: Literal["lax", "strict", "none"] = "lax"
 
+    @property
+    def is_production(self) -> bool:
+        """Return True if running in production mode."""
+        return self.app_env.lower() in ("production", "prod")
+
+    @property
+    def resolved_session_https_only(self) -> bool:
+        """Auto-enable HTTPS-only cookies in production unless explicitly overridden."""
+        if self.session_https_only is not None:
+            return self.session_https_only
+        return self.is_production
+
     # CORS & CSRF
     cors_origins: list[str] = [
         "http://localhost:5173",

{astris_python-0.1.0 → astris_python-0.1.1}/src/astris/installer.py

@@ -36,6 +36,11 @@ def new(
         "--auth/--no-auth",
         help="Scaffold full-stack authentication starter kit (default: enabled)",
     ),
+    claude: bool = typer.Option(
+        False,
+        "--claude",
+        help="Scaffold Claude Code agent skills in .claude/skills as well",
+    ),
 ):
     """Scaffold a brand-new Astris full-stack project."""
     project_dir = Path.cwd() / name
@@ -99,13 +104,31 @@ def new(
     ensure_migration_setup(project_dir)
 
     # 1b. Centralized settings: app/core/config.py
-    config_stub = """from astris.config import Settings as BaseAppSettings
+    config_stub = """\"\"\"
+|--------------------------------------------------------------------------
+| Application Configuration
+|--------------------------------------------------------------------------
+|
+| Centralized, type-safe application settings powered by Pydantic Settings.
+| Environment variables defined in your .env file are automatically
+| validated and type-cast when the application boots.
+|
+| Access settings anywhere in your app:
+|     from app.core.config import settings
+|     api_key = settings.stripe_api_key
+|
+\"\"\"
+
+from astris.config import Settings as BaseAppSettings
 
 
 class Settings(BaseAppSettings):
     \"\"\"Extend application settings with custom environment variables.\"\"\"
 
-    # Add custom settings here (e.g. STRIPE_KEY, REDIS_URL, etc.)
+    # Define custom environment variables below:
+    # stripe_api_key: str | None = None
+    # redis_url: str = "redis://localhost:6379"
+    # max_upload_size_mb: int = 25
     pass
 
 
@@ -145,7 +168,7 @@ dependencies = []
 '''
     (project_dir / "pyproject.toml").write_text(pyproject_content, encoding="utf-8")
     project_readme = f"""<p align="center" style="padding: 20px 0 10px 0;">
-  <a href="https://github.com/TheFelixGomez/astris">
+  <a href="https://astris.dev">
     <img src="https://raw.githubusercontent.com/TheFelixGomez/astris/main/.github/assets/astris-logo-name.png" alt="Astris" width="380">
   </a>
 </p>
@@ -184,12 +207,26 @@ Open **`http://localhost:8000`** in your browser.
 | Command | Description |
 | :--- | :--- |
 | `uv run orbit serve` | Start full-stack development server with hot-reloading |
-| `uv run orbit make:module <name>` | Scaffold a complete domain module (Controller, Model, View) |
+| `uv run orbit make:module <name>` | Scaffold a complete domain module (Controller, Service, Model) |
 | `uv run orbit make:controller <name>` | Generate an Astris controller |
 | `uv run orbit make:model <name>` | Generate a database model |
 | `uv run orbit migrate` | Run all pending database migrations |
 | `uv run orbit make:migration "<message>"` | Auto-generate a new database schema migration |
 | `uv run orbit key:generate` | Generate a new 32-byte secret `APP_KEY` in `.env` |
+| `uv run orbit skills:install` | Install or regenerate AI agent skills for the project |
+| `uv run orbit skills:update` | Re-sync AI agent skills to match installed package versions |
+
+---
+
+## 🤖 Building with AI
+
+This project comes pre-configured with official Astris skills in `.agents/skills/astris/` (Universal assistants) and `.claude/skills/astris/` (Claude Code).
+To refresh or reinstall skills after updating dependencies:
+```bash
+uv run orbit skills:install
+# Or for Claude Code:
+uv run orbit skills:install --claude
+```
 
 ---
 
@@ -200,6 +237,7 @@ Open **`http://localhost:8000`** in your browser.
 * **`resources/js/Pages/`**: Frontend single-page application views.
 * **`database/migrations/`**: Database schema migrations managed by Orbit.
 * **`public/`**: Web root directory for static assets (favicon, images, robots.txt).
+* **`.agents/skills/` & `.claude/skills/`**: Official AI agent skills for Antigravity, Claude Code, Codex, Cursor, and universal assistants.
 
 ---
 
@@ -207,6 +245,7 @@ Open **`http://localhost:8000`** in your browser.
 
 **Astris** is a modern full-stack web framework for Python with expressive, type-safe elegance. Designed to help developers build and ship modern web applications with speed and simplicity.
 
+* **Documentation**: [https://astris.dev](https://astris.dev)
 * **Repository**: [https://github.com/TheFelixGomez/astris](https://github.com/TheFelixGomez/astris)
 * **Author**: Felix Gomez ([@TheFelixGomez](https://github.com/TheFelixGomez))
 """
@@ -217,14 +256,48 @@ Open **`http://localhost:8000`** in your browser.
     )
 
     # 3. main.py entry point
-    main_content = """from astris import Astris
+    main_content = """\"\"\"
+|--------------------------------------------------------------------------
+| Application Entrypoint & Kernel
+|--------------------------------------------------------------------------
+|
+| This file instantiates the Astris application instance.
+| The Astris() kernel automatically:
+|   1. Loads configuration from app/core/config.py and .env
+|   2. Configures the security and session middleware pipeline
+|   3. Discovers domain controllers in app/modules/
+|   4. Connects the Inertia.js Vue 3 frontend view engine
+|
+| Run development server:
+|     uv run orbit serve
+|
+| Run in production:
+|     uv run orbit serve --prod
+|
+\"\"\"
+
+from astris import Astris
 
 app = Astris()
 """
     (project_dir / "main.py").write_text(main_content, encoding="utf-8")
 
     # 4. Default Welcome Controller using InertiaResponse
-    welcome_controller = """from astris.http import Request
+    welcome_controller = """\"\"\"
+|--------------------------------------------------------------------------
+| Welcome Controller
+|--------------------------------------------------------------------------
+|
+| This controller handles the root URL ('/') of your Astris application.
+| It returns an InertiaResponse which renders the Vue 3 component located
+| at resources/js/Pages/Welcome.vue with typed server props.
+|
+| Feel free to modify, replace, or remove this module and controller
+| to suit your application's requirements.
+|
+\"\"\"
+
+from astris.http import Request
 from astris.inertia import InertiaResponse
 from astris.routing import Controller
 
@@ -239,10 +312,10 @@ async def index(request: Request) -> InertiaResponse:
         props={
             "status": "online",
             "message": "Welcome to your Astris application! 🚀",
-            "version": "0.1.0",
+            "version": "0.1.1",
             "api_docs_url": "/docs",
             "redoc_url": "/redoc",
-            "docs_url": "https://astris.dev/docs",
+            "docs_url": "https://astris.dev",
         },
     )
 """
@@ -586,6 +659,18 @@ const page = usePage();
         else:
             subprocess.run(["uv", "add", "astris-python"], cwd=project_dir, check=True)
 
+    # 12. Scaffold bundled Astris agent skills
+    astris_skill = Path(__file__).parent / ".agents" / "skills" / "astris" / "SKILL.md"
+    if astris_skill.exists():
+        skill_text = astris_skill.read_text(encoding="utf-8")
+        target_dirs = [project_dir / ".agents" / "skills" / "astris"]
+        if claude:
+            target_dirs.append(project_dir / ".claude" / "skills" / "astris")
+
+        for skill_dir_path in target_dirs:
+            skill_dir_path.mkdir(parents=True, exist_ok=True)
+            (skill_dir_path / "SKILL.md").write_text(skill_text, encoding="utf-8")
+
     typer.secho(
         f"\n✓ Project {name} created successfully!", fg=typer.colors.GREEN, bold=True
     )

{astris_python-0.1.0 → astris_python-0.1.1}/src/astris/kernel.py

@@ -79,7 +79,7 @@ class Astris:
         self.session_https_only = (
             session_https_only
             if session_https_only is not None
-            else self.config.session_https_only
+            else self.config.resolved_session_https_only
         )
         self.session_same_site = (
             session_same_site or self.config.session_same_site  # type: ignore[assignment]