Ray's Blog

A personal blog and portfolio website built with Next.js, TypeScript, and Tailwind CSS. Features technical blog posts about Linux, Kubernetes, Ceph, and other cloud-native technologies, along with a project showcase.

🌐 Live Site: https://chanchiwai-ray.github.io

Quick Start

# Clone the repository
git clone https://github.com/chanchiwai-ray/chanchiwai-ray.github.io.git
cd chanchiwai-ray.github.io

# Install dependencies
# **Note:** The `--legacy-peer-deps` flag is required due to React 19 compatibility with some dependencies (kbar, next-themes).
npm install --legacy-peer-deps

# Start development server
npm run dev

Visit http://localhost:3000 to see the site in action. For detailed setup instructions, see CONTRIBUTING.md.

Features

• 📝 MDX-powered blog posts with rich formatting
• 🎨 Light/dark theme support
• 🔍 Full-text search with command palette (⌘K / Ctrl+K)
• 🏷️ Tag-based content organization
• 💬 Comments via Giscus
• 📊 Analytics integration
• 🧮 Math equations support (KaTeX)
• 📚 Citation and bibliography support
• 🎯 SEO optimized with sitemap and RSS feed

Tech Stack

Key Dependencies

• Content Processing: contentlayer2, next-contentlayer2, pliny
• Markdown/MDX: remark-gfm, remark-math, rehype-katex, rehype-citation, rehype-prism-plus
• Styling: @tailwindcss/typography, @tailwindcss/forms
• Utilities: next-themes, github-slugger, reading-time

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for detailed guidelines on:

• Setting up the development environment
• Project structure and organization
• Writing blog posts and adding projects
• Code style and conventions
• Submitting pull requests

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Built upon the Tailwind Nextjs Starter Blog template with custom modifications and enhancements.

⭐ If you find this project helpful, please consider giving it a star!