Added basic deployment instructions to docs

Author: chriscarrollsmith

.gitignore

@@ -2,6 +2,9 @@
 __pycache__
 *.pyc
 .env
+.env.local
+.env.development
+.env.production
 _environment
 /.quarto/
 _docs/

docs/deployment.qmd

@@ -31,8 +31,6 @@ doctl projects list
 doctl projects create --name "YOUR-PROJECT-NAME" --purpose "YOUR-PROJECT-PURPOSE" --environment "Production"
 ```
 
-Take note of the Project ID in the output for later use.
-
 #### Set Up a Managed PostgreSQL Database
 
 Create a managed, serverless PostgreSQL database instance:
@@ -44,11 +42,8 @@ doctl databases create your-db-name --engine pg --version 17 --size db-s-1vcpu-1
 Get the database ID from the output of the create command and use it to retrieve the database connection details:
 
 ```bash
-# Get the database ID from the output of the create command
-DATABASE_ID="your-database-id"
-
-# Get connection details
-doctl databases connection $DATABASE_ID --format Host,Port,User,Password,Database
+# Get the database connection details
+doctl databases connection "your-database-id" --format Host,Port,User,Password,Database
 ```
 
 Store these details securely in a `.env.production` file (you will need to set them later in application deployment as production secrets):
@@ -94,29 +89,6 @@ The disadvantages are:
 - Install modal in the project directory with `uv add modal`
 - Run `uv run modal setup` to authenticate with Modal
 
-#### Setting Up Modal Secrets
-
-The application relies on environment variables stored in `.env` (like `SECRET_KEY`, `DB_USER`, `DB_PASSWORD`, `DB_HOST`, `DB_PORT`, `DB_NAME`, `RESEND_API_KEY`, `BASE_URL`). These sensitive values should be stored securely using Modal Secrets.
-
-Create a Modal Secret (e.g., named `fastapi-webapp-secrets`) either through the Modal UI or CLI:
-
-```bash
-# Example using CLI
-modal secret create your-app-name-secret \
-    SECRET_KEY='your_actual_secret_key' \
-    DB_USER='your_db_user' \
-    DB_PASSWORD='your_db_password' \
-    DB_HOST='your_external_db_host' \
-    DB_PORT='your_db_port' \
-    DB_NAME='your_db_name' \
-    RESEND_API_KEY='your_resend_api_key' \
-    BASE_URL='https://your-username--your-app-name-serve.modal.run'
-```
-
-You can probably guess what the `BASE_URL` will be from your user/organization name and the name of the Modal app, but you can also update it later after you get the official public base URL.
-
-**Important:** Ensure `DB_HOST` points to your *cloud* database host address, not `localhost` or `host.docker.internal`.
-
 #### Defining the Modal Image and App
 
 Create a new Python file in the root of your project, for example, `deploy.py`. This file will define the Modal Image and the ASGI app deployment.
@@ -138,24 +110,20 @@ Create a new Python file in the root of your project, for example, `deploy.py`.
     image = (
         modal.Image.debian_slim(python_version="3.13")
         .apt_install("libpq-dev", "libwebp-dev")
-        .pip_install("uv")
-        .run_commands(
-            # Install dependencies from pyproject.toml using uv
-            # Make sure uv sync handles psycopg2 correctly with libpq-dev present
-            "uv sync --no-dev --system --compile-bytecode",
-        )
+        .pip_install_from_pyproject("pyproject.toml")
+        .add_local_python_source("main")
         .add_local_python_source("routers")
         .add_local_python_source("utils")
         .add_local_python_source("exceptions")
-        .add_local_dir("static", remote_path="/static")
-        .add_local_dir("templates", remote_path="/templates")
+        .add_local_dir("static", remote_path="/root/static")
+        .add_local_dir("templates", remote_path="/root/templates")
     )
 
     # Define the Modal App
     app = modal.App(
-        name="fastapi-webapp", # Optional: name for your Modal app
+        name="your-app-name",
         image=image,
-        secrets=[modal.Secret.from_name("fastapi-webapp-secrets")]
+        secrets=[modal.Secret.from_name("your-app-name-secret")]
     )
     ```
 
@@ -188,16 +156,35 @@ For more information on Modal FastAPI images and applications, see [this guide](
 
 #### Deploying the App
 
-1.  From your terminal, in the root directory of your project, run:
-    ```bash
-    modal deploy deploy.py
-    ```
-    Modal will build the image (if it hasn't been built before or if dependencies changed) and deploy the ASGI app. It will output a public URL (e.g., `https://your-username--your-app-name.modal.run`).
+From your terminal, in the root directory of your project, run:
 
-2.  Once you have the public URL from Modal, make sure the `BASE_URL` variable in your Modal Secret matches this public URL. This is crucial for generating correct absolute URLs (e.g., in password reset emails). If you need to update the secret, run:
-    ```bash
-    modal secret update your-app-name-secret BASE_URL='https://your-modal-app-url'
-    ```
-    Redeploy if necessary (`modal deploy deploy.py`), although changes to secrets often take effect on subsequent container starts without a full redeploy.
+```bash
+modal deploy deploy.py
+```
+
+Modal will build the image (if it hasn't been built before or if dependencies changed) and deploy the ASGI app. It will output a public URL (e.g., `https://your-username--your-app-name.modal.run`).
+
+#### Setting Up Modal Secrets
+
+The application relies on environment variables stored in `.env` (like `SECRET_KEY`, `DB_USER`, `DB_PASSWORD`, `DB_HOST`, `DB_PORT`, `DB_NAME`, `RESEND_API_KEY`, `BASE_URL`). These sensitive values should be stored securely using Modal Secrets.
+
+Create a Modal Secret either through the Modal UI or CLI. Note that the name of the secret has to match the secret name you used in the `deploy.py` file, above (e.g., `your-app-name-secret`).
+
+```bash
+# Example using CLI
+modal secret create your-app-name-secret \
+    SECRET_KEY='your_actual_secret_key' \
+    DB_USER='your_db_user' \
+    DB_PASSWORD='your_db_password' \
+    DB_HOST='your_external_db_host' \
+    DB_PORT='your_db_port' \
+    DB_NAME='your_db_name' \
+    RESEND_API_KEY='your_resend_api_key' \
+    BASE_URL='https://your-username--your-app-name-serve.modal.run'
+```
+
+**Important:** Ensure `DB_HOST` points to your *cloud* database host address, not `localhost` or `host.docker.internal`.
+
+#### Testing the Deployment
 
-3.  Access the provided Modal URL in your browser. Browse the site and test the registration and password reset features to ensure database and Resend connections work correctly.
+Access the provided Modal URL in your browser. Browse the site and test the registration and password reset features to ensure database and Resend connections work.

main.py

@@ -188,7 +188,7 @@ async def read_home(
     user: Optional[User] = Depends(get_optional_user)
 ):
     if user:
-        return RedirectResponse(url="/dashboard", status_code=302)
+        return RedirectResponse(url=app.url_path_for("read_dashboard"), status_code=302)
     return templates.TemplateResponse(
         request,
         "index.html",

pyproject.toml

@@ -31,9 +31,5 @@ dev = [
     "notebook<8.0.0,>=7.2.2",
     "pytest<9.0.0,>=8.3.3",
     "sqlalchemy-schemadisplay<3.0,>=2.0",
-    "perplexity-cli",
     "mypy>=1.15.0",
 ]
-
-[tool.uv.sources]
-perplexity-cli = { git = "https://github.com/chriscarrollsmith/perplexity-cli.git" }