README

The Sunday Blender's canister URL: https://bf52x-nyaaa-aaaan-qz5aq-cai.icp0.io/

Additional Documentation

• PLAN.md - Project roadmap and planning
• TWITTER_BOT_README.md - Twitter bot documentation

Deploy, Test & Publish

Start Hugo's development server to view the hot-loaded site

hugo server

View the site on //localhost:1313 (with bind address 127.0.0.1)

To view the local site with draft content, run either of these commands:

hugo server --buildDrafts
hugo server -D

To view draft content with future dates (specific to The Sunday Blender workflow):

hugo server -D -F

When publish the site, typically you do NOT want to include draft, future, or expired content, just do:

hugo

Or to minify assets and reduce what's needed for human to understand

hugo --minify

After creating the static HTML assets in public/ folder, git push the current branch to the remote:

git push --set-upstream origin <local_branch_name>

Publishing Workflow

Complete workflow for creating and publishing a new issue of The Sunday Blender newsletter.

1. Create Draft Branch

Create a draft branch for the next issue and start editing content:

git checkout -b drafts/YYYYMMDD

2. Weekly Content Updates

Update the draft branch throughout Monday to Friday with additional stories, materials, and content refinements.

3. Complete Saturday Editing

Complete editing of the index.md file in Cursor on Saturday. Keep the draft: true flag in the frontmatter at this stage.

4. Start Hugo Development Server

Ensure Hugo development server is running for PDF generation:

hugo server -D -F

Keep this running in a separate terminal throughout the publishing process. The -D flag includes draft content and -F includes future-dated posts.

5. Generate PDF Version

Navigate to the draft issue directory and create the PDF version:

cd content/posts/drafts/YYYYMMDD
tsb-make-pdf

This generates a PDF file in the same directory, which will be used for podcast creation.

6. Create Audio Podcast with NotebookLM

• Upload the generated PDF to Google NotebookLM
• Generate an audio file (m4a format)
• Download and place the m4a file in the issue folder

7. Process Podcast Audio

Run the podcast processing script to:

• Convert m4a to mp3 format
• Update frontmatter fields with podcast metadata (duration, file size, etc.)

tsb-process-podcast

8. Generate Podcast Show Notes

Update the podcast RSS XML feed with enhanced show notes:

tsb-generate-shownotes

This creates AI-enhanced show notes with structured sections (Overview, Key Topics, Notable Quotes, etc.) in the RSS feed.

9. Finalize and Push Changes

• Change draft: false in the frontmatter
• Move the draft folder from content/posts/drafts/YYYYMMDD/ to the proper date-based path content/posts/YYYY/MM/MMDD/
• Commit all changes:

git add content/posts/YYYY/MM/MMDD/
git commit -m "Add YYYY-MM-DD issue with podcast and show notes"
git push --set-upstream origin drafts/YYYYMMDD

10. Create Pull Request

Create a PR to merge the commits into main, which triggers the GitHub Actions deploy workflow to Internet Computer (IC) mainnet.

11. Merge and Clean Up Remote

• Merge the PR on GitHub
• Delete the remote draft branch after successful merge

12. Update Local Main Branch

Switch to main and pull the latest changes:

git checkout main
git pull

13. Delete Local Draft Branch

Clean up the local draft branch:

git branch -d drafts/YYYYMMDD

14. Post Announcement Tweet

Post an announcement tweet on @SundayBlender to announce the new issue:

• Log in to X.com with the @SundayBlender account
• Compose a tweet announcing the new issue with the article link
• Include relevant hashtags and a brief teaser about the content
• Attach the featured image if applicable

15. Schedule Twitter Bot

Initiate the Twitter bot schedule script to promote the new issue across social media.

On Dalaran, run the interactive scheduler:

./scripts/schedule_tweets.sh

Refer to TWITTER_BOT_README.md for detailed Twitter bot instructions.

16. Update Content Update Progress Chart

Update the "Content Update Progress" table in the README with the new issue status. Mark completed items with 🟢 and incomplete items with 🔴:

• Images: 🟢 (if images are included)
• PDF: 🟢 (PDF was generated in step 5)
• Show Notes: 🟢 (show notes were generated in step 8)
• Apple: 🟢 (if uploaded to Apple Podcasts)
• Spotify: 🟢 (if uploaded to Spotify)
• 小宇宙: 🟢 (if uploaded to Xiaoyuzhou)
• 喜马拉雅: 🔴 (or 🟢 if uploaded)
• Inline 🎧: 🟢 (podcast is inline in the post)

Content Update Progress

Date	Images	PDF	Show Notes	Apple	Spotify	小宇宙	喜马拉雅	Inline 🎧
2025-11-15	🟢	🟢	🔴	🟢	🟢	🟢	🔴	🟢
2025-11-08	🟢	🟢	🔴	🟢	🟢	🟢	🔴	🟢
2025-11-01
2025-10-25
2025-10-11
2025-09-27
2025-09-20
2025-09-13
2025-07-06
2025-06-28
2025-06-21
2025-06-15
2025-06-07
2025-05-31
2025-05-24
2025-05-17
2025-05-10
2025-05-09
2025-05-03
2025-04-26
2025-04-20
2025-04-05
2025-03-29
2025-03-22
2025-03-16
2025-03-09
2025-03-02
2025-02-24
2025-02-16
2025-02-09
2025-02-01
2025-01-30
2025-01-26