NHL team hub pages

Use this when adding or refreshing an NHL club desk under The Pros.

This is not the sled team-profile flow in nikola/AGENTS.md. Club desks are Hugo section indexes, not team-profile-*.md posts.

Do not hand-edit content/the-pros/<league>/teams/<slug>/_index.md. The layout is the Python template in hockey_generator.services.nhl.team_hubs. Change that file, then rewrite every hub so the format stays in sync. NHL hubs use /the-pros/nhl/teams/<slug>/; PWHL hubs use /the-pros/pwhl/teams/<slug>/. Article posts stay under the team directory but keep url: /posts/<post-slug>/.

Fast path

  1. Open apps/hockey_addict_generator/src/hockey_generator/services/nhl/team_hubs.py.
  2. Copy an existing NhlTeamHub(...) in NHL_TEAM_HUBS (Lightning is the layout reference).
  3. Fill in only the club-specific bits listed under Swap these. Do not invent tags, URLs, roster moves, scores, or league membership.
  4. Run make write-nhl-team-hubs (or python -m hockey_generator.cli.write_nhl_team_hubs). That rewrites every club _index.md from the shared template, including sibling jump chips.
  5. Add a [[menu.main]] entry in hugo.toml and a chip on content/the-pros/_index.md only if the club should be in the top nav (in_nav=True).
  6. New posts land in the club folder because hugo_sections reads NHL_TEAM_HUBS. The daily digest includes every NHL club desk (not PWHL).
  7. To create pages for every NHL and PWHL club in the database (skipping ones that already exist): python -m hockey_generator.cli.write_nhl_team_hubs --from-database --missing-only. Do not add those clubs to top nav unless they are already a nav item.

To change the page format (header, tools row, videos/podcasts, news): edit render_team_hub_page / _TEAM_HUB_BODY in team_hubs.py, then run make write-nhl-team-hubs. Do not restyle one _index.md by itself.

Files to open

  1. This file
  2. apps/hockey_addict_generator/src/hockey_generator/services/nhl/team_hubs.py
  3. apps/hockey_addict_site/hugo.toml [menu.main] only for nav clubs
  4. content/the-pros/_index.md only for nav chips
  5. content/_index.md only if you need the homepage header shape

Do not copy _index.md from Lightning. The writer emits that layout.

Look up the club first

  • A hub already exists in NHL_TEAM_HUBS: update that dataclass, then rewrite.
  • A stub still lives under content/posts/<slug>.md: keep aliases: ["/posts/<slug>/"] on the hub (the template already adds this).
  • Nothing exists: append NhlTeamHub and rewrite.

Do not create a second slug for the same club. Article posts stay at url: /posts/<post-slug>/. The hub uses /the-pros/<league>/teams/<slug>/; old /the-pros/<slug>/ URLs are aliases only.

Page order (do not reorder)

  1. Homepage-style header (nhl-hub-hero + home-hub-hero)
  2. Stats (TEAM_HUB_STATS markers): last 10 games and a two-week LLM desk note. NHL clubs only. Filled by the daily pipeline (write_nhl_team_hub_stats).
  3. Compact black tool cards in one row
  4. Videos and podcasts in two columns (last 10 each)
  5. News (post-list), unchanged when restyling tools or media

Put stats, tools, videos/podcasts, and news below the header. Do not nest the tools row inside the hero. Do not bring back per-show Coach Rox cards or Spotify show embeds.

Swap these

Piece What to change on NhlTeamHub
Identity title, slug, html_id, short_name, kicker, date, description
Intro Short Coach Rox desk intro. Keep facts the user pasted or that were already on the page.
Tools nhl_path, nst, nst_label, ahl_name, ahl_url, optional extra_tiles
Shortcode tags Tags that already exist on posts for that club (video_tags, podcast_tags, news_tag, summary_tag)
Post routing section_exact, section_prefixes, section_contains, slug_prefixes
Nav in_nav=True only if the club is a top-nav item

Jump chips (#<id>-stats on NHL clubs, #<id>-tools, videos, podcasts, news, NHL hub, other nav clubs) are generated. Shared tile layout also lives in static/css/perf.css.

Tool cards

One Bootstrap row. Each card is a .col. Three columns on phones, six on desktop. Do not split tools across two rows. Do not stack them in a single column.

URL patterns (filled from the dataclass):

  • NHL.com: https://www.nhl.com/<nhl-path>
  • Daily Faceoff: https://www.dailyfaceoff.com/teams/<slug>/line-combinations
  • Frozen Pool: https://frozenpool.dobbersports.com/frozenpool_lastgamelines.php?team=<nst>
  • PuckPedia: https://puckpedia.com/team/<slug>
  • Natural Stat Trick: https://www.naturalstattrick.com/teamreport.php?team=<nst>
  • MoneyPuck: https://moneypuck.com/
  • Prospects: /the-pros/nhl-prospects/

Card copy: NHL.com scores/video/tickets; Daily Faceoff lines and goalies; Frozen Pool last game lines (Dobber); PuckPedia cap hits and space; Natural Stat Trick 5v5 report; MoneyPuck game and season projections; AHL affiliate name; NHL Prospects draft classes and scouting shows.

Club-specific coverage sites go on extra_tiles (NhlHubTile href, title, subtitle). Lightning currently adds Lightning Insider, Bolts by the Bay, and Raw Charge. Extra tiles wrap onto the next row; do not change the three-across / six-across card width.

Videos, podcasts, news

stop="10" for media, stop="12" for news. Tags come from the dataclass. Use tags that already exist on posts.

Clubs already on this pattern

Club slug nhl-path NST AHL Videos Podcasts News
Lightning tampa-bay-lightning lightning T.B Syracuse Crunch tbl tbl-podcasts, tbl tampa_bay_lightning
Canadiens montreal-canadiens canadiens MTL Laval Rocket mtl mtl mtl
Panthers florida-panthers panthers FLA Charlotte Checkers fla fla fla
Maple Leafs toronto-maple-leafs mapleleafs TOR Toronto Marlies tor tor tor
Rangers new-york-rangers rangers NYR Hartford Wolf Pack nyr nyr nyr

AHL sites already used: https://www.syracusecrunch.com/, https://www.lavalrocket.com/, https://www.charlottecheckers.com/, https://www.marlies.ca/, https://www.hartfordwolfpack.com/.

NHL daily feed summary

The daily digest (nhl-feed-summary-YYYY-MM-DD) is built from NHL_FEED_SUMMARY_DESKS in apps/hockey_addict_generator/src/hockey_generator/post_generator/feed_summary.py, which imports club desks from NHL_TEAM_HUBS.

Page order:

  1. Team jump chips for every NHL club
  2. League-wide NHL recap at the top (quotes and sentiment). No Works cited / Today’s coverage / Sources labels.
  3. League-wide Videos, Podcasts, and Feeds in three columns
  4. Club desks: city kicker plus nickname, Team Page (orange) left of Official Site, that club’s sentiment gauge and citations, then Videos | Podcasts | Feeds

ensure_nhl_feed_summary_source_registered copies desk summary_tag values onto the NHL Feed Summary source (teams before nhl).