Skip to content

SofiDevO/astro-blog-starter

Repository files navigation

Astro Blog Starter 🌟

A lightweight starter template with atomic design structure, SEO optimization, and modern features. Perfect for fast-paced development!

Features ✨

  • ⚡ SEO Pre-configured (OpenGraph, Meta Tags)
  • 🌓 Light/Dark theme toggle
  • 🧩 Atomic Design structure
  • 🪝 Dynamic dropdown menu
  • 🎨 Vanilla CSS (no frameworks)
  • 📦 Iconify integration
  • 🚀 Production-ready configuration

Installation ⚙️

# Clone template
npm create astro@latest -- --template SofiDevO/astro-blog-starter

# Install dependencies
npm install

# Start dev server (port 4321)
npm run dev

# Build for production
npm run build

MIT License Astro

Portada

Key Components 🔑

Atomic Design Implementation

  • Atoms: ToggleTheme.astro (+ CSS) | HamburgerButton.astro | FormattedDate.astro
  • Molecules: Blogcards.astro (Post grids)
  • Organisms: Header.astro (Responsive nav with dropdowns)

Content Management

// Example blog post (content/blog/post.md)
---
title: "My First Post"
date: 2024-01-01
---

Article content...

Core Structure 🌐

src/
├── components/
│   ├── atoms/
│   │   ├── CardBlog/           # Blog post cards
│   │   ├── HamburgerButton/    # Mobile menu toggle
│   │   ├── Icons/              # Iconify wrapper
│   │   ├── ToggleTheme/        # Dark/light switcher (+ CSS)
│   │   └── utilsComponents/    # Date formatter
│   ├── molecules/
│   │   └── Blogcards/          # Blog post grid system
│   └── organisms/
│       ┗── Header/             # Navigation with dropdowns
├── content/
│   ├── blog/                   # Markdown posts
│   └── config.ts               # Content collection config
├── data/
│   └── menuElements.js         # Navigation items
├── layouts/
│   ├── Layout.astro            # Default layout
│   └── LayoutBlogPost.astro    # Article template
├── pages/
│   ├── blog/
│   │   ├── [...slug].astro     # Dynamic blog routes
│   │   └── index.astro         # Blog archive
│   └── index.astro             # Homepage
└── styles/
    └── global.css              # Base styles

Support Development ☕

GitHub Sponsors Ko-fi


MIT Licensed | Optimized for Astro v5+ | Full Documentation

About

Template to start simple astro project with clean design and utitlities

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published