The Inference Stack — GitHub Pages Development Notes

Site Overview

URL: https://inference.thinxai.net/ Theme: Catppuccin Mocha (dark tech aesthetic) Color Palette: Blues, greens, silver on dark background Generator: Jekyll with GitHub Pages

2026-02-22: Comments and Feedback System

Giscus Integration

• Installed Giscus GitHub App on repository
• Added _includes/comments.html with Giscus widget
• Theme: noborder_dark (matches Catppuccin Mocha)
• Maps to: GitHub Discussions → Announcements category
• Requires GitHub login to comment

Anonymous Feedback Form

• Added Formspree-powered form below Giscus
• No login required - name + message only
• Submissions go to: jdlongmire@outlook.com
• Thank-you page: feedback-thanks.html
• First submission requires email verification

Files Modified

• _layouts/article.html - added comments include
• _includes/comments.html - Giscus + feedback form
• feedback-thanks.html - thank-you redirect page

2026-02-22: Site-Wide Search

Implementation

• Added _includes/search.html with lunr.js
• Search icon in header (magnifying glass)
• Modal overlay with real-time search
• Indexes all articles and framework pages

Files Added/Modified

• _includes/search.html - search modal component
• _includes/header.html - added search icon trigger
• search.json - Jekyll template for search index

2026-02-22: Trust Architecture Article

Content

• New article on AI trust as architectural pattern
• Hero image with mobile optimization
• Responsive video embed (YouTube)

Mobile Optimizations

• Video: max-width: 100%; height: auto;
• Hero image: responsive sizing with aspect-ratio
• Consistent with mobile-friendly media rule

2026-02-22: Google Search Console

Verification

• Added google39a40287e5ba25e8.html to repo root
• Added meta tag to _includes/head.html
• Site verified and indexing

SEO

• robots.txt added
• Sitemap auto-generated by jekyll-sitemap plugin

2026-02-21: Article Migration

Migrated from Substack

12 articles with images preserved:

1. AIDK Framework
2. Amazon AI Bot
3. Confidence Laundering
4. Context Poisoning
5. Cyber Risk Two-Front War
6. Flexibly Deterministic
7. GPU Doesn’t Care
8. Hidden Human
9. Know Your Limitations
10. Real Work Real Failure
11. Retreat from AGI
12. Rules I Can’t Follow
13. Sarbanes-Oxley for AI
14. Using AI Wrong
15. What Can AI Do

Fixes Applied

• Added permalinks to all articles (fixed 404s)
• Added permalinks to framework pages
• Updated navigation structure

2026-02-21: Initial Site Setup

GitHub Pages Configuration

• Created docs/ folder structure
• _config.yml with minima base + custom theme
• Catppuccin Mocha color scheme
• Custom layouts: default, article, framework

Structure

docs/
├── _config.yml
├── _includes/
│   ├── comments.html
│   ├── head.html
│   ├── header.html
│   └── search.html
├── _layouts/
│   ├── article.html
│   ├── default.html
│   └── framework.html
├── articles/
│   ├── index.md
│   └── [15 article files]
├── assets/
│   └── images/
├── framework/
│   ├── index.md
│   ├── aidk.md
│   ├── hcae.md
│   └── research-program.md
├── index.md
├── search.json
├── robots.txt
└── feedback-thanks.html

Navigation

• Home (landing with research overview)
• Articles (chronological list)
• Framework (AIDK, HCAE, Research Program)

Local Development

cd docs
bundle install
bundle exec jekyll serve
# Open http://localhost:4000/

Deployment

Automatic via GitHub Pages on push to main. No manual build required.

Future Considerations

• RSS feed for articles
• Tags/categories for article filtering
• Citation export (BibTeX)
• Dark/light mode toggle