Skip to content

docs(setup blog): setup blog#61

Merged
Myastr0 merged 1 commit intomasterfrom
docs/setup-blog
Nov 30, 2025
Merged

docs(setup blog): setup blog#61
Myastr0 merged 1 commit intomasterfrom
docs/setup-blog

Conversation

@Myastr0
Copy link
Owner

@Myastr0 Myastr0 commented Nov 30, 2025

All Submissions:

  • Have you followed the guidelines in our Contributing document?
  • Have you checked to ensure there aren't other open Pull Requests for the same update/change?

New Feature Submissions:

  1. Does your submission pass tests?
  2. Have you lint your code locally before submission?

Changes to Core Features:

  • Have you added an explanation of what your changes do and why you'd like us to include them?
  • Have you written new tests for your core changes, as applicable?
  • Have you successfully run tests with your changes locally?

📝 Description

This PR adds a complete Blog section to the Mk Notes documentation site, enabling the team to publish announcements, release notes, and updates directly on the website.

✨ Features Added

Blog Infrastructure

  • Blog collection: New content collection for blog posts with frontmatter support for author, date, title, and description
  • Authors system: YAML-based author profiles with support for:
    • Name, title, and profile image
    • Social links (GitHub, LinkedIn, Twitter)
    • Reusable author cards across blog posts

Blog Pages

  • Blog index page (/blog): Grid layout displaying all blog posts with:

    • Beautiful header with gradient background and grain texture overlay
    • Post cards showing title, description, author, and date
    • Responsive grid (1 column mobile, 3 columns tablet, 4 columns desktop)
  • Blog post page (/blog/[slug]): Full article view featuring:

    • Author info and publication date header
    • Table of contents (inline TOC)
    • Full MDX support with all existing components
    • Author card at the bottom with social links

Navigation & SEO

  • Added Blog link to the home layout navigation bar
  • Extended sitemap generation to include all blog posts

Initial Content

Added three launch blog posts:

  1. Alpha Release (Feb 2025) - Initial announcement
  2. Product Hunt Launch (Jun 2025) - Public release announcement
  3. v3.0.0 Database Support (Nov 2025) - Major feature release

🔧 Technical Changes

  • Refactored content-collections.ts to use modular collection files under collections/
  • Extended lib/source.ts with blog loader and author helper functions
  • Updated codeblock.tsx with accessibility improvements (proper tabIndex, role attributes)
  • Renamed metas collection to docsMetas for consistency

📁 Files Changed

File Change
collections/blogs.ts New - Blog collection definition
collections/docs.ts New - Docs collection (extracted)
collections/authors.ts New - Authors collection & schema
app/(home)/blog/page.tsx New - Blog index page
app/(home)/blog/[...slug]/page.tsx New - Blog post page
app/(home)/blog/[...slug]/-parts/author.tsx New - Author components
content/blog/authors.yml New - Author data
content/blog/*/index.mdx New - Blog posts (3)
content-collections.ts Refactored - Uses modular collections
lib/source.ts Extended - Blog & author utilities
app/(home)/layout.tsx Updated - Added Blog nav link
app/sitemap.ts Updated - Includes blog pages
components/codeblock.tsx Updated - Accessibility fixes

🖼️ Screenshots

Add screenshots of the blog index and blog post pages here

🧪 Testing

  • Verified blog index page renders correctly
  • Verified individual blog posts render with proper styling
  • Verified author information displays correctly (compact and full variants)
  • Verified navigation link works
  • Verified sitemap includes blog URLs
  • Tested responsive layout on mobile/tablet/desktop

@Myastr0
Copy link
Owner Author

Myastr0 commented Nov 30, 2025

👋 Hi, Myastr0! Thanks for opening a PR. We will review it soon.
If you have any questions, feel free to join the #need-help channel on the Discord server

@Myastr0 Myastr0 merged commit 9aab6cf into master Nov 30, 2025
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant