Based on the Astro blog template, this SEO-optimized personal blog website is built with Astro. It serves as the blog for Mert Şişmanoğlu, featuring blog posts written in Markdown and MDX.
- Framework: Astro
- Styling: Tailwind CSS
- Content: Markdown/MDX
- Language: TypeScript
- Package Manager: pnpm
- Code Quality: Biome
- Deployment: GitHub Pages
Before you begin, ensure you have the following installed:
- Node.js: Version 22 (LTS) or higher
- pnpm: Package manager (recommended over npm/yarn)
You can check your Node.js version:
node --versionIf you need to install Node.js 22, you can use nvm:
nvm install 22
nvm use 22To install pnpm:
npm install -g pnpm@latest-10-
Clone the repository
git clone https://github.com/mertssmnoglu/mertssmnoglu.github.io.git cd mertssmnoglu.github.io -
Install dependencies
pnpm install
-
Start the development server
pnpm dev
-
Open your browser Navigate to
http://localhost:4321to see the website.
| Command | Description |
|---|---|
pnpm dev |
Start development server at localhost:4321 |
pnpm start |
Start the production server locally |
pnpm build |
Build the production site to ./dist/ |
pnpm preview |
Preview your build locally before deploying |
pnpm lint |
Run Biome linter to check code quality |
pnpm lint-fix |
Run Biome linter and fix issues automatically |
pnpm format |
Format code with Biome |
pnpm format-check |
Check code formatting without making changes |
Blog posts are stored in src/content/blog/ and written in Markdown or MDX format.
- Create a new
.mdor.mdxfile insrc/content/blog/ - Add frontmatter at the top of the file:
---
title: "Your Post Title"
description: "A brief description of your post"
pubDate: "2025-01-15"
heroImage: "/blog-placeholder-1.jpg"
---
Your content goes here...title: The title of your blog postdescription: A brief description for SEO and previewspubDate: Publication date in YYYY-MM-DD formatheroImage: Path to hero image (optional)tags: Array of tags for categorization (optional)
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m 'Add some amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.