diff --git a/README.md b/README.md
index bd7edce7..3a726da1 100644
--- a/README.md
+++ b/README.md
@@ -323,27 +323,34 @@ NextCommunity.github.io/
 │   │   ├── codespell.txt              # Accepted words for spell checks
 │   │   └── zizmor.yml                 # GitHub Actions security lint config
 │   ├── workflows/
-│   │   ├── deploy.yml                 # Deployment workflow
-│   │   ├── prek-audit.yml             # prek audit workflow
-│   │   ├── prek-manual.yml            # Manual prek workflow
-│   │   ├── prek.yml                   # Standard prek workflow
-│   │   └── super-linter.yml           # Super-linter workflow
+│   │   ├── deploy.yml                         # Production deployment workflow
+│   │   ├── firebase-hosting-merge.yml        # Firebase deploy on merge
+│   │   ├── firebase-hosting-pull-request.yml # Firebase preview deploys for PRs
+│   │   ├── prek-audit.yml                     # prek audit workflow
+│   │   ├── prek-manual.yml                    # Manual prek workflow
+│   │   ├── prek.yml                           # Standard prek workflow
+│   │   └── super-linter.yml                   # Super-linter workflow
 │   ├── CODEOWNERS                     # Code ownership rules
 │   ├── dependabot.yml                 # Dependabot configuration
 │   └── FUNDING.yml                    # Sponsorship links
 ├── src/
 │   ├── _data/                         # Site-wide data files
 │   │   ├── build.js                   # Build metadata injected into templates
-│   │   └── levels.json                # XP level definitions for gamification
+│   │   ├── levels.json                # XP level definitions for gamification
+│   │   └── site.js                    # Global site metadata
 │   ├── _includes/                     # Reusable Nunjucks templates
 │   │   ├── bio.njk                    # Individual developer profile layout
 │   │   ├── footer.njk                 # Site footer wrapper
 │   │   ├── footer-details.njk         # Footer content (links, credits)
 │   │   ├── game-modal.njk             # Modal overlay for mini-games
 │   │   ├── game-stats.njk             # In-game XP / stats display
+│   │   ├── github-ribbon.njk          # "Fork me on GitHub" ribbon include
 │   │   ├── header.njk                 # Site header wrapper
 │   │   ├── header-details.njk         # Header content (nav, theme toggle)
+│   │   ├── layouts/
+│   │   │   └── base.njk               # Base page layout wrapper
 │   │   ├── matrix-overlay.njk         # Matrix rain easter egg overlay
+│   │   ├── seo-meta.njk               # SEO/Open Graph metadata tags
 │   │   ├── scripts.njk                # JS <script> tags included by footer
 │   │   ├── skills-list.njk            # Renders a developer's skills/languages
 │   │   ├── system-log.njk             # Scrolling system-log UI element
@@ -354,26 +361,29 @@ NextCommunity.github.io/
 │   │   │   ├── tailwind-input.css     # Tailwind CSS entry point
 │   │   │   └── tailwind.css           # Generated Tailwind CSS output
 │   │   ├── img/
+│   │   │   ├── github-fork-me.png     # GitHub ribbon image asset
 │   │   │   └── next.jpeg              # Site logo / avatar image
 │   │   └── js/
 │   │       ├── eggs.js                # Easter egg interactions
-│   │       ├── phaser.bundle.js       # Generated Phaser bundle
 │   │       ├── phaser-init.js         # Phaser game engine bootstrap
 │   │       ├── script.js              # Core interactivity & XP system
 │   │       └── games/                 # Mini-game modules
-│   │           ├── code-breaker.js
+│   │           ├── code-breaker.js    # Code puzzle mini-game
 │   │           ├── config.js          # Shared game constants & CDN URL
-│   │           ├── dev-duel.js
+│   │           ├── dev-duel.js        # Reflex mini-game
 │   │           ├── game-manager.js    # Game lifecycle (load/create/destroy)
-│   │           └── space-invaders.js
+│   │           └── space-invaders.js  # Shooter mini-game
 │   ├── users/                         # 👈 Developer profile YAML files
 │   │   ├── users.json                 # Eleventy data file aggregating YAMLs
 │   │   ├── jbampton.yaml
 │   │   └── ...                        # One <github-username>.yaml per dev
 │   ├── games.njk                      # Games page template
-│   └── index.njk                      # Homepage template
+│   ├── index.njk                      # Homepage template
+│   ├── robots.njk                     # robots.txt template
+│   └── sitemap.njk                    # XML sitemap template
 ├── .editorconfig                      # Editor formatting rules
 ├── .eleventy.js                       # Eleventy configuration
+├── .firebaserc                        # Firebase project alias config
 ├── .gitattributes                     # Git text normalization rules
 ├── .gitignore                         # Git ignored files
 ├── .npmrc                             # npm configuration
@@ -381,9 +391,12 @@ NextCommunity.github.io/
 ├── .pre-commit-config.yaml            # prek hooks config
 ├── LICENSE                            # Project license
 ├── biome.json                         # Biome formatter / linter config
+├── firebase.json                      # Firebase Hosting configuration
 ├── package-lock.json                  # Locked npm dependency versions
 ├── package.json                       # Node.js dependencies & scripts
 ├── postcss.config.js                  # PostCSS / Tailwind build config
+├── pyproject.toml                     # Python tooling config for prek/uv
+├── uv.lock                            # Locked Python dev dependencies
 └── README.md                          # This documentation
 ```