# Allan Hillman - AI Engineer & Solution Architect (Extended)

> Comprehensive, agent-readable documentation of this portfolio.
> Concise version: https://allanhillman.com/llms.txt

---

## Who

Allan Hillman is an AI Engineer & Solution Architect who builds production AI systems and the architecture that ships them: retrieval and agentic workflows, headless content platforms, and the cloud and CMS plumbing around them. This site itself runs on an agent-assisted, fully headless content pipeline he designed.

## AI Capabilities & Point of View

- AI systems: retrieval-augmented generation, agentic workflows, and human-in-the-loop content pipelines.
- Solution architecture: headless CMS platforms, section-based page builders, and cache-correct ISR on Vercel.
- This portfolio is a working example: a fully Contentful-driven site with an AI pipeline that drafts entries behind a human review gate, on-demand cache invalidation, and a schema-validated data boundary that fails loud on drift.
- Production discipline: typed contracts, adversarial testing, observability (Sentry), and safe-by-default automation.

## Architecture (this site)

- Framework: Next.js 16 (App Router, React 19), static + ISR, SSG via generateStaticParams.
- CMS: Contentful (headless, GraphQL). Content types: page + section types, blogPost, caseStudy, person, seo, siteSettings, navigation.
- Data path: fetch (revalidate + cache tags) -> zod validation boundary -> transformers -> section/page-builder components -> rich-text renderer.
- Freshness: on-demand cache invalidation via a Contentful publish webhook (/api/revalidate).
- Automation: an AI content pipeline drafts blogPost/caseStudy entries as unpublished drafts for human review.
- Deploy: Vercel (Fluid Compute), Sentry for observability.

---

## Page Index

### Home
**URL:** https://allanhillman.com/
**Description:** AI Engineer & Solution Architect. Featured work, skills, and how to engage.

### About
**URL:** https://allanhillman.com/about
**Description:** Background, philosophy, and the AI + engineering track record.

### Work
**URL:** https://allanhillman.com/work
**Description:** Case studies and projects, with the engineering decisions behind them.

### Blog
**URL:** https://allanhillman.com/blog
**Description:** Points of view on AI systems, agents, and content architecture.

### Process
**URL:** https://allanhillman.com/process
**Description:** How engagements run, from envision to launch.

### Contact
**URL:** https://allanhillman.com/contact
**Description:** Start a conversation about an AI or platform build.

### Authentication using Firebase with Next.js
**URL:** https://allanhillman.com/work/firebase-guide
**Description:** This guide outlines Firebase Authentication in a Next.js app. It employs email/password setup and error handling with React Hot Toast, resulting in secure user authentication deployed on Firebase Hosting.
**Date:** 2023-07-01

### Seamless Communication Redefined
**URL:** https://allanhillman.com/work/meta-messenger
**Description:** An innovative approach to messaging, re-architected with Next.js, React.js, TypeScript, and Prisma for a seamless and intuitive communication experience.
**Date:** 2023-07-01

### Next-Gen Music Soundscape
**URL:** https://allanhillman.com/work/spotify
**Description:** A full-fledged Spotify Clone demonstrating the power of modern web technologies. Experience a sleek and dynamic user interface, robust backend functionality, and a seamless payment system, all built from scratch.
**Date:** 2023-06-01

### Moving My Blog Into Contentful
**URL:** https://allanhillman.com/blog/moving-my-blog-into-contentful
**Description:** I moved this blog off static files and into Contentful. Same words, faster to publish, and a step toward one reusable content model.
**Date:** 2026-07-06

### What I Learned Building a Page Builder in Contentful
**URL:** https://allanhillman.com/blog/page-builder-contentful-nextjs
**Description:** A page builder gives editors real freedom and hands developers a pile of edge cases. Here is the model that kept mine maintainable, and the mistakes I would skip next time.
**Date:** 2026-07-02

### Make Your Headless CMS Fail Loud, Not Silent
**URL:** https://allanhillman.com/blog/make-your-cms-fail-loud
**Description:** A headless site can serve stale content for months without anyone noticing. Here is how I stopped mine from failing quietly, and the three guardrails I now add to every project.
**Date:** 2026-06-24

### Next.js & Firebase Authentication Guide
**URL:** https://allanhillman.com/blog/firebase-auth-guide
**Description:** Discover how to create powerful web applications using Next.js and Firebase. Learn to set up authentication, create secure pages, and handle errors like a pro with React Hot Toast.
**Date:** 2023-08-05

---

## Track Record

- 8+ years shipping production systems
- 140+ headless and CMS sites delivered
- 5+ enterprise CMS platforms
- 25+ AI and automation integrations

## API Endpoints

| Endpoint | Purpose |
|----------|---------|
| `/api/revalidate` | Contentful publish webhook (ISR cache invalidation) |
| `/api/draft` | Enable Contentful preview mode |
| `/api/contact` | Contact form (Resend, rate-limited) |

## Crawling

AI crawlers welcome. All content is static or ISR for reliable crawlability.
- Sitemap: https://allanhillman.com/sitemap.xml
- Robots: https://allanhillman.com/robots.txt

Generated: 2026-07-09T04:36:36.638Z