Guides System

Drop a markdown file in this folder, deploy, and it's live at /guides/{filename}.

Quick Start

1. Create a .md file in content/guides/ (e.g., cost-of-living-nwa.md)
2. Add YAML frontmatter at the top (see below)
3. Write your content in markdown
4. Deploy — the article is live at /guides/cost-of-living-nwa

The filename IS the URL slug. No database, no CMS, no config needed.

Frontmatter Schema

---
title: "Your Article Title"           # Required — page <title>, h1, OG title
description: "A short summary..."     # Required — meta description, OG description
date: "2026-02-22"                    # Required — ISO date, used for sorting and display
image: "/images/guides/my-image.jpg"  # Optional — hero image and OG image
draft: true                           # Optional — hidden in production, visible in dev
---

Markdown Features

Standard markdown plus GitHub Flavored Markdown (GFM) extensions:

• Headings (h2-h6) — rendered in Public Sans, normal case (not the uppercase brand style)
• Bold, italic, strikethrough
• Links — styled in brand primary color
• Bullet and numbered lists
• Tables (GFM) — bordered, with header background
• Blockquotes — rendered as callout boxes with left border and tinted background
• Inline code and fenced code blocks
• Horizontal rules (---)
• Images via standard markdown syntax

What You Get Automatically

Each guide page includes:

• SEO metadata — <title>, <meta name="description">, canonical URL, Open Graph tags
• Schema.org Article JSON-LD — structured data for search engines
• Reading time — calculated from word count (238 words/minute)
• Sitemap entry — automatically added to /sitemap.xml
• Navigation — guides index linked from navbar, mobile menu, and footer
• CTA footer — "Browse All Jobs" link at the bottom of every article

Draft Mode

Set draft: true in frontmatter to hide an article in production while keeping it visible during local development (npm run dev). Remove the field or set draft: false to publish.

File Structure

content/guides/
├── README.md                              ← this file
├── top-employers-northwest-arkansas.md    ← live at /guides/top-employers-northwest-arkansas
└── your-next-article.md                   ← live at /guides/your-next-article

Code Locations

File	Purpose
lib/guides.ts	Core library — reads files, parses frontmatter, renders markdown to HTML
app/(marketing)/guides/page.tsx	Index page — lists all published guides
app/(marketing)/guides/[slug]/page.tsx	Detail page — renders a single guide
components/guides/guide-card.tsx	Card component for the index listing
components/guides/article-json-ld.tsx	Schema.org structured data component
app/globals.css	Prose typography overrides (search for .prose)