This is the repository for my personal blog, where I document technical stuff and knowledge that I want to share with the world.

• Node.js 18+ and npm (or yarn/pnpm)

1. Clone the repository:

git clone https://github.com/codesandtags/blog.git cd blog

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

The blog will be available at http://localhost:4321

To add a new post, create a new markdown file in the src/content/blog/ directory. The file name should follow the format YYYY-MM-DD-title.md.

Example post structure:

---title: "Title of the post"date: 2024-01-15author: codesandtagscategories: ["category1", "category2"]tags: ["tag1", "tag2"]draft: false--- Content of your post goes here...

• title (required): The post title
• date (required): Publication date (YYYY-MM-DD format)
• author (optional): Author name (defaults to "codesandtags")
• categories (optional): Array of category names
• tags (optional): Array of tag names
• image (optional): Path to featured image
• draft (optional): Set to true to hide from production

• npm run dev - Start development server
• npm run build - Build for production (includes Pagefind search index)
• npm run preview - Preview production build locally
• npm run migrate:posts - Run post migration script

Build the site:

npm run build

The output will be in the dist/ directory, ready to deploy to GitHub Pages or any static hosting service.

• Astro - Static site framework
• Tailwind CSS - Utility-first CSS framework
• Pagefind - Static search library
• MDX - Markdown with JSX components
• TypeScript - Type safety
• GitHub Pages - Hosting

blog/ ├── src/ │ ├── components/ # Reusable Astro components │ ├── content/ # Blog posts (Markdown/MDX) │ ├── layouts/ # Page layouts │ ├── pages/ # Route pages │ └── utils/ # Utility functions ├── public/ # Static assets └── scripts/ # Migration and utility scripts 

See LICENSE file for details.