feat!: v0.3.0

.env.local.example

@@ -1,29 +1,107 @@
-# App
-SECRET_KEY='secret-key'
+# App Configuration
+SECRET_KEY='your-secret-key-here'
 LITESTAR_DEBUG=true
 LITESTAR_HOST=0.0.0.0
-LITESTAR_PORT=8089
-APP_URL=http://localhost:${LITESTAR_PORT}
+LITESTAR_PORT=8000
+APP_URL=http://localhost:8000
+LOG_LEVEL=20
 
-LOG_LEVEL=10
-# Database
-DATABASE_ECHO=true
-DATABASE_ECHO_POOL=true
+# Database Configuration
+DATABASE_ECHO=false
+DATABASE_ECHO_POOL=false
 DATABASE_POOL_DISABLE=false
-DATABASE_POOL_MAX_OVERFLOW=5
+DATABASE_POOL_MAX_OVERFLOW=10
 DATABASE_POOL_SIZE=5
 DATABASE_POOL_TIMEOUT=30
-DATABASE_URL=postgresql+asyncpg://app:app@localhost:15432/app
+DATABASE_USER=app
+DATABASE_PASSWORD=app
+DATABASE_HOST=localhost
+DATABASE_PORT=5432
+DATABASE_DB=app
+DATABASE_URL=postgresql://${DATABASE_USER}:${DATABASE_PASSWORD}@${DATABASE_HOST}:${DATABASE_PORT}/${DATABASE_DB}
 
-REDIS_URL=redis://localhost:16379/0
+# Redis Configuration
+REDIS_URL=redis://localhost:6379/0
 
-# Worker
-SAQ_USE_SERVER_LIFESPAN=True
+# Worker Configuration
+SAQ_USE_SERVER_LIFESPAN=False
 SAQ_WEB_ENABLED=True
 SAQ_BACKGROUND_WORKERS=1
 SAQ_CONCURRENCY=1
 
-VITE_HOST=localhost
-VITE_PORT=5174
+# Frontend Configuration
+VITE_USE_SERVER_LIFESPAN=True
 VITE_HOT_RELOAD=True
 VITE_DEV_MODE=True
+VITE_HOST=localhost
+VITE_PORT=3006
+ALLOWED_CORS_ORIGINS=["localhost:3006","localhost:8080","localhost:8000"]
+
+# Storage Configuration
+APP_SCRATCH_PATH=/tmp/app
+
+# Email Configuration (SMTP)
+EMAIL_ENABLED=true  # Set to true to enable email sending
+EMAIL_SMTP_HOST=localhost  # For MailHog: localhost, for production: your SMTP host
+EMAIL_SMTP_PORT=11025  # For MailHog: 11025, for production: 587 (TLS) or 465 (SSL)
+EMAIL_SMTP_USER=  # MailHog doesn't require auth, leave empty for dev
+EMAIL_SMTP_PASSWORD=  # MailHog doesn't require auth, leave empty for dev
+EMAIL_USE_TLS=false  # MailHog doesn't use TLS, set true for production
+EMAIL_USE_SSL=false  # MailHog doesn't use SSL, set true for production
+EMAIL_FROM_ADDRESS=noreply@localhost  # Default from email
+EMAIL_FROM_NAME="Litestar Dev App"  # Default from name
+EMAIL_TIMEOUT=30  # SMTP connection timeout in seconds
+
+# OAuth Configuration
+
+# Keycloak (Local Development OAuth Server)
+# ==========================================
+# Access Keycloak admin at: http://localhost:18080 (admin/admin)
+# Create a client with these settings for development OAuth testing
+OAUTH_ENABLED=true
+GOOGLE_CLIENT_ID=litestar-app  # Your Keycloak client ID
+GOOGLE_CLIENT_SECRET=your-client-secret  # Generated in Keycloak client settings
+GOOGLE_REDIRECT_URI=http://localhost:3000/auth/google/callback
+
+# Production Google OAuth (replace Keycloak values above when deploying)
+# GOOGLE_CLIENT_ID=your-production-google-client-id
+# GOOGLE_CLIENT_SECRET=your-production-google-client-secret
+# GOOGLE_REDIRECT_URI=https://yourdomain.com/auth/google/callback
+
+# MailHog (Development Email Testing)
+# ====================================
+# Access MailHog web UI at: http://localhost:8025
+# MailHog SMTP server runs on: localhost:1025
+# MailHog catches all emails sent to it during development
+
+# Example Production Email Provider Configurations:
+# =================================================
+
+# Gmail (requires app password):
+# EMAIL_SMTP_HOST=smtp.gmail.com
+# EMAIL_SMTP_PORT=587
+# [email protected]
+# EMAIL_SMTP_PASSWORD=your-app-password
+# EMAIL_USE_TLS=true
+# EMAIL_USE_SSL=false
+
+# SendGrid:
+# EMAIL_SMTP_HOST=smtp.sendgrid.net
+# EMAIL_SMTP_PORT=587
+# EMAIL_SMTP_USER=apikey
+# EMAIL_SMTP_PASSWORD=your-sendgrid-api-key
+# EMAIL_USE_TLS=true
+
+# AWS SES:
+# EMAIL_SMTP_HOST=email-smtp.us-east-1.amazonaws.com
+# EMAIL_SMTP_PORT=587
+# EMAIL_SMTP_USER=your-ses-smtp-username
+# EMAIL_SMTP_PASSWORD=your-ses-smtp-password
+# EMAIL_USE_TLS=true
+
+# Mailgun:
+# EMAIL_SMTP_HOST=smtp.mailgun.org
+# EMAIL_SMTP_PORT=587
+# [email protected]
+# EMAIL_SMTP_PASSWORD=your-mailgun-password
+# EMAIL_USE_TLS=true

.gitignore

@@ -104,6 +104,7 @@ celerybeat.pid
 .env*
 !.env.*.example
 !.env.testing
+!tools/deploy/docker/.env.docker
 .venv
 env/
 venv/
@@ -131,11 +132,12 @@ dmypy.json
 
 # Pyre type checker
 .pyre/
-
+.claude/
+.cursor/
 # vscode
 # .vscode
 .venv
-
+TODO.md
 # Logs
 logs
 *.log
@@ -167,15 +169,17 @@ tmp/
 temp/
 
 # built files from the web UI
-src/app/domain/web/public
-src/app/domain/web/public/hot
+src/py/app/server/web/public/*
+src/py/app/server/web/static/*
+src/py/app/server/public/*
 .vite
-src/app/domain/web/static
 public/hot
 public/bundle
-pdm-pythn
 
+pdm-python
 db.duckdb
 local.duckdb
 
 requirements.txt
+dist-ssr
+*.local

.pre-commit-config.yaml

@@ -2,10 +2,17 @@ default_language_version:
   python: "3"
 repos:
   - repo: https://github.com/compilerla/conventional-pre-commit
-    rev: v4.0.0
+    rev: v4.2.0
     hooks:
       - id: conventional-pre-commit
         stages: [commit-msg]
+  - repo: local
+    hooks:
+      - id: local-biome-check
+        name: biome check
+        entry: npx @biomejs/biome check --write --files-ignore-unknown=true --no-errors-on-unmatched --config-path src/js/biome.json
+        language: system
+        types: [text]
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v5.0.0
     hooks:
@@ -17,15 +24,15 @@ repos:
       - id: mixed-line-ending
       - id: trailing-whitespace
   - repo: https://github.com/charliermarsh/ruff-pre-commit
-    rev: "v0.9.10"
+    rev: "v0.12.0"
     hooks:
       # Run the linter.
-    - id: ruff
-      types_or: [ python, pyi ]
-      args: [ --fix ]
-    # Run the formatter.
-    - id: ruff-format
-      types_or: [ python, pyi ]
+      - id: ruff
+        types_or: [python, pyi]
+        args: [--fix]
+      # Run the formatter.
+      - id: ruff-format
+        types_or: [python, pyi]
   - repo: https://github.com/codespell-project/codespell
     rev: v2.4.1
     hooks:

.vscode/extensions.json

@@ -1,10 +1,3 @@
 {
-  "recommendations": [
-    "mikestead.dotenv",
-    "christian-kohler.path-intellisense",
-    "ms-python.vscode-pylance",
-    "ms-python.python",
-    "charliermarsh.ruff",
-    "ms-python.mypy-type-checker"
-  ]
+  "recommendations": ["mikestead.dotenv", "christian-kohler.path-intellisense", "ms-python.vscode-pylance", "ms-python.python", "charliermarsh.ruff", "ms-python.mypy-type-checker"]
 }