$ show Jocs/jocs.github.io
This repository is a personal blog and portfolio website built with Astro, Tailwind CSS, and Markdoc. It features a home page with project showcases, a blog with individual posts, a projects page, and an RSS feed. The site includes a dark mode toggle, SEO metadata generation, and custom Markdoc components for embedding media. The architecture follows Astro's standard structure with pages, layouts, and components, and uses a custom Markdoc setup for content processing.
The LLM identified 3 files worth highlighting for reuse:
Reads and processes Markdoc content: validates frontmatter against a Zod schema, applies custom transformations (for headings and code blocks), and renders custom tags (YouTube, Tweet, CodePen, GitHub Gist). This unit encapsulates the Markdoc integration logic, making it reusable in other Astro projects with minimal adaptation.
A self-contained component that toggles a dark mode class on the HTML element and stores the preference in sessionStorage. It includes an inline SVG icon for the toggle button and can be easily integrated into any web project to provide a persistent dark/light theme switch.
Generates SEO and social media meta tags (title, description, Open Graph, Twitter) based on site configuration and page-specific data. This utility ensures consistent meta tag generation across pages and can be used in any web application to improve search engine visibility and social sharing previews.