Blog Management

A healthy blog is the engine of your organic growth. This project uses Keystatic to manage your content while keeping it stored directly in your repository as Markdown. This ensures your content is fast, secure, and ready for technical SEO audits.

---

Where Content Lives

All blog posts are stored as individual .md files in the src/content/posts/ directory. Each file contains the post's content and its metadata (frontmatter), which is parsed by 42crawl for SEO analysis.

---

How to Add a New Post

Follow these steps to publish a new article:

1. Create the File: Add a new .md file in src/content/posts/.
2. Add Frontmatter: Every post needs a header like this:

   ---
   title: "Your Optimized Title"
   excerpt: "A compelling summary for SEO and social sharing."
   category: "Technical SEO"
   publishedDate: 2026-02-15
   readTime: 5
   ---

3. Write Your Content: Use standard Markdown. Be sure to follow our content quality guidelines.
4. Sync the Data: Run npm run generate-blog to update the project's internal data.

---

SEO Best Practices for Your Blog

To maximize your visibility in both traditional search and generative engine optimization, follow these rules:

• One H1 Only: The title of your post should be your only H1 tag.
• Internal Linking: Link to at least 3-5 other relevant pages.
• Topic Clarity: Ensure your primary keyword appears in the first paragraph.
• Human Tone: Write for people first. Check out our Getting Started with SEO post for more tips.
• Monitor Core Web Vitals: Ensure your blog templates are fast and stable.

For a deeper dive into the technical setup of the blog, see the BLOG_SETUP.md file in your project root. Use our SEO crawler to audit your blog weekly.