TGK Share Capture Process

Use the automated capture script. Do not manually edit bodyClass, take screenshots by hand, or save files one by one unless the browser automation is temporarily unavailable.

What the script does

npm run capture:share:

• builds the site unless --skip-build is passed
• serves _site locally
• injects capture classes at request time
• hides capture-only UI noise
• renders the target variants at the correct export sizes
• writes JPEGs either to a review folder or directly into src/tgk-assets/images/share/...

The capture CSS lives in:

• /src/css/utilities/share-capture.css

Header-level overrides that still affect capture live in:

• /src/css/layout/header-styles.css

The capture runner lives in:

• /scripts/share-capture.mjs

Command

npm run capture:share -- --path /pillars/the-teachings/

Options

• --path <site-path>
• --level series|season|episode|part
• --browser edge|chrome
• --variants hero,x,square,portrait,story
• --output-subdir <relative-path-under-src/tgk-assets/images/share>
• --output-dir <absolute-or-relative-output-dir>
• --skip-build
• --quality <1-100>
• --port <number>

Output sizes

• hero: 1600x900
• x: 1200x630
• square: 1200x1200
• portrait: 1080x1350
• story: 1080x1920

Recommended workflow

1. Anchor on part-1

Use part-1 as the definitive baseline for hierarchy, sizing, and centering before drifting upward. Generate the review assets for that page first:

npm run capture:share -- --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1/ --level part --output-dir tmp/share-capture-review/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1

2. Tune and approve the variants

Make sure every hero/x/square/portrait/story variant on part-1 matches the shared baseline before promoting them. Suggested order:

1. x
2. hero
3. portrait
4. square
5. story

After each change, rerun only the affected variant and confirm the capture shows the centered hierarchy (wordmark and title centers should align).

3. Promote to the real share folder

Once the part-1 review set is locked, copy the verified images to the real asset path:

npm run capture:share -- --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1/ --level part

That writes to:

• /src/tgk-assets/images/share/the-teachings/the-great-return/

Examples

Pillar landing

npm run capture:share -- --path /pillars/the-teachings/

Series landing

npm run capture:share -- --path /pillars/the-teachings/the-great-return/ --level series

Season landing

npm run capture:share -- --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/ --level season

Episode landing

npm run capture:share -- --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/ --level episode

Part page

npm run capture:share -- --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1/ --level part

Review output only

npm run capture:share -- --path /pillars/the-teachings/the-great-return/the-afterlife/ --level series --output-dir tmp/share-capture-review/the-teachings/the-great-return/the-afterlife

Skip rebuild while iterating

npm run capture:share -- --skip-build --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/ --level season --variants story

Force Chrome

npm run capture:share -- --browser chrome --path /pillars/the-teachings/

Capture-specific behavior already in the script

• share-capture classes are injected at request time
• floating toggles and drawer UI are hidden for captures
• page-specific capture classes are injected from the URL path
• portrait comma line-break injection is now limited to /pillars/the-teachings/ only
• some page/variant fixes are injected inline at capture time when CSS cascade conflicts make that safer

Troubleshooting

Browser startup failure

Symptom:

• Timed out waiting for browser remote debugger.

What this means:

• the headless browser process did not expose its debug port
• this is a local machine/browser state problem, not usually a CSS problem

Try in this order:

1. Restart the PC.
2. Fully close Chrome and Edge background processes in Task Manager.
3. Retry with Chrome:

npm run capture:share -- --skip-build --browser chrome --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1/ --level part --variants square --output-dir tmp/share-capture-review/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1

4. Retry with Edge:

npm run capture:share -- --skip-build --browser edge --path /pillars/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1/ --level part --variants square --output-dir tmp/share-capture-review/the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1

Current note for March 4, 2026:

• the earlier browser debugger failure was transient
• Chrome capture is working again in the current machine state
• the blocker is no longer browser startup; it is final visual tuning for part-1

When capture is blocked but CSS is ready

If browser capture is failing:

1. keep making only minimal variant-specific changes
2. document the exact pending command and target file
3. do not write review output into the real asset folder until the fresh image is verified

Current rollout status

Completed and written to canonical share assets (hero/x/square/portrait/story):

• the-teachings/
• the-teachings/the-great-return/
• the-teachings/the-great-return/the-afterlife/
• the-teachings/the-great-return/the-afterlife/season-1/
• the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-1/
• the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-2/
• the-teachings/the-great-return/the-afterlife/season-1/gnostic-christianity/part-3/
• the-teachings/the-great-return/the-afterlife/season-1/kabbalah/
• the-teachings/the-great-return/the-afterlife/season-1/kabbalah/part-1/
• the-teachings/the-great-return/the-afterlife/season-1/kabbalah/part-2/
• the-teachings/the-great-return/the-afterlife/season-1/kabbalah/part-3/
• the-teachings/the-great-return/the-afterlife/season-1/sufi-islam/
• the-teachings/the-great-return/the-afterlife/season-1/sufi-islam/part-1/
• the-teachings/the-great-return/the-afterlife/season-1/sufi-islam/part-2/
• the-teachings/the-great-return/the-afterlife/season-1/sufi-islam/part-3/
• zoe-speaks/tucker-carlson-is-almost-there/

Important note

This README is the recovery point for the current rollout. If the machine is restarted and the session is resumed, continue by using npm run capture:share with --skip-build for any future pages, ensuring bodyClass relies on hero-full share-capture capture-{variant} injected by the script. All season‑1 Afterlife and Teachings landings/parts listed above are already in canonical storage; no pending review items remain.