Add SEO metadata to Quarto documentation site

chriscarrollsmith · claude · chriscarrollsmith · commit b8674c2191a3 · 2026-03-13T22:07:58.000-04:00
Enable Open Graph and Twitter Card tags, add site-url for canonical URLs, and add meta descriptions to all pages for better search engine visibility. Closes #37 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
diff --git a/_quarto.yml b/_quarto.yml
@@ -4,6 +4,10 @@ project:
 
 website:
   title: "FastAPI Webapp Template"
+  site-url: "https://promptlytechnologies.com/fastapi-jinja2-postgres-webapp/"
+  description: "A production-ready FastAPI web application template with Jinja2 templates, PostgreSQL database, and built-in authentication."
+  open-graph: true
+  twitter-card: true
   navbar:
     left:
       - href: index.qmd
diff --git a/docs/architecture.qmd b/docs/architecture.qmd
@@ -1,5 +1,6 @@
 ---
 title: "Architecture"
+description: "Overview of the FastAPI webapp template architecture including data flow, database schema, project structure, and routing."
 ---
 
 ## Data flow
diff --git a/docs/authentication.qmd b/docs/authentication.qmd
@@ -1,5 +1,6 @@
 ---
 title: "Authentication"
+description: "Guide to the FastAPI webapp template's authentication system including token-based auth, password recovery, and role-based access control."
 ---
 
 ## Security features
diff --git a/docs/contributing.qmd b/docs/contributing.qmd
@@ -1,5 +1,6 @@
 ---
 title: "Contributing"
+description: "How to contribute to the FastAPI webapp template project including guidelines for pull requests and development setup."
 ---
 
 ## Contributors
diff --git a/docs/customization.qmd b/docs/customization.qmd
@@ -1,5 +1,6 @@
 ---
 title: "Customization"
+description: "Guide to customizing the FastAPI webapp template including development workflow, code style conventions, and project structure."
 ---
 
 ## Development workflow
diff --git a/docs/deployment.qmd b/docs/deployment.qmd
@@ -1,5 +1,6 @@
 ---
 title: "Deployment"
+description: "Guide to deploying the FastAPI webapp template to cloud platforms including Railway, Render, and other hosting services."
 ---
 
 This application requires two services to be deployed and connected to each other:
diff --git a/docs/installation.qmd b/docs/installation.qmd
@@ -1,5 +1,6 @@
 ---
 title: "Installation"
+description: "Step-by-step installation guide for the FastAPI webapp template including Dev Container setup, manual installation, and environment configuration."
 ---
 
 ## Install all development dependencies in a VSCode Dev Container
diff --git a/index.qmd b/index.qmd
@@ -1,8 +1,9 @@
 ---
 title: "FastAPI, Jinja2, PostgreSQL Webapp Template"
+description: "A production-ready web application template combining FastAPI, Jinja2, and PostgreSQL with secure authentication, role-based access control, and easy cloud deployment."
 ---
 
-![Screenshot of homepage](docs/static/screenshot.jpg)
+![Screenshot of the FastAPI webapp template homepage](docs/static/screenshot.jpg)
 
 ## Quickstart
 
