Getting Started with GitHub CMS — First Steps Guide

Getting started with GitHub CMS takes 3 steps: clone the repository, write your first article in Markdown, and push to GitHub. The site builds automatically with JSON-LD, Open Graph, sitemap, and RSS feed. Full setup time: 5 minutes.

Step 1: Clone the Repository

git clone https://github.com/hubcms-dot/githubcms.git my-site
cd my-site
npm install

Step 2: Write Your First Article

Create a file content/blog/my-first-post.md:

---
title: "My First GitHub CMS Article"
description: "Learning how to publish with GitHub CMS"
slug: "my-first-post"
date: "2026-05-16"
author: "Your Name"
category: "General"
tags: ["getting-started"]
schema_type: "Article"
layout: "article"
---

## Hello World

This is my first article on GitHub CMS. The build process will automatically:
- Generate JSON-LD structured data
- Add Open Graph and Twitter Card meta tags
- Include this page in the sitemap
- Create breadcrumb navigation

Step 3: Build and Deploy

npm run build    # Local build
git add -A && git commit -m "First article"
git push         # Triggers CI/CD deployment

What Happens After Push

The CI/CD pipeline executes automatically:

1. Validate — 42 content files checked for frontmatter completeness
2. Build — Vite SSG generates static HTML with all SEO metadata
3. Inject SEO — 17 Schema.org types embedded directly into pages
4. Deploy — rsync to VPS with zero-downtime symlink swap

Summary

Your site is live with full AI visibility: JSON-LD structured data for 17 Schema.org types, automatic sitemap generation, Open Graph and Twitter Card previews, and TTFB ≤200ms through nginx static serving.