Humanship: Infrastructure and Workflow

By Mike Dupre —

The Philosophy

Corpus‑First, AI‑Forward. The architecture is designed to prioritize raw content (the corpus) in a way that is elegant for human readers and highly structured for AI ingestion. By stripping away heavy frameworks and performative UI, we lower the barrier for both engagement and portable intelligence.

The Tech Stack

1. Creation & Framework: Astro

Astro is the core engine. It generates a zero-JavaScript static site by default.

  • Astro Content Collections: We use structured Markdown files with TypeSafe schemas for managing Essays and Notes.
  • Component Architecture: Layouts and pages are built using Astro components.
  • Styling: Vanilla CSS focused on modern typography and “Sophisticated Minimalism.”

2. Publishing: Git & GitHub

The publishing process is anchored in version control.

  • Version Control: All changes are tracked in a Git repository.
  • Triggers: Pushing a commit to the main branch on GitHub serves as the “Publish” signal.

3. Serving: Cloudflare Pages

The site is hosted on Cloudflare’s global edge network.

  • Automated Continuous Deployment (CI/CD): Cloudflare Pages monitors the GitHub repository and automatically runs the build on every push.
  • Static Site Generation (SSG): Pre-rendered HTML is distributed across global data centers.
  • Performance: Near-instant load times with zero server maintenance.

The Workflow

  1. Drafting: New content is written as a .md file in the repository.
  2. Metadata: Frontmatter (YAML) defines the title, date, and summary.
  3. Deployment: Commit and push to GitHub.
  4. Live: Cloudflare completes the build and deploys to humanship.work.