How Dynamic Static Works

Dynamic Static AI CMS uses a four-actor architecture to transform content creation:

  • Cantor: You, the content creator and site owner
  • Echo: AI co-creator (OpenAI Custom GPT) that helps generate content
  • Weaver: Backend service managing authentication and job processing
  • Opus: DevOps automation handling builds and deployments

No Database Required

Everything is stored in static files and JSON data. When you create content through the Custom GPT, it automatically:

  • Generates HTML pages in the articles/ or posts/ directories
  • Updates navigation menus in data/menu.json
  • Manages page metadata and relationships
  • Triggers automatic site rebuilds

Automatic Metadata Management

Every time your site builds, the system automatically:

  • Scans content: Reads all HTML and Markdown files
  • Extracts metadata: Titles, descriptions, tags, and relationships
  • Updates JSON files: Navigation, search indices, and content catalogs
  • Optimizes delivery: Generates fast, static assets

Getting Started

You've already completed the hard part! Here's what you've set up:

✅ Repository Forked

You have your own copy of the Dynamic Static codebase

✅ GitHub Configured

Workflows are active and ready to process content

✅ Web Server Running

You're viewing this page, so your server is working!

Next Steps:

  1. Configure the Custom GPT: Use the instructions in GPT/Configuration.md
  2. Set up Weaver: Deploy the backend service for authentication
  3. Create content: Start writing through the AI co-creator
  4. Watch it work: Content automatically appears on your site

This Page is an Example

This welcome page demonstrates Dynamic Static in action:

  • Static HTML: Fast loading, no server processing needed
  • Dynamic Features: Alpine.js provides interactive navigation
  • JSON Data: Menu items loaded from data/menu.json
  • Automatic Builds: Any content changes trigger regeneration

When you create your first article through the Custom GPT, you'll see:

  • New HTML file appears in articles/
  • Navigation menu automatically updates
  • Site search index refreshes
  • All without touching a database

Understanding the File Structure

dist/                    # Built site (this folder)
├── index.html          # This welcome page
├── articles/           # Generated article pages
├── posts/             # Generated blog posts  
├── css/               # Compiled stylesheets
├── img/               # Optimized images
├── data/              # JSON data files
│   ├── menu.json      # Navigation structure
│   ├── articles.json  # Article metadata
│   └── search.json    # Search index
└── favicon.ico        # Site icon

Key Point: You rarely edit files in dist/ directly. Content creation happens through the AI co-creator, which automatically generates and places files in the correct locations.

How Automatic Metadata Works

The magic of Dynamic Static is in its automatic metadata management. Every time your site builds:

Page-Level Metadata

  • Title extraction: From <h1> tags or <title>
  • Description generation: From first paragraph or meta tags
  • Tag detection: From content analysis and explicit tagging
  • Date tracking: Creation and modification timestamps

JSON File Updates

  • menu.json: Navigation structure automatically updated
  • articles.json: Full article metadata catalog
  • search.json: Search index with content snippets
  • tags.json: Tag relationships and counts
  • sitemap.json: Site structure for SEO

Content Relationships

The system automatically detects and maintains relationships between content:

  • Related articles: Based on shared tags and topics
  • Series detection: Multi-part content automatically linked
  • Category organization: Content grouped by subject matter
  • Cross-references: Internal links tracked and validated

Ready to Create Content?

Your Dynamic Static AI CMS is ready! The system is designed to be:

  • Simple: No databases or complex infrastructure
  • Fast: Static files served directly from your web server
  • Intelligent: AI handles content creation and organization
  • Automated: Builds and deploys happen automatically

Start creating content through your Custom GPT, and watch as your site grows and evolves automatically. Welcome to the future of content management!